diff options
author | Phil Sutter <phil@nwl.cc> | 2018-05-09 16:03:40 +0200 |
---|---|---|
committer | Pablo Neira Ayuso <pablo@netfilter.org> | 2018-05-09 18:29:21 +0200 |
commit | effb881c9cef28aca47adeec5014e0457507539e (patch) | |
tree | 2287a62e27aabd91966758de61425dbf375e8346 /doc | |
parent | 2efbdf7b8fcf79f3fa8a6471d2eca00df0c91108 (diff) |
Deprecate add/insert rule 'position' argument
Instead, use 'handle' keyword for the same effect since that is more
consistent with respect to replace/delete commands. The old keyword is
still supported for backwards compatibility and also listed in man page
along with a hint that it shouldn't be used anymore.
Signed-off-by: Phil Sutter <phil@nwl.cc>
Signed-off-by: Pablo Neira Ayuso <pablo@netfilter.org>
Diffstat (limited to 'doc')
-rw-r--r-- | doc/nft.xml | 17 |
1 files changed, 13 insertions, 4 deletions
diff --git a/doc/nft.xml b/doc/nft.xml index 60691580..b80c8c43 100644 --- a/doc/nft.xml +++ b/doc/nft.xml @@ -875,7 +875,13 @@ add table inet mytable <arg choice="opt"><replaceable>family</replaceable></arg> <replaceable>table</replaceable> <replaceable>chain</replaceable> - <arg choice="opt">position <replaceable>handle</replaceable></arg> + <arg choice="opt"> + <group choice="req"> + <arg>handle</arg> + <arg>position</arg> + </group> + <replaceable>handle</replaceable> + </arg> <replaceable>statement</replaceable>... </cmdsynopsis> <cmdsynopsis> @@ -910,8 +916,10 @@ add table inet mytable <listitem> <para> Add a new rule described by the list of statements. The rule is appended to the - given chain unless a position is specified, in which case the rule is appended to - the rule given by the handle. + given chain unless a <literal>handle</literal> is specified, in which case the + rule is appended to the rule given by the <replaceable>handle</replaceable>. + The alternative name <literal>position</literal> is deprecated and should not be + used anymore. </para> </listitem> </varlistentry> @@ -920,7 +928,8 @@ add table inet mytable <listitem> <para> Similar to the <command>add</command> command, but the rule is prepended to the - beginning of the chain or before the rule with the given handle. + beginning of the chain or before the rule with the given + <replaceable>handle</replaceable>. </para> </listitem> </varlistentry> |