[Tcllib-devel] Documentation toolbox, manpages

[Andreas K. <aku...@sh...>]

Well, when I moved memchan to sourceforge I reworked the documentation
and developed a tcl-based manpage markup language for it which made
writing manpages much easier. Using the expand macro processor by Will
Duquette I then wrote converters of manpages this format to HTML and
nroff. Joe English provided me with a converter to TMML, his XML-based
Tcl Manpage Markup Language.

As the core of expand is now part of tcllib (textutil) I used this to
work on a specialized macro processor just for my markup language.

The result of this work can be seen here

	http://sourceforge.net/tracker/?func=detail&
		aid=492234&group_id=12883&atid=362883

    Note that I broke the url into 2 parts.

I named this new module for tcllib 'doctools' instead of 'manpage' as
I have the hope to add other documentation related applications to it,
for example a parser for ChangeLogs.

I would like to get a bit more feedback on this before I add this
module to tcllib.

Note. Anyone who wants to actually use the applications in this module
has to get the current head of tcllib and the patch at

	http://sourceforge.net/tracker/?func=detail&\
		aid=492156&group_id=12883&atid=312883

The manpages for doctools are written using the format specified in
it. Use

	./mpexpand.all -verbose doctools
or	./mpexpand.all doctools

to generate the nroff, html, and tmml versions.

-- 
So long,
	Andreas Kupries <aku...@sh...>
			<http://www.purl.org/NET/akupries/>
	Developer @	<http://www.activestate.com/>
-------------------------------------------------------------------------------