Bug#1069417: upgrade procedure instructs users to run “apt update” but neglects upgrading

2024-04-22 Thread Paul Gevers

Hi Holger,

On 22-04-2024 9:05 a.m., Holger Wansing wrote:

A patch for above two issues is attached (against the bookworm branch; any
such changing needs to be ported to master/trixie as well).


Feel free to push. Bonus points if you remove the deleted text from 
translations too (where you're confident).


Paul


OpenPGP_signature.asc
Description: OpenPGP digital signature


Bug#1069417: upgrade procedure instructs users to run “apt update” but neglects upgrading

2024-04-22 Thread Holger Wansing
Control: tags -1 + patch


Manny  wrote:
> The Bookworm release notes instruct users to “upgrade” to the latest point 
> release of Bullseye prior to upgrading to Bookworm:
> 
>   
> https://www.debian.org/releases/stable/i386/release-notes/ch-upgrading.en.html#upgrade-to-latest-point-release
> 
> When following that link, the article says to do an “apt update” then 
> neglects to tell users to perform the upgrade.

Moreover, we have "This should only be necessary in specific situations." in 
this chapter appendix A [1], while we recommend to upgrade to the latest point
release of stable in 4.2.2 [2].

We should remove that phrase completely.

A patch for above two issues is attached (against the bookworm branch; any
such changing needs to be ported to master/trixie as well).


Holger


[1] 
https://www.debian.org/releases/stable/amd64/release-notes/ap-old-stuff.en.html#old-upgrade
[2] 
https://www.debian.org/releases/stable/amd64/release-notes/ch-upgrading.en.html#upgrade-to-latest-point-release

-- 
Holger Wansing 
PGP-Fingerprint: 496A C6E8 1442 4B34 8508  3529 59F1 87CA 156E B076
diff --git a/en/old-stuff.dbk b/en/old-stuff.dbk
index b1c734e7..287c80c1 100644
--- a/en/old-stuff.dbk
+++ b/en/old-stuff.dbk
@@ -2,22 +2,21 @@
 https://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd; [
%languagedata;
%shareddata;
 ]>
 
 
 Managing your  system before the upgrade
 
 This appendix contains information on how to make sure you can install or
-upgrade  packages before you upgrade to .  This should only be
-necessary in specific situations.
+upgrade  packages before you upgrade to .
 
 
 Upgrading your  system
 
 Basically this is no different from any other upgrade of  you've been
 doing.  The only difference is that you first need to make sure your package
 list still contains references to  as explained in .
 
 
@@ -73,20 +72,31 @@ not.  It is possible to downgrade packages, but that is not covered here.
 If you've made any changes, save the file and execute
 
 
 # apt update
 
 
 to refresh the package list.
 
 
 
+
+Performing the upgrade to latest  release
+
+To upgrade all packages to the state of the latest point release for
+, do
+
+
+# apt full-upgrade
+
+
+
 
 Removing obsolete configuration files
 
 Before upgrading your system to , it is recommended to remove old
 configuration files (such as *.dpkg-{new,old} files under
 /etc) from the system.