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.com/www/downloads/Ns_ConnHeaders.3 > http://www.archiware.com/www/downloads/man.macros > > and use: > > nroff -man Ns_ConnHeaders.3 | more > > to look at it. > > The ".man" is the source file I used. Out of this file > we can make wiki, html, nroff etc pp formats with doctools. > > I have patched the doctools to include new formatting > command "ccall" which stands for "C-call" and is a > companion to "call" which formats Tcl ccommands. > > I did the nroff formatter first. Once we settle on this > one, I will update the rest of formatters, eventually > producting a private version of doctools for our needs. > We can post changes to tcllib folks so they can include > this in the standard distro if they like. > > While doing those changes, I now have much better insight > how doctools are working and I can produce now just about > any layout you'd like. > > Lets hear your feedback. > > Zoran [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 inferred from position and so on. But in the above, the doc writer must redundantly specify [type Ns_Conn] [arg *connPtr]. Couldn't the macro ccall just handle a lot of this transparently? Something like: [ccall int Ns_ConnLocationAppend { {Ns_Conn *connPtr} {Ns_DString *dest} } { Describe me here... }]
