]> git.ipfire.org Git - thirdparty/systemd.git/commitdiff
man: make it clear that homectl -A/T/N do not take an argument 40641/head
authorZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
Wed, 17 Dec 2025 14:19:29 +0000 (15:19 +0100)
committerZbigniew Jędrzejewski-Szmek <zbyszek@amutable.com>
Fri, 13 Feb 2026 10:07:27 +0000 (11:07 +0100)
Just like in the --help strings, we need to avoid confusion between
short options which take an argument and those that don't.

man/homectl.xml

index 82ea2e3943d70be575dd3c8d5ea66cc5d0477b7a..a59efd7112ee9028084d3855a383c340e3422a7d 100644 (file)
       </varlistentry>
 
       <varlistentry>
-        <term><option>--match=</option></term>
+        <term><option>--match=this|other|any|auto</option></term>
         <term><option>-A</option></term>
         <term><option>-N</option></term>
         <term><option>-T</option></term>
 
-        <listitem><para>Takes one of <literal>this</literal>, <literal>other</literal>,
-        <literal>any</literal> or <literal>auto</literal>. Some user record settings can be defined to match
-        only specific machines, or all machines but one, or all machines. With this switch it is possibly to
-        control to which machines to apply the settings appearing on the command line after it. If
-        <literal>this</literal> is specified the setting will only apply to the local system (positive
-        match), if <literal>other</literal> it will apply to all but the local system (negative match), if
-        <literal>any</literal> it will apply to all systems (unless there's a matching positive or negative
-        per-machine setting). If <literal>auto</literal> returns to the default logic: whether a setting
-        applies by default to the local system or all systems depends on the option in question.</para>
+        <listitem><para>Option <option>--match=</option> takes one of <literal>this</literal>,
+        <literal>other</literal>, <literal>any</literal> or <literal>auto</literal>. Some user record
+        settings can be defined to match only specific machines, or all machines but one, or all machines.
+        With this switch it is possibly to control to which machines to apply the settings appearing on the
+        command line after it. If <literal>this</literal> is specified the setting will only apply to the
+        local system (positive match), if <literal>other</literal> it will apply to all but the local system
+        (negative match), if <literal>any</literal> it will apply to all systems (unless there's a matching
+        positive or negative per-machine setting). If <literal>auto</literal> returns to the default logic:
+        whether a setting applies by default to the local system or all systems depends on the option in
+        question.</para>
 
         <para>Note that only some user record settings can be conditioned like this. This option has no
         effect on the others and is ignored there. This option may appear multiple times in a single command