diff options
author | Thomas Haller <thaller@redhat.com> | 2019-08-12 15:57:14 +0200 |
---|---|---|
committer | Thomas Haller <thaller@redhat.com> | 2019-08-13 08:53:12 +0200 |
commit | c563fde29576c50a2b490f87a54c5f78f46124a5 (patch) | |
tree | 28533c089a58c9ea6d50d4d3e7ff80f621785e8a | |
parent | 8b3ab90a06bf537786fe2041af54e714aeba3c34 (diff) | |
download | NetworkManager-th/cli-modify-enums-and-cleanup.tar.gz |
man/cli: better explain modifying properties regarding +/- modifiersth/cli-modify-enums-and-cleanup
-rw-r--r-- | man/nmcli.xml | 22 |
1 files changed, 12 insertions, 10 deletions
diff --git a/man/nmcli.xml b/man/nmcli.xml index 43d469c4ca..e9517456f3 100644 --- a/man/nmcli.xml +++ b/man/nmcli.xml @@ -876,21 +876,23 @@ <para>Add, modify or remove properties in the connection profile.</para> <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 the properties. Consult the <link linkend='property_aliases' endterm='property_aliases.title' /> section for details.</para> - <para>If you want to append an item to the existing value, use - <literal>+</literal> prefix for the property name. If you want to remove just - one item from container-type property, use <literal>-</literal> prefix for - the property name and specify a value or an zero-based index of the item to - remove (or option name for properties with named options) as - <replaceable>value</replaceable>. The <literal>+</literal> and <literal>-</literal> - modifies only have a real effect for multi-value (container) - properties like <literal>ipv4.dns</literal>, <literal>ipv4.addresses</literal>, - <literal>bond.options</literal>, etc.</para> + <para>If you want to append an item or a flag to the existing value, use + <literal>+</literal> prefix for the property name or alias. If you want to + remove items from a container-type or flag property, use <literal>-</literal> prefix. + For certain properties you can also remove elements by specifying the zero-based + index(es). + The <literal>+</literal> and <literal>-</literal> modifiers + only have a real effect for properties that support them. + These are for example multi-value (container) properties or flags like <literal>ipv4.dns</literal>, + <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> </citerefentry> for complete reference of setting and property names, their descriptions |