Bug#286549: debian-policy: Detailed description of maintainer script calls (Section 6.5) is incomplete

[Nikolaus Schulz <microschulz@web.de>]

Package: debian-policy
Version: 3.6.1.1
Severity: normal

Hi,

see "Details of unpack phase of installation or upgrade" (Policy section
6.5).  If a package is upgraded and "<new-preinst> upgrade
<old-version>" fails, "<old-postinst> abort-upgrade <new-version>" is
called. 
This is missing in the Policy Manual: 

,----[ policy.txt ]
|
|      3.   1.   If the package is being upgraded, call:
|                     <new-preinst> upgrade <old-version>
|
|           2.   Otherwise, if the package had some configuration files from
|                a previous version installed (i.e., it is in the
|                "configuration files only" state):
|                     <new-preinst> install <old-version>
|
|           3.   Otherwise (i.e., the package was completely purged):
|                     <new-preinst> install
|                Error unwind actions, respectively:
|                     <new-postrm> abort-upgrade <old-version>
|                     <new-postrm> abort-install <old-version>
|                     <new-postrm> abort-install
|
|      4.   [...]
`----

All the best,
Nikolaus

-- System Information:
Debian Release: 3.1
  APT prefers testing
  APT policy: (500, 'testing')
Architecture: powerpc (ppc)
Kernel: Linux 2.6.8-powerpc-fbfix
Locale: LANG=de_DE@euro, LC_CTYPE=de_DE@euro (charmap=ISO-8859-15)

-- no debconf information