On Mon, Jan 21, 2002, Tzafrir Cohen wrote about "*roff horrors": > Hi > > Can anybody point me to a resonable environment for editing /creating > man pages? > > I can find no decent reference to groff. All I have is samples from manual > pages in my own systems. It seems that they all tend to use visual > formatting (like "forward 4 columns", and "backwards 4 columns". I > couldn't find any decent way to do something as basic as a <ul> or <ol> > lists of html. > > Can anybody point me to either: > > * a good reference for writing manual pages
Try reading groff_man(7) I suggest you also take a look at groff(7) (not groff(1) !!) and at groff_tmac(7). groff_man(7) will only explain man-macros specific troff commands, not the general troff (which you can find a reference in groff(7)), but I'm not sure that nowadays it is even wise to use the full spectrum of troff in manual pages: groff understands them well, but other utilities might not... troff (and groff) themselves are almost as powerful as TeX, so you can certainly do things like automatic numbering if you use their full strength. Anyway, if you (or anyone else) is interested, I have a good troff manual (postscript files of the original AT&T technical report), which I can put online if anyone is interested (or you can search for them in bell-lab's site). > * an environment to translate from latex or html, or similar to groff Sic tranit gloria mundi :( -- Nadav Har'El | Monday, Jan 21 2002, 9 Shevat 5762 [EMAIL PROTECTED] |----------------------------------------- Phone: +972-53-245868, ICQ 13349191 |As every cat owner knows, nobody owns a http://nadav.harel.org.il |cat. ================================================================= To unsubscribe, send mail to [EMAIL PROTECTED] with the word "unsubscribe" in the message body, e.g., run the command echo unsubscribe | mail [EMAIL PROTECTED]
