Re: Bug#39830: [AMENDMENT]: get rid of undocumented(7) symlinks
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
> xtifr@debian.org | microscopicsilico- to fit into a single
> or xtifr@speakeasy.net | volcaniconi- standalone haiku
>
>
> --
> To UNSUBSCRIBE, email to debian-policy-request@lists.debian.org
> with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org
>
>
Reply to: