Re: Man-writing volunteers?

[Trent W. Buck]

On Fri, Aug 08, 2008 at 01:20:03PM -0700, Micah Cowan wrote:
> The first step would be to ensure that the man page is in-step with the
> Texinfo manual; currently I believe the man page is a couple steps
> behind. the content is essentially the same between them, so for the
> most part you should actually be able to compare them side-by-side for
> differences. Tedious work, obviously.

Surely texinfo can be automatically converted into a roff manpage?

> Actually, though, as it stands, a big-hulking man page strikes me as
> remarkably untraditional.

The GNU convention would be to have a simple one- or two-page manpage,
which includes a SYNOPSIS and a brief DESCRIPTION and then says "use
info for the complete manual".

IMO this is a reasonable approach.  How do other stakeholders feel?