2009/6/16 Erik de Castro Lopo <mle+s...@mega-nerd.com>: > Hi all, > > What are people using to generate man pages? I'd prefer not to write > raw nroff :-).
What do you mean by "generate"? I've recently upgraded a bunch of manpages from Docbook/XML to roff, and I find roff format much easier to work with as there are no tool dependencies, and it is actually pretty simple. The format is not semantic though, just presentational. My best answer for "how to generate man pages" is "with your own code": http://blog.kfish.org/2008/12/release-hogg-041.html To do man pages, you want to have a synopsis, a description, and some examples. These are specific text that can't be autogenerated: you need to either write the text by hand, or write some code that generates part of it (like printing valid examples). K. _______________________________________________ coders mailing list coders@slug.org.au http://lists.slug.org.au/listinfo/coders
