On Sat, 14 Mar 2009, Ian Jackson wrote:
Package: dpkg
Version: 1.15.0
/usr/share/man/man5/deb-triggers.5.gz has just come to my attention.
I can see why someone wanted to add it but I think the inclusion of
this file in this form was a mistake.
deb-*(5) document file formats of files inside the .deb control archive. I
don't see a valid reason to remove deb-triggers(5) given that packages can
have a triggers file in their control archive.
The dpkg trigger machinery is useful only to package maintainers. The
concepts on which deb-triggers(5) and dpkg-trigger(1) depend are those
of the dpkg trigger system as defined in the specification.
I can see that there is an argument that /usr/bin/dpkg-trigger is
useful to a sysadmin (but arguably the manpage should be in section
8), and thus having it documented in the form of a manpage is useful.
It's in /usr/bin so section 1 is not that much of a problem.
But it is essential that the manpage give a reference to the full
specification.
That can be done of course. I'll do it right now.
(One might also consider whether the material which is currently
duplicated between triggers.txt.gz and dpkg-trigger(1) should appear
in only one place; removing the usage information from triggers.txt.gz
should be done insofar as it would make that document clearer.)
Patch welcome. In the mean time it doesn't hurt as long as the infos don't
contradict themselves.
Cheers,
--
Raphaël Hertzog
Contribuez à Debian et gagnez un cahier de l'admin Debian Lenny :
http://www.ouaza.com/wp/2009/03/02/contribuer-a-debian-gagner-un-livre/
--
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org