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