On 9/5/06, Zoran Vasiljevic <[EMAIL PROTECTED]> wrote:
On 05.09.2006, at 19:07, Bernd Eidenschink wrote: > > http://wiki2man.sourceforge.net/ Almost (although you are right)! What we need is wiki->doctools man-pages not nroff man pages. (what a stupid naming mess !!!) I wonder if there is a wiki->doctools as I know there is doctools->wiki converter...
If someone adds some Makefile magic to generate nroff and HTML from the doctools source, I'll set up sourceforge to auto generate the HTML straight from CVS and make it available on the website. There's a script in there now which creates symbolic links for all the commands embedded in a singe file, so if foo, bar, and baz are all documented in the foo.man file, you can still access bar and baz directly via 'man bar' etc. Does doctools support anything like this? We can add some wiki-macros so that whenever you type [proc ns_foo] it creates a link to /doc/ns_foo.html (or wherever). If the API doc is always automatically uptodate on the website then that can be the single canonical location to find everything. Is there a script which will convert the existing man pages to doctools format? We can't be the first people to ever have done this. If we can convert the existing stuff, then strip out the old/deprecated APIs and stubb out the new ones, I think finding time to sit down and write something will be much easier.