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 [EMAIL PROTECTED] | microscopicsilico- to fit into a single or [EMAIL PROTECTED] | volcaniconi- standalone haiku
