Bug#627188: apt-listchanges et al: please document VERSION 2 hook interface

[Pierre Habouzit <madcoder@madism.org>]

On Wed, May 18, 2011 at 09:52:21AM -0500, Jonathan Nieder wrote:
> reassign 627188 apt
> quit
>
> Pierre Habouzit wrote:
>
> > Huh, how come this is up to apt-listchanges to document an *APT*
> > interface!?
>
> Hm, I didn't know who invented it.  Reassigning to apt.  Sorry for
> the noise.

This is an interface that you can set-up using things like:

    DPkg::Pre-Install-Pkgs { "/usr/bin/apt-listchanges --apt || test $? -ne 10"; };
    DPkg::Tools::Options::/usr/bin/apt-listchanges::Version "2";

You have an explanation in apt.conf(5):

HOW APT CALLS DPKG
       Several configuration directives control how APT invokes dpkg(1). These
       are in the DPkg section.

[...]
       Pre-Install-Pkgs
           This is a list of shell commands to run before invoking dpkg. Like
           options this must be specified in list notation. The commands are
           invoked in order using /bin/sh, should any fail APT will abort. APT
           will pass to the commands on standard input the filenames of all
           .deb files it is going to install, one per line.

           Version 2 of this protocol dumps more information, including the
           protocol version, the APT configuration space and the packages,
           files and versions being changed. Version 2 is enabled by setting
           DPkg::Tools::options::cmd::Version to 2.  cmd is a command given to
           Pre-Install-Pkgs.
[...]

--
·O·  Pierre Habouzit
··O                                                madcoder@debian.org
OOO                                                http://www.madism.org