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

Reply via email to