Re: [naviserver-devel] Doc with doctools

2005-07-30 Thread Zoran Vasiljevic
Am 30.07.2005 um 12:34 schrieb Stephen Deasey: I just wonder if the system is too simple. In your example man page you followed each ccall definition with a description. In the Tcl man pages the definitions are grouped at the top, then the args are described, then there's some prose text desc

Re: [naviserver-devel] Doc with doctools

2005-07-30 Thread Stephen Deasey
On 7/30/05, Zoran Vasiljevic <[EMAIL PROTECTED]> wrote: > > Am 30.07.2005 um 11:50 schrieb Stephen Deasey: > > > > Great. Are the macros expanded recursively? Can ccal output the type > > declarations for the benefit of indexes etc.? Will we be able to > > document the Tcl cmds as easily? > >

Re: [naviserver-devel] Doc with doctools

2005-07-30 Thread Zoran Vasiljevic
Am 30.07.2005 um 11:50 schrieb Stephen Deasey: Great. Are the macros expanded recursively? Can ccal output the type declarations for the benefit of indexes etc.? Will we be able to document the Tcl cmds as easily? I will first have to examine the TOC and index parts before I can say somethi

Re: [naviserver-devel] Doc with doctools

2005-07-30 Thread Stephen Deasey
On 7/30/05, Zoran Vasiljevic <[EMAIL PROTECTED]> wrote: > > Am 30.07.2005 um 03:58 schrieb Stephen Deasey: > > > > > [ccall [type int] Ns_ConnLocationAppend [type Ns_Conn] [arg *connPtr] > > [type Ns_DString] [arg dest]] > > > > A C-call always has a name, always returns something (even if it's >

Re: [naviserver-devel] Doc with doctools

2005-07-30 Thread Zoran Vasiljevic
Am 30.07.2005 um 03:58 schrieb Stephen Deasey: [ccall [type int] Ns_ConnLocationAppend [type Ns_Conn] [arg *connPtr] [type Ns_DString] [arg dest]] A C-call always has a name, always returns something (even if it's just void), all args are typed and named, etc., and a lot of that can be inferre

Re: [naviserver-devel] Doc with doctools

2005-07-29 Thread Stephen Deasey
On 7/27/05, Zoran Vasiljevic <[EMAIL PROTECTED]> wrote: > Hi, > > Before I spend more time, just want to give you some > idea about it. Please download those: > > http://www.archiware.com/www/downloads/Ns_ConnHeaders.man The following two have the same contents: > http://www.archiware

Re: [naviserver-devel] Doc with doctools

2005-07-28 Thread Zoran Vasiljevic
Am 28.07.2005 um 07:18 schrieb Bernd Eidenschink: Hi Zoran, the doctools source looks good, should be manageable! Yes. This is fairly simple. http://www.archiware.com/www/downloads/Ns_ConnHeaders.man http://www.archiware.com/www/downloads/Ns_ConnHeaders.3 This one seems not t

Re: [naviserver-devel] Doc with doctools

2005-07-27 Thread Bernd Eidenschink
Hi Zoran, the doctools source looks good, should be manageable! > http://www.archiware.com/www/downloads/Ns_ConnHeaders.man > http://www.archiware.com/www/downloads/Ns_ConnHeaders.3 This one seems not to be on your server: > http://www.archiware.com/www/downloads/man.macros > > and u

Re: [naviserver-devel] Doc with doctools

2005-07-27 Thread Zoran Vasiljevic
Am 27.07.2005 um 20:08 schrieb Vlad Seryakov: Looks interesting. So all the docs will need to be re-written in doctools format. Well, there is not much available out-there. But, giving it a doctool looks we can concentrate on content and make nroff/html/wiki automatically by a "make html

Re: [naviserver-devel] Doc with doctools

2005-07-27 Thread Vlad Seryakov
Looks interesting. So all the docs will need to be re-written in doctools format. Zoran Vasiljevic wrote: Hi, Before I spend more time, just want to give you some idea about it. Please download those: http://www.archiware.com/www/downloads/Ns_ConnHeaders.man http://www.archiware.com/www

[naviserver-devel] Doc with doctools

2005-07-27 Thread Zoran Vasiljevic
Hi, Before I spend more time, just want to give you some idea about it. Please download those: http://www.archiware.com/www/downloads/Ns_ConnHeaders.man http://www.archiware.com/www/downloads/Ns_ConnHeaders.3 http://www.archiware.com/www/downloads/man.macros and use: nroff -man Ns_