Skip to contentSkip to conversation

doc: fix typos and wording in flow API guide

PATCH Superseded Ali Alnubani 3 participants 5 messages Jul 3, 2023 – Jul 17, 2023

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 doc: fix typos and wording in flow API guide

This fixes typos, punctuation and wording in the rte flow API guide.

Fixes 2f82d143fb31 ("ethdev: add group jump action")
---
 doc/guides/prog_guide/rte_flow.rst | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)
doc/guides/prog_guide/rte_flow.rst +8 -8
index 32fc45516a..6dbf5ef0a4 100644
@@ -148,14 +148,14 @@ Attribute: Group
 Flow rules can be grouped by assigning them a common group number. Groups
 allow a logical hierarchy of flow rule groups (tables) to be defined. These
 groups can be supported virtually in the PMD or in the physical device.
-Group 0 is the default group and this is the only group which flows are
-guarantee to matched against, all subsequent groups can only be reached by
-way of the JUMP action from a matched flow rule.
+Group 0 is the default group and is the only group where flows are
+guaranteed to be matched against. All subsequent groups can only be reached by
+using a JUMP action from a matched flow rule.
 
 Although optional, applications are encouraged to group similar rules as
 much as possible to fully take advantage of hardware capabilities
 (e.g. optimized matching) and work around limitations (e.g. a single pattern
-type possibly allowed in a given group), while being aware that the groups
+type possibly allowed in a given group), while being aware that the groups'
 hierarchies must be programmed explicitly.
 
 Note that support for more than a single group is not guaranteed.
@@ -170,7 +170,7 @@ Priority levels are arbitrary and up to the application, they do
 not need to be contiguous nor start from 0, however the maximum number
 varies between devices and may be affected by existing flow rules.
 
-A flow which matches multiple rules in the same group will always matched by
+A flow which matches multiple rules in the same group will always be matched by
 the rule with the highest priority in that group.
 
 If a packet is matched by several rules of a given group for a given
@@ -1755,12 +1755,12 @@ flow group/tables on the device, this action redirects the matched flow to
 the specified group on that device.
 
 If a matched flow is redirected to a table which doesn't contain a matching
-rule for that flow then the behavior is undefined and the resulting behavior
-is up to the specific device. Best practice when using groups would be define
+rule for that flow, then the behavior is undefined and the resulting behavior
+is up to the specific device. Best practice when using groups would be to define
 a default flow rule for each group which a defines the default actions in that
 group so a consistent behavior is defined.
 
-Defining an action for matched flow in a group to jump to a group which is
+Defining an action for a matched flow in a group to jump to a group which is
 higher in the group hierarchy may not be supported by physical devices,
 depending on how groups are mapped to the physical devices. In the
 definitions of jump actions, applications should be aware that it may be
Signature · 1 line
2.25.1
#1 lore raw
Quoted 50 lines · Ali Alnubani

This fixes typos, punctuation and wording in the rte flow API guide.

Fixes 2f82d143fb31 ("ethdev: add group jump action")
---
 doc/guides/prog_guide/rte_flow.rst | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)
doc/guides/prog_guide/rte_flow.rst +5 -7
index 32fc45516a..6dbf5ef0a4 100644
@@ -148,14 +148,14 @@ Attribute: Group
 Flow rules can be grouped by assigning them a common group number. Groups
 allow a logical hierarchy of flow rule groups (tables) to be defined. These
 groups can be supported virtually in the PMD or in the physical device.
-Group 0 is the default group and this is the only group which flows are
-guarantee to matched against, all subsequent groups can only be reached by
-way of the JUMP action from a matched flow rule.
+Group 0 is the default group and is the only group where flows are
+guaranteed to be matched against. All subsequent groups can only be reached by
+using a JUMP action from a matched flow rule.
 
 Although optional, applications are encouraged to group similar rules as
 much as possible to fully take advantage of hardware capabilities
 (e.g. optimized matching) and work around limitations (e.g. a single pattern
-type possibly allowed in a given group), while being aware that the groups
+type possibly allowed in a given group), while being aware that the groups'
 hierarchies must be programmed explicitly.
 
 Note that support for more than a single group is not guaranteed.
@@ -170,7 +170,7 @@ Priority levels are arbitrary and up to the application, they do
 not need to be contiguous nor start from 0, however the maximum number
 varies between devices and may be affected by existing flow rules.
 
-A flow which matches multiple rules in the same group will always matched by
+A flow which matches multiple rules in the same group will always be matched by
 the rule with the highest priority in that group.
 
 If a packet is matched by several rules of a given group for a given
@@ -1755,12 +1755,12 @@ flow group/tables on the device, this action redirects the matched flow to
 the specified group on that device.
 
 If a matched flow is redirected to a table which doesn't contain a matching
-rule for that flow then the behavior is undefined and the resulting behavior
-is up to the specific device. Best practice when using groups would be define

doc/guides/prog_guide/rte_flow.rst flow group/tables on the device, this action redirects the matched flow to · line 1766

Quoted 10 lines
doc/guides/prog_guide/rte_flow.rst +3 -1
+rule for that flow, then the behavior is undefined and the resulting behavior
+is up to the specific device. Best practice when using groups would be to define
 a default flow rule for each group which a defines the default actions in that
 group so a consistent behavior is defined.
 
-Defining an action for matched flow in a group to jump to a group which is
+Defining an action for a matched flow in a group to jump to a group which is
 higher in the group hierarchy may not be supported by physical devices,
 depending on how groups are mapped to the physical devices. In the
 definitions of jump actions, applications should be aware that it may be

Hi John, Can you please help reviewing this patch?

Acked-by on v1 1/1
#2 lore raw
In reply to Ali Alnubani
Quoted 17 lines

-----Original Message-----
From: Ali Alnubani <[email protected]>
Sent: Monday, July 3, 2023 8:58 AM
To: [email protected]
Cc: Doherty, Declan <[email protected]>; [email protected]
Subject: [PATCH] doc: fix typos and wording in flow API guide

This fixes typos, punctuation and wording in the rte flow API guide.

Fixes 2f82d143fb31 ("ethdev: add group jump action")

Review

Quoted 2 lines
(quoted diff) +1 -1
-Group 0 is the default group and this is the only group which flows
+Group 0 is the default group and is the only group where flows are

Slightly better is s/where flows/that flows/

With, or without that change:

#3 lore raw

PATCH v2 1/1 doc: fix typos and wording in flow API guide

In reply to Ali Alnubani

This fixes typos, punctuation and wording in the rte flow API guide.

Fixes 2f82d143fb31 ("ethdev: add group jump action")

---
Changes in v2: rebased and replaced a relative pronoun.

 doc/guides/prog_guide/rte_flow.rst | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)
doc/guides/prog_guide/rte_flow.rst +8 -8
index 28d09c58d5..d9f2b51245 100644
@@ -148,14 +148,14 @@ Attribute: Group
 Flow rules can be grouped by assigning them a common group number. Groups
 allow a logical hierarchy of flow rule groups (tables) to be defined. These
 groups can be supported virtually in the PMD or in the physical device.
-Group 0 is the default group and this is the only group which flows are
-guarantee to matched against, all subsequent groups can only be reached by
-way of the JUMP action from a matched flow rule.
+Group 0 is the default group and is the only group that flows are
+guaranteed to be matched against. All subsequent groups can only be reached by
+using a JUMP action from a matched flow rule.
 
 Although optional, applications are encouraged to group similar rules as
 much as possible to fully take advantage of hardware capabilities
 (e.g. optimized matching) and work around limitations (e.g. a single pattern
-type possibly allowed in a given group), while being aware that the groups
+type possibly allowed in a given group), while being aware that the groups'
 hierarchies must be programmed explicitly.
 
 Note that support for more than a single group is not guaranteed.
@@ -170,7 +170,7 @@ Priority levels are arbitrary and up to the application, they do
 not need to be contiguous nor start from 0, however the maximum number
 varies between devices and may be affected by existing flow rules.
 
-A flow which matches multiple rules in the same group will always matched by
+A flow which matches multiple rules in the same group will always be matched by
 the rule with the highest priority in that group.
 
 If a packet is matched by several rules of a given group for a given
@@ -1769,12 +1769,12 @@ flow group/tables on the device, this action redirects the matched flow to
 the specified group on that device.
 
 If a matched flow is redirected to a table which doesn't contain a matching
-rule for that flow then the behavior is undefined and the resulting behavior
-is up to the specific device. Best practice when using groups would be define
+rule for that flow, then the behavior is undefined and the resulting behavior
+is up to the specific device. Best practice when using groups would be to define
 a default flow rule for each group which a defines the default actions in that
 group so a consistent behavior is defined.
 
-Defining an action for matched flow in a group to jump to a group which is
+Defining an action for a matched flow in a group to jump to a group which is
 higher in the group hierarchy may not be supported by physical devices,
 depending on how groups are mapped to the physical devices. In the
 definitions of jump actions, applications should be aware that it may be
Signature · 1 line
2.25.1