> OTOH, have you ever looked at doctools? Not too much, but as I read here: http://wiki.tcl.tk/3054
the conversions should be easy: dtp doc html your_manpage > your_manpage.html dtp doc nroff your_manpage > your_manpage.n dtp doc text your_manpage > your_manpage.txt And seems there's also "latex" (and therefor PDF) and "wiki": http://aspn.activestate.com/ASPN/docs/ActiveTcl/tcllib/doctools/doctools.html So, if we use doctools, we only would need a) An autogenerated step to generate html,nroff (and wiki) b) (Auto)generate an index.html file to all generated single html pages (easy) I don't know the output of the doctool->wiki conversion, if it creates [Wiki-Links] automagically so that we have relations for free. But that does not matter. We know our commands so we can regsub and create those relations. If we start with Wiki, we can create a nice Documentation with easy relations/links between the commands and documents. But the wiki->nroff step does not exist, does it? There are these small little nroff-gadgets like ".sp" ("Skip one line vertically") or markup for italics for function parameters. We can only produce really nice nroff/groff, if we have a really good Wiki template and always use it correctly. At least this is my impression. BTW: How do we fetch our documentation out of Wiki for autogeneration of documentation? Maybe we take a database dump and one of us accesses it local? Hm...not good. Or spidering it... No. So, somehow, seems the doctools approach would be easier right now. And no one will complain that documentation is not on Wiki, if documentation is available! :-) Bernd.
