🚀 go-pugleaf

In article <1992Dec17.172023.9803@oakhill.sps.mot.com>  
wcl@oakhill.sps.mot.com (Wayne Long) writes:
> 
> I'm looking for a filter, utility, or editor that
> will take normal, what-you-see-is-what-you get
> text, and convert it into a unix man page with
> minimal hassle.

In my opinion, only a very sophisticated AI-system could do that, as Unix  
man-pages are roff documents in declarative text format and WYSIWIG texts  
are some kind of text-markup. Since I learned about half a dozen different  
text formatters in between, I have never seen any way to get a good  
translation from declarative to frame based and markup text  
representation. In most cases the way goes back to ASCII and then to the  
desired format by hand.

Man-pages are formatted using n(t)roff with an-macros (hence the call  
nroff -man to see the formatted document on screen). The functionality is  
limited so the complexity is quite low, which means it is easy to learn.
Best is to start with a fairly complex example from the man-pages on your  
system and then simply replace the text. You will see it's not too hard to  
guess the functionality of the macros. Anyway, you can also start with a  
textbook on Unix or some special literature on nroff/troff.
-- 
Peter Nitezki        | Nitezki@NiDat.sub.org # Blessed thou who knoweth
NITEZKI DATENSYSTEME | Tel.:  +49 7251 62495 # not about the pleasure and
Staarenbergstr. 44   | Fax :  +49 7251 69215 # delight of being hooked
D-7527 Kraichtal 2   | GERMANY               # up to the Net. Peter 1,3-5