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

[Mike Parson]

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

<snip>

> 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
address@hidden