Re: [naviserver-devel] [naviserver-commits] naviserver/doc/src/mann ns_sls.man, NONE, 1.1

2006-11-13 Thread Stephen Deasey
http://sourceforge.net/mailarchive/forum.php?thread_id=30614948&forum_id=43966 On 11/13/06, Vlad Seryakov <[EMAIL PROTECTED]> wrote: I wonder why ns_sls.man is under src/mann and not under src/ where all Tcl API commands are? Stephen Deasey wrote: > > Update of /cvsroot/naviserver/naviserver/

Re: [naviserver-devel] Example doctools manpage for C API ?

2006-11-13 Thread Zoran Vasiljevic
On 13.11.2006, at 19:12, Stephen Deasey wrote: Should I use 'fun' for C instead of 'cmd'? I think this is ok. What's the deal with 'cmd_def' and 'arg_def' rather than 'cmd' and 'arg'? The former are used in list definitions (list_begin/list_end) What's an i/o-mode? in/out? Yes.

Re: [naviserver-devel] [naviserver-commits] naviserver/doc/src/mann ns_sls.man, NONE, 1.1

2006-11-13 Thread Vlad Seryakov
I wonder why ns_sls.man is under src/mann and not under src/ where all Tcl API commands are? Stephen Deasey wrote: Update of /cvsroot/naviserver/naviserver/doc/src/mann In directory sc8-pr-cvs7.sourceforge.net:/tmp/cvs-serv28169/doc/src/mann Added Files: ns_sls.man Log Message: * in

Re: [naviserver-devel] Example doctools manpage for C API ?

2006-11-13 Thread Stephen Deasey
On 11/13/06, Zoran Vasiljevic <[EMAIL PROTECTED]> wrote: On 13.11.2006, at 18:25, Vlad Seryakov wrote: > But why our current template will not work for C API? It can describe > functions and arguments same way? It can, this is no problem. You will get a page-per-api-call. Under man pages it is

Re: [naviserver-devel] Example doctools manpage for C API ?

2006-11-13 Thread Zoran Vasiljevic
On 13.11.2006, at 18:25, Vlad Seryakov wrote: But why our current template will not work for C API? It can describe functions and arguments same way? It can, this is no problem. You will get a page-per-api-call. Under man pages it is common to have one man page describing many related api cal

Re: [naviserver-devel] Example doctools manpage for C API ?

2006-11-13 Thread Vlad Seryakov
But why our current template will not work for C API? It can describe functions and arguments same way? Zoran Vasiljevic wrote: On 13.11.2006, at 18:18, Vlad Seryakov wrote: why it is not possible? Good question! I have never find a way to do so in the doctools. And I did experiment some ti

Re: [naviserver-devel] Example doctools manpage for C API ?

2006-11-13 Thread Zoran Vasiljevic
On 13.11.2006, at 18:18, Vlad Seryakov wrote: why it is not possible? Good question! I have never find a way to do so in the doctools. And I did experiment some time with it... I guess Andreas will know more. I recall discussing this with him some time ago... As for now, the Tcl code (all in

Re: [naviserver-devel] Example doctools manpage for C API ?

2006-11-13 Thread Vlad Seryakov
why it is not possible? Zoran Vasiljevic wrote: On 13.11.2006, at 17:59, Stephen Deasey wrote: Anyone got an example of a C API documented using doctools? Well, my fault... AFAIK, the way of documenting C-API to be close to what we can normally see under "man strstr" for example (i.e. many c

Re: [naviserver-devel] Example doctools manpage for C API ?

2006-11-13 Thread Zoran Vasiljevic
On 13.11.2006, at 17:59, Stephen Deasey wrote: Anyone got an example of a C API documented using doctools? Well, my fault... AFAIK, the way of documenting C-API to be close to what we can normally see under "man strstr" for example (i.e. many calls documented under one manpage) is not possibl

Re: [naviserver-devel] Example doctools manpage for C API ?

2006-11-13 Thread Vlad Seryakov
I guess it should have the same format as for Tcl API, we just do not have anything yet in the docs repository. Stephen Deasey wrote: Anyone got an example of a C API documented using doctools? - Using Tomcat but need to d

[naviserver-devel] Example doctools manpage for C API ?

2006-11-13 Thread Stephen Deasey
Anyone got an example of a C API documented using doctools?