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>
