]> git.ipfire.org Git - thirdparty/systemd.git/commitdiff
man/systemd: reword description of 2/3/4/5
authorZbigniew Jędrzejewski-Szmek <zbyszek@amutable.com>
Sat, 30 May 2026 19:44:58 +0000 (21:44 +0200)
committerZbigniew Jędrzejewski-Szmek <zbyszek@amutable.com>
Mon, 1 Jun 2026 10:19:03 +0000 (12:19 +0200)
We shouldn't say that that they boot into "a … legacy target", because
they boot into the standard targets. Those names are just aliases now.
(And also the user is not required to know what SysV even is, so it
shouldn't be used in the main explanation.)

man/systemd.xml

index 30ae385029b1085b03ea15c36e795311c903e58f..9020579d73ca7baa5779cdbd9fd9533ba11aa3a8 100644 (file)
         <term><varname>rd.emergency</varname></term>
         <term><varname>-b</varname></term>
 
-        <listitem><para>Boot into emergency mode. This is equivalent
-        to <varname>systemd.unit=emergency.target</varname> or
-        <varname>rd.systemd.unit=emergency.target</varname>, respectively, and
-        provided for compatibility reasons and to be easier to type.</para>
+        <listitem><para>Boot into emergency mode. Those options are equivalent to
+        <varname>systemd.unit=emergency.target</varname> or
+        <varname>rd.systemd.unit=emergency.target</varname>, respectively. They were initially
+        provided for compatibility with SysV, but are retained as convenient shortcuts.</para>
 
         <xi:include href="version-info.xml" xpointer="v186"/></listitem>
       </varlistentry>
         <term><varname>S</varname></term>
         <term><varname>1</varname></term>
 
-        <listitem><para>Boot into rescue mode. This is equivalent to
-        <varname>systemd.unit=rescue.target</varname> or
-        <varname>rd.systemd.unit=rescue.target</varname>, respectively, and
-        provided for compatibility reasons and to be easier to type.</para>
+        <listitem><para>Boot into rescue mode. Those options are equivalent to either
+        <varname>systemd.unit=rescue.target</varname> or <varname>rd.systemd.unit=rescue.target</varname>.
+        They were initially provided for compatibility with SysV, but are retained as convenient
+        shortcuts.</para>
 
         <xi:include href="version-info.xml" xpointer="v186"/></listitem>
       </varlistentry>
         <term><varname>4</varname></term>
         <term><varname>5</varname></term>
 
-        <listitem><para>Boot into the specified legacy SysV runlevel.
+        <listitem><para>Shortcuts to boot into specific targets:
         <varname>2</varname>, <varname>3</varname>, and <varname>4</varname> are equivalent to
         <varname>systemd.unit=multi-user.target</varname>; and <varname>5</varname> is equivalent to
-        <varname>systemd.unit=graphical.target</varname>, and provided for compatibility reasons and to be
-        easier to type.</para>
+        <varname>systemd.unit=graphical.target</varname>. Those options were initially provided
+        for compatibility with SysV, but are retained as convenient shortcuts.</para>
 
         <xi:include href="version-info.xml" xpointer="v186"/></listitem>
       </varlistentry>