Re: [Tcllib-devel] How frequently do the htmlized tcllib docs get updated?

[Joe E. <jen...@fl...>]

Andreas Kupries  wrote:
>
> Oh. Which nroff commands are not handled ?

Mostly the macro definitions; excerpts from 'man.macros' are included
inline, and there are several macros  (.de i1, .de i2, ...) used
to keep the the SYNOPSIS in sync with the rest of the manpage.

The other unrecognized requests aren't too hard to add.

FWIW, the Tcl core docs for commands with lots of suboptions conventionally
just use

	.SH SYNOPSIS
	.nf
	\fBcommand\fP  \fIoption ...\fP  ? \fI arg arg... \fB
	.SH DESCRIPTION
	...
instead of listing all the subcommands explicitly in the SYNOPSIS.

I've modified the manpage, expanding all the macro definitions
and updating it to use this style; it now passes through my converter
relatively unscathed.  Results at:

    <URL: http://tcllib.sourceforge.net/doc/comm.html >

original version at:

    <URL: http://tcllib.sourceforge.net/doc/comm.n.html >

If this is acceptable, I'll commit the modified version.


--Joe English

  jen...@fl...