[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Bug#167886: marked as done (tux-aqfh-data: should replace older versions of tux-aqfh )

On Mon, Dec 02, 2002 at 12:15:37AM +0000, Colin Watson wrote:
> In this case it's partly a Lintian bug. The link-to-undocumented-manpage
> warning should be removed altogether, as policy has been amended to no
> longer recommend the use of undocumented(7).

Erm... isn't this exactly the reason to warn even more about having
undocumented(7) symlinks? :)

> > Overriding link-to-undocumented-manpage was acceptable:
> > 
> >   W: tux-aqfh: link-to-undocumented-manpage usr/share/man/man6/tux_aqfh.6.gz
> >   N:
> >   N:   Symbolic links to the undocumented(7) manual page may be provided only
> >   N:   when a bug has been filed that no manual page is available. If you
> >   N:   like, you may report the bug yourself, and add an override for this
> >   N:   warning in your package.
> >   N:
> Bleh, I disagree with that text. :-) Shaleh was generally consistent in
> saying that overrides should only be used for cases where an exception
> needs to be made to an otherwise correct general rule, and not to hide
> Lintian bugs or package bugs. I don't know what Joy thinks, but this has
> certainly been the guideline in the past.
> (I wonder if that text was my fault ... if so, oops.)

I'm not sure where that description was going... I'll rephrase it to simply
say that even if there's a undocumented(7) symlink, there's still no manual
page and one should be written.

Which reminds me, gotta fix the upgrading checklist, it says that not having
manual pages has become a bug -- it's been a bug all along.

     2. That which causes joy or happiness.

Reply to: