Re: [Tcllib-devel] missing man pages on tcllib.sf.net/doc?

[Andreas K. <and...@ac...>]

> AKU wrote:
> > [LV wrote]:
> > > I was noticing today that the bench man pages aren't
> available at sf.net.
> > > Is bench considered an 'internal' module that people shouldn't use?
> >
> > No. It just means that Joe hasn't triggred the regeneration of
> the doc pages
> > for a while. While the building of the docs from the .man files
> in tcllib is
> > (mostly) automatic, the process has to be triggered by hand.
>
> Also, it turns out I've been running 'cvs update' instead of
> 'cvs update -d' for the last several months and so missed the
> new modules.
>
> Keeping the table of contents up-to-date still takes rather more
> manual work than I'd like.  Andreas -- does the tcllib Swiss Army Knife
> tool have a better solution?

Currently not, I think. How are you generating the TOC again ?

We are speaking about http://tcllib.sourceforge.net/doc/, right ?

Where the various packages/modules are sorted into various
categories ?

If so, we could maybe put the category information into the manpages, as
proper markup using a new 'category' command, or as temp. hack using
'comment' with special contents. The latter is however not something I want
to do. Whatver way we go, at the end we can pull the information directly
out of the manpages, or the TMML conversion (I seem to remember that you go
TMML first before going to HTML). Documentation with the information goes to
'Unfiled' or other category of similar meaning. Then we only have to update
all existing manpages with the current categories to recreate the current
result, and new pages are incrementally assigned a category when created ...


--
	Andreas Kupries <and...@Ac...>
	Developer @ http://www.ActiveState.com
	Tel: +1 778-786-1122