tags 372148 +confirmed patch tnx I've been looking at this bug in the documentation, and what Justin says is completely true. I've found out that my diagrams also beared this bug (maybe because I made them while reading the docs, or maybe because policy was updated to reflect my diagrams :-\). I have updated the diagrams and checked that all the info is correct now.
So, just to keep clear what needs to be changed, I've attached a patch to
the sgml document that fixes all the bugs reported.
(Also, it should be noted that 'an "Half-Installed" state' is incorrect and
should be replaced by 'a "Half-Installed" state', but I've left it out of
this patch to keep things clear).
--
Besitos, {o_
Marga. (')_
--- policy.sgml 2006-06-10 23:15:43.997173864 -0300
+++ policy-patched.sgml 2006-06-10 23:35:54.865522430 -0300
@@ -3469,7 +3469,7 @@
<p>
If that works, then
<example>
-<var>new-postinst</var> abort-upgrade <var>new-version</var>
+<var>old-postinst</var> abort-upgrade <var>new-version</var>
</example>
is called. If this works, then the old version
is in an "Installed" state, or else it is left
@@ -3601,7 +3601,7 @@
"Half Installed" state. If it works, dpkg now
calls:
<example compact="compact">
-<var>new-postinst</var> abort-upgrade <var>new-version</var>
+<var>old-postinst</var> abort-upgrade <var>new-version</var>
</example>
If this fails, the old version is in an
"Unpacked" state.
@@ -3768,6 +3768,11 @@
<example compact="compact">
<var>postrm</var> remove
</example>
+
+ <p>
+ If it fails, there's no error unwind, and the package is in
+ an "Half-Installed" state.
+ </p>
</item>
<item>
<p>
@@ -3782,19 +3787,6 @@
removed, as there is no difference except for the
<prgn>dpkg</prgn> status.
</p>
-
- <p>
- If something fails, the following is done for error
- rewind:
- <example>
-<var>postinst</var> abort-remove
- </example>
- </p>
- <p>
- If the error unwind fails, the package is in an
- "Half-Installed" state, or else it remains "Installed"
- - even though all the files may have been deleted..
- </p>
</item>
<item>
The <tt>conffile</tt>s and any backup files
@@ -3809,9 +3801,8 @@
</example>
</p>
<p>
- If this fails, the package remains in and "Installed'
- state -- even though by this point the files are all
- gone, and the conffiles may have been deleted.
+ If this fails, the package remains in a "Config-Files"
+ state.
</p>
</item>
<item>
signature.asc
Description: Digital signature
