[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#985502: release-notes: suggestions for usrmerge section



Package: release-notes
Severity: wishlist
Tags: patch

Trying to make our coverage in issues.dbk more helpful.

>	  Historically there was a reason to split root level
>	  <filename>bin</filename>, <filename>sbin</filename> and
>	  <filename>lib</filename> directories into

Nobody ever split /bin etc. "into" /usr; the historical standard was
to have those directories to split things "out from" the equivalents
under /usr.

>	  <filename>/usr/</filename>, but that is no more.

Unclear; say "but this justification no longer applies today".
Preferably this bald assertion would go with a link to an explanation;
and I suppose that has to be
https://www.freedesktop.org/wiki/Software/systemd/TheCaseForTheUsrMerge
(unless the Debian Wiki version suddenly gets much better).

>                                                            Debian
>	  bullseye will be the last Debian release that supports the
>	  non-merged-usr layout.

Unless the plan is for the bookworm Release Notes to tell users with
legacy layouts that they can't upgrade, we should be pointing at
usrmerge here.
-- 
JBR	with qualifications in linguistics, experience as a Debian
	sysadmin, and probably no clue about this particular package
diff --git a/en/issues.dbk b/en/issues.dbk
index 95fab9b6..bd8fd99d 100644
--- a/en/issues.dbk
+++ b/en/issues.dbk
@@ -200,12 +200,18 @@ information mentioned in <xref linkend="morereading"/>.
 
       <listitem>
         <para>
-	  Historically there was a reason to split root level
-	  <filename>bin</filename>, <filename>sbin</filename> and
-	  <filename>lib</filename> directories into
-	  <filename>/usr/</filename>, but that is no more. Debian
-	  bullseye will be the last Debian release that supports the
-	  non-merged-usr layout.
+         Historically there was a reason to split root level
+         <filename>/bin</filename>, <filename>/sbin</filename>, and
+         <filename>/lib</filename> directories from their equivalents
+         under <filename>/usr</filename>, but this justification no
+         longer applies today; see the <ulink
+         url="https://www.freedesktop.org/wiki/Software/systemd/TheCaseForTheUsrMerge";>Freedesktop.org
+         summary</ulink>. Debian 11 <quote>bullseye</quote> will be
+         the last Debian release that supports the non-merged-usr
+         layout, so systems with an unmerged layout that have been
+         upgraded without a reinstall will need at some point to
+         install the package
+         <systemitem role="package">usrmerge</systemitem>.
         </para>
       </listitem>
 

Reply to: