colin/NetworkManager
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

man/cli: better explain modifying properties regarding +/- modifiers

Browse Source
This commit is contained in:
Thomas Haller
2019-08-12 15:57:14 +02:00
parent b789ce01e9
commit cec39d76bd
1 changed files with 12 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
man/nmcli.xml
View File

@@ -876,21 +876,23 @@
<para>Add, modify or remove properties in the connection profile.</para> <para>Add, modify or remove properties in the connection profile.</para>
<para>To set the property just specify the property name followed by the <para>To set the property just specify the property name followed by the
value. An empty value (<literal>""</literal>) removes the property value.</para> value. An empty value (<literal>""</literal>) resets the property value to
the default.</para>
<para>In addition to the properties, you can also use short names for some of <para>In addition to the properties, you can also use short names for some of
the properties. Consult the <link linkend='property_aliases' endterm='property_aliases.title' /> the properties. Consult the <link linkend='property_aliases' endterm='property_aliases.title' />
section for details.</para> section for details.</para>
<para>If you want to append an item to the existing value, use <para>If you want to append an item or a flag to the existing value, use
<literal>+</literal> prefix for the property name. If you want to remove just <literal>+</literal> prefix for the property name or alias. If you want to
one item from container-type property, use <literal>-</literal> prefix for remove items from a container-type or flag property, use <literal>-</literal> prefix.
the property name and specify a value or an zero-based index of the item to For certain properties you can also remove elements by specifying the zero-based
remove (or option name for properties with named options) as index(es).
<replaceable>value</replaceable>. The <literal>+</literal> and <literal>-</literal> The <literal>+</literal> and <literal>-</literal> modifiers
modifies only have a real effect for multi-value (container) only have a real effect for properties that support them.
properties like <literal>ipv4.dns</literal>, <literal>ipv4.addresses</literal>, These are for example multi-value (container) properties or flags like <literal>ipv4.dns</literal>,
<literal>bond.options</literal>, etc.</para> <literal>ip4</literal>, <literal>ipv4.addresses</literal>, <literal>bond.options</literal>,
<literal>802-1x.phase1-auth-flags</literal> etc.</para>
<para>See <citerefentry><refentrytitle>nm-settings</refentrytitle><manvolnum>5</manvolnum> <para>See <citerefentry><refentrytitle>nm-settings</refentrytitle><manvolnum>5</manvolnum>
</citerefentry> for complete reference of setting and property names, their descriptions </citerefentry> for complete reference of setting and property names, their descriptions