On 5/4/2009 7:52 AM, UNIX admin wrote: > Hi > > I've written some simple manual pages in vi(1) before, but those cannot > compare with the kind of complex layouts and formatting options that > Sun-generated man pages have; I'd like to be able to produce such > quality-formatted documentation too, but haven't found much on the internet > on the subject of writing manual pages (not the content, the formatting). > Which tools do you use to generate manual pages? > > Is there an OpenOffice / StarOffice macro capable of converting ODF documents > to nroff/troff format for manual pages? > I have written quite a bit of documentation in ODF, and it'd be really slick, > if I could produce man(1) command formatted documents. > > Is there any tutorial documentation on writing manual pages with nroff(1) or > troff(1), where those tools are well explained, or even better, where > advanced creation techniques for crating manual pages are discussed in depth? > A manpage person may use these tools often: groff, sed, awk, TeX, perl, bash/sh, scheme (lisp), EMACS, vi(m).
Fundamentally just plaintext, but people tend to employ automated tools to keep things consistent, and most the time they are compressed inside a gzip. http://en.wikipedia.org/wiki/Manpage
