diff mbox series

doc: Re-work RULES:add/insert/replace to read better.

Message ID 20180921015427.4273-1-duncan_roe@optusnet.com.au
State Accepted
Delegated to: Pablo Neira
Headers show
Series doc: Re-work RULES:add/insert/replace to read better. | expand

Commit Message

Duncan Roe Sept. 21, 2018, 1:54 a.m. UTC
It was tempting to remove "position" from the synopsis,
but have left that for another patch.

Signed-off-by: Duncan Roe <duncan_roe@optusnet.com.au>
---
 doc/nft.txt | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

Comments

Phil Sutter Sept. 21, 2018, 8 a.m. UTC | #1
On Fri, Sep 21, 2018 at 11:54:27AM +1000, Duncan Roe wrote:
> It was tempting to remove "position" from the synopsis,
> but have left that for another patch.
> 
> Signed-off-by: Duncan Roe <duncan_roe@optusnet.com.au>

Acked-by: Phil Sutter <phil@nwl.cc>
Pablo Neira Ayuso Sept. 21, 2018, 8:12 a.m. UTC | #2
On Fri, Sep 21, 2018 at 11:54:27AM +1000, Duncan Roe wrote:
> It was tempting to remove "position" from the synopsis,
> but have left that for another patch.

Applied, thanks Duncan.
diff mbox series

Patch

diff --git a/doc/nft.txt b/doc/nft.txt
index 9d04e43..2a76a6c 100644
--- a/doc/nft.txt
+++ b/doc/nft.txt
@@ -410,6 +410,8 @@  concurrent ruleset change happens after the translation was done: The effective
 rule index might change if a rule was inserted or deleted before the referred
 one. If the referred rule was deleted, the command is rejected by the kernel
 just as if an invalid 'handle' was given.
+The old name "position" in place of "handle" is deprecated
+and should not be used anymore.
 
 A 'comment' is a single word or a double-quoted (") multi-word string which can
 be used to make notes regarding the actual rule. *Note:* If you use bash for
@@ -418,13 +420,11 @@  servers\")
 
 [horizontal]
 *add*:: 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'. The alternative
-name position is deprecated and should not be used anymore.
-*insert*:: Similar to the *add* command, but the rule is prepended to the
-beginning of the chain or before the rule with the given 'handle'.
-*replace*:: Similar to the add command, but the rule replaces the specified
-rule.
+rule is appended to the given chain unless a location is specified, in which
+case the rule is inserted after the specified rule.
+*insert*:: Same as *add* except the rule is inserted at the
+beginning of the chain or before the specified rule.
+*replace*:: Similar to *add*, but the rule replaces the specified rule.
 *delete*:: Delete the specified rule.
 
 .*add a rule to ip table input chain*