Am 04.07.2005 um 16:45 schrieb Bernd Eidenschink:
This way or another, it seems that if we'd have a wiki->html and
wiki->nroff converters at hand, we could trash doctools... But I
do not know if any of those already exists. OK, the wiki->html
should already be there, otherwise wiki would not work ;-)
But, what about wiki->nroff ?
Hm, the existing nroff docs could be transformed like here:
http://naviserver.sourceforge.net/wiki/index.php/
Template:Documentation_template
I used the script that is found under the link "hack" at the end.
(It's a hack. It's a hack.)
The way back from wiki->nroff could be, depending on the nroff
quality, more
easy, if we use an easy and fresh Wiki document (and make use of
standard
HTML-Comments for better parsing).
But it always would be unorthodox. :-)
I see this really pragmatic: *I* would not like to invent the wheel.
If there is some good quality wiki->nroff, wiki->html, wiki->(whatever)
this would be the way to go: write all in Wiki and get it converted
to other stuff. This is very appealing.
If not, but somebody (you?) could write working converters for at least
html and nroff conversion, I'd be happy to use them and would also
opt to
write source docs in wiki. Ideal would be a tclsh app I could hit like
wiki2html source.wiki (would produce source.html in the current
dir)
wiki2nroff source.wiki (would produce source.nroff in the
current dir)
If not, I'd use doctools for already given reasons. It can't be that
bad considering that all of tcllib modules are documented with doctools
(with some notable deficiencies in documenting C-code as I already
mentioned).
Zoran
