Re: Bug#39830: [AMENDMENT]: get rid of undocumented(7) symlinks
On Thu, Nov 14, 2002 at 11:51:28AM -0900, Britton wrote:
> I don't agree at all that a half-assed man page is better than
> undocumented, especially if upstream has taken the trouble to provide
> better documentation in some other form.
Isn't that backwards? The worse the upstream documentation, the
greater the need for a GOOD, detailed man page, IMO.
Now, if you're talking about a lousy man page that doesn't even tell
you where to find the better documentation, then I'd agree. But I
wouldn't call that a half-assed man page. I'd call that full-assed.
(Or do I mean "no-assed"?)
In fact, I might go so far as to say that unless your man page is
*clearly* better than undocumented(7) (at least for your specific
program), then it is in no way good enough to be called "half-assed".
And I ought to know, as I've written several man pages for the project
that I think nearly everyone will agree are half-assed. :)
> A minimal man page, carefully maintained, might be worthwhile.
You say "po-TAY-to", I say "po-TAH-to"....
cheers
--
Chris Waters | Pneumonoultra- osis is too long
xtifr@debian.org | microscopicsilico- to fit into a single
or xtifr@speakeasy.net | volcaniconi- standalone haiku
Reply to: