SymbX/systemd
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

man: make it clear that homectl -A/T/N do not take an argument

Browse Source 
Just like in the --help strings, we need to avoid confusion between
short options which take an argument and those that don't.
This commit is contained in:
Zbigniew Jędrzejewski-Szmek
2026-02-13 11:07:27 +01:00
committed by Zbigniew Jędrzejewski-Szmek
parent 952f3a5dbf
commit c46cc2630d
1 changed files with 11 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files
man/homectl.xml
+11 -10
View File
@@ -256,20 +256,21 @@
</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