Re: Bug#39830: [AMENDMENT]: get rid of undocumented(7) symlinks
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
xtifr@debian.org | microscopicsilico- to fit into a single
or xtifr@speakeasy.net | volcaniconi- standalone haiku
Reply to: