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. A minimal man page, carefully maintained, might be worthwhile. But if Colin is willing to change man to somehow figure out that a page corresponding to a binary corresponding to an installed undocumented package has been requested, and respond with appropriate pointers, I guess there is no problem.
Britton On Wed, 13 Nov 2002, Chris Waters wrote: > On Wed, Nov 13, 2002 at 12:22:58PM -0900, Britton wrote: > > > Along with potential false hopes during load time, the undocumented > > page provides pointers to places where documentation may be found. > > An actual man page would do a better job of that. The point of this > proposal is that people should provide man pages! Lots of people seem > to think that as soon as they make a link to undocumented(7), their > job is done. Well it's not! If you can create a debian/control file, > you can write a simple man page that (at least) explains EXACTLY where > the full documentation for this program is to be found -- not just a > list of possible places to start hunting. Even a half-assed man page > is better than using undocumented(7), and I don't believe there's a > person in this project who can't generate a half-assed man page in > about 15 minutes, given some example man pages to start with. > > Does that answer your reservations? > > -- > Chris Waters | Pneumonoultra- osis is too long > [EMAIL PROTECTED] | microscopicsilico- to fit into a single > or [EMAIL PROTECTED] | volcaniconi- standalone haiku > > > -- > To UNSUBSCRIBE, email to [EMAIL PROTECTED] > with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED] > >
