[naviserver-devel] Doc with doctools

[Zoran V. <zv...@ar...>]

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_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