[Top][All Lists]

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

Re: [Groff] Effective manpages, a couple of thoughts

From: Mike Parson
Subject: Re: [Groff] Effective manpages, a couple of thoughts
Date: Fri, 7 May 2004 15:09:06 -0500
User-agent: Mutt/

On Fri, May 07, 2004 at 03:03:37PM -0400, Larry Kollar wrote:


> The "short and complete" requirement has a heavy bias
> towards "complete," it seems. :-) That was the most heated
> discussion I remember seeing on the groff list... but the
> slings and arrows mean that people actually care how this
> paper turns out. Pete Phillips's comment "keep it as short
> as possible, but as long as necessary," was nothing less
> than inspired and that became the new heading for the
> section in question (which has been heavily redone, never
> fear).

Reminds me of my high school biology teacher, her instructions for the
length of our reports, "Should be like a girl's mini-skirt -- long
enough to cover the subject, but short enough to keep it interesting."

Michael Parson

reply via email to

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