Re: [naviserver-devel] Documentation & website question

[Vlad S. <vl...@cr...>]

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 <zv...@ar...> 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
> nav...@li...
> https://lists.sourceforge.net/lists/listinfo/naviserver-devel
> 

-- 
Vlad Seryakov
571 262-8608 office
vl...@cr...
http://www.crystalballinc.com/vlad/