Hello, On Tue 20 Sep 2022 at 06:52PM -07, Russ Allbery wrote: > > Starting with dpkg 1.18.5, several maintainer script actions > involving a new package version get that version as an argument > after the old version. Update Policy's maintainer script > documentation accordingly. > --- > policy/ch-maintainerscripts.rst | 32 ++++++++++++++++---------------- > 1 file changed, 16 insertions(+), 16 deletions(-) > > diff --git a/policy/ch-maintainerscripts.rst b/policy/ch-maintainerscripts.rst > index 709aabf..724074c 100644 > --- a/policy/ch-maintainerscripts.rst > +++ b/policy/ch-maintainerscripts.rst > @@ -107,8 +107,8 @@ old version of a package that is being upgraded from or downgraded from. > The ``preinst`` script may be called in the following ways: > > | ``new-preinst`` install > -| ``new-preinst`` install *old-version* > -| ``new-preinst`` upgrade *old-version* > +| ``new-preinst`` install *old-version* *new-version* > +| ``new-preinst`` upgrade *old-version* *new-version* > > The package will not yet be unpacked, so the ``preinst`` script > cannot rely on any files included in its package. Only essential > @@ -168,10 +168,10 @@ The ``prerm`` script may be called in the following ways: > where dependencies are only "Half-Installed" due to a partial > upgrade. > > -``new-prerm`` failed-upgrade *old-version* > - Called during error handling when ``prerm upgrade`` fails. The new package will not yet be > - unpacked, and all the same constraints as for ``preinst upgrade`` > - apply. > +``new-prerm`` failed-upgrade *old-version* *new-version* > + Called during error handling when ``prerm upgrade`` fails. The new > + package will not yet be unpacked, and all the same constraints as for > + ``preinst upgrade`` apply. > > The ``postrm`` script may be called in the following ways: > > @@ -189,7 +189,7 @@ The ``postrm`` script may be called in the following ways: > the package's dependencies if those dependencies are unavailable. > [#]_ > > -``new-postrm`` failed-upgrade *old-version* > +``new-postrm`` failed-upgrade *old-version* *new-version* > Called when the old ``postrm upgrade`` action fails. The new package > will be unpacked, but only essential packages and pre-dependencies > can be relied on. Pre-dependencies will either be configured or will > @@ -197,8 +197,8 @@ The ``postrm`` script may be called in the following ways: > configured and was never removed. > > | ``new-postrm`` abort-install > -| ``new-postrm`` abort-install *old-version* > -| ``new-postrm`` abort-upgrade *old-version* > +| ``new-postrm`` abort-install *old-version* *new-version* > +| ``new-postrm`` abort-upgrade *old-version* *new-version* > > Called before unpacking the new package as part of the error > handling of ``preinst`` failures. May assume the same state as > @@ -229,7 +229,7 @@ These are the "error unwind" calls listed below. > > .. parsed-literal:: > > - new-prerm failed-upgrade *old-version* > + new-prerm failed-upgrade *old-version* *new-version* > > If this works, the upgrade continues. If this does not work, the > error unwind: > @@ -305,13 +305,13 @@ These are the "error unwind" calls listed below. > > .. parsed-literal:: > > - *new-preinst* upgrade *old-version* > + *new-preinst* upgrade *old-version* *new-version* > > If this fails, we call: > > .. parsed-literal:: > > - *new-postrm* abort-upgrade *old-version* > + *new-postrm* abort-upgrade *old-version* *new-version* > > i. If that works, then > > @@ -331,13 +331,13 @@ These are the "error unwind" calls listed below. > > .. parsed-literal:: > > - *new-preinst* install *old-version* > + *new-preinst* install *old-version* *new-version* > > Error unwind: > > .. parsed-literal:: > > - *new-postrm* abort-install *old-version* > + *new-postrm* abort-install *old-version* *new-version* > > If this fails, the package is left in a "Half-Installed" state, > which requires a reinstall. If it works, the packages is left in > @@ -397,7 +397,7 @@ These are the "error unwind" calls listed below. > > .. parsed-literal:: > > - *new-postrm* failed-upgrade *old-version* > + *new-postrm* failed-upgrade *old-version* *new-version* > > If this works, installation continues. If not, Error unwind: > > @@ -410,7 +410,7 @@ These are the "error unwind" calls listed below. > > .. parsed-literal:: > > - *new-postrm* abort-upgrade *old-version* > + *new-postrm* abort-upgrade *old-version* *new-version* > > If this fails, the old version is left in a "Half-Installed" > state. If it works, dpkg now calls: Seconded. -- Sean Whitton
Attachment:
signature.asc
Description: PGP signature