agree, having only one place and way of writing documentation will
provide no barriers for updating it, just laziness or lack of time :-))
Stephen Deasey wrote:
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.
-------------------------------------------------------------------------
Using Tomcat but need to do more? Need to support web services, security?
Get stuff done quickly with pre-integrated technology to make your job easier
Download IBM WebSphere Application Server v.1.0.1 based on Apache Geronimo
http://sel.as-us.falkag.net/sel?cmd=lnk&kid=120709&bid=263057&dat=121642
_______________________________________________
naviserver-devel mailing list
naviserver-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/naviserver-devel
--
Vlad Seryakov
571 262-8608 office
[EMAIL PROTECTED]
http://www.crystalballinc.com/vlad/
