[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Man-writing volunteers?

From: Trent W. Buck
Subject: Re: Man-writing volunteers?
Date: Sat, 9 Aug 2008 14:53:10 +1000
User-agent: Mutt/1.5.18 (2008-05-17)

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?

reply via email to

[Prev in Thread] Current Thread [Next in Thread]