On Sun, Nov 06, 2011 at 07:54:43PM +0100, Robert Luberda wrote: > Charles Plessy writes: > > Hi, > > > > Dear Robert (maintainer of doc-base) and everybody, > > > > I have proposed the patch below to the Debian Policy in August this year, to > > stop recommending the direct use of install-docs for registering documents > > to > > doc-base, and wonder if you agree or would second it. > > Yes, I second it. > > Triggers support was added to doc-base about 3 years ago, so there's no > point in calling install-docs directly in maintainer scripts and surely > the Policy shouldn't recommend it. > > Moreover debhelper stopped adding calls to install-docs over 2 years > ago, and also lintian warns[1] about such a calls. > > > [1] > http://lintian.debian.org/tags/postinst-has-useless-call-to-install-docs.html > > >> - de-register the manuals again when the package is removed. > >> + <package>doc-base</package> control file in > >> + <file>/usr/share/doc-base/</file>.<footnote>Since version 0.8.11, > >> + <package>doc-base</package> uses <package>dpkg</package> triggers > >> + to call the <prgn>install-docs</prgn> script at installation time and > >> + de-register the manuals again when the package is removed.</footnote> > >> </p> > > I'm not sure if the footnote is needed. One needs to read doc-base > documentation to find out what to put in the > `<package>doc-base</package> control file' anyway, and the documentation > mentions triggers already.
Thanks for your input, I have applied the patch minus the footnote, I hope it is fine for all involved. Cheers, -- Bill. <ballo...@debian.org> Imagine a large red swirl here. -- To UNSUBSCRIBE, email to debian-policy-requ...@lists.debian.org with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org Archive: http://lists.debian.org/20111128120949.GA26059@yellowpig
