From: Antoine Tenart <atenart@kernel.org>
To: jiri@nvidia.com, stephen@networkplumber.org, dsahern@gmail.com
Cc: Antoine Tenart <atenart@kernel.org>, netdev@vger.kernel.org
Subject: [PATCH iproute2-next 2/3] man: devlink-port: fix style
Date: Wed, 6 Oct 2021 11:44:54 +0200 [thread overview]
Message-ID: <20211006094455.138504-2-atenart@kernel.org> (raw)
In-Reply-To: <20211006094455.138504-1-atenart@kernel.org>
Values should be .I, square brackets should be used for optional values,
curly brackets for lists. Follow this in the devlink-port man page.
Signed-off-by: Antoine Tenart <atenart@kernel.org>
---
man/man8/devlink-port.8 | 38 +++++++++++++++++++-------------------
1 file changed, 19 insertions(+), 19 deletions(-)
diff --git a/man/man8/devlink-port.8 b/man/man8/devlink-port.8
index 4d2ff5d87144..e5686deae573 100644
--- a/man/man8/devlink-port.8
+++ b/man/man8/devlink-port.8
@@ -45,16 +45,16 @@ devlink-port \- devlink port configuration
.ti -8
.BI "devlink port add"
-.RB "["
+.RB "{"
.IR "DEV | DEV/PORT_INDEX"
-.RB "] "
+.RB "} "
.RB "[ " flavour
.IR FLAVOUR " ]"
.RB "[ " pcipf
.IR PFNUMBER " ]"
.br
-.RB "{ " sfnum
-.IR SFNUMBER " }"
+.RB "[ " sfnum
+.IR SFNUMBER " ]"
.br
.RB "[ " controller
.IR CNUM " ]"
@@ -102,7 +102,7 @@ devlink-port \- devlink port configuration
.SS devlink port set - change devlink port attributes
.PP
-.B "DEV/PORT_INDEX"
+.I "DEV/PORT_INDEX"
- specifies the devlink port to operate on.
.in +4
@@ -126,7 +126,7 @@ set port type
.SS devlink port split - split devlink port into more
.PP
-.B "DEV/PORT_INDEX"
+.I "DEV/PORT_INDEX"
- specifies the devlink port to operate on.
.TP
@@ -137,7 +137,7 @@ number of ports to split to.
Could be performed on any split port of the same split group.
.PP
-.B "DEV/PORT_INDEX"
+.I "DEV/PORT_INDEX"
- specifies the devlink port to operate on.
.SS devlink port show - display devlink port attributes
@@ -154,11 +154,11 @@ Is an alias for
.ti -8
.SS devlink port add - add a devlink port
.PP
-.B "DEV"
+.I "DEV"
- specifies the devlink device to operate on. or
.PP
-.B "DEV/PORT_INDEX"
+.I "DEV/PORT_INDEX"
- specifies the devlink port index to use for the requested new port.
This is optional. When omitted, driver allocates unique port index.
@@ -173,17 +173,17 @@ set port flavour
- PCI SF port
.TP
-.BR pfnum " { " pfnumber " } "
+.BI pfnum " PFNUMBER "
Specifies PCI pfnumber to use on which a SF device to create
.TP
-.BR sfnum " { " sfnumber " } "
+.BI sfnum " SFNUMBER "
Specifies sfnumber to assign to the device of the SF.
This field is optional for those devices which supports auto assignment of the
SF number.
.TP
-.BR controller " { " controller " } "
+.BI controller " CNUM "
Specifies controller number for which the SF port is created.
This field is optional. It is used only when SF port is created for the
external controller.
@@ -192,17 +192,17 @@ external controller.
.SS devlink port function set - Set the port function attribute(s).
.PP
-.B "DEV/PORT_INDEX"
+.I "DEV/PORT_INDEX"
- specifies the devlink port to operate on.
.TP
-.BR hw_addr " ADDR"
-- hardware address of the function to set. This is a Ethernet MAC address when
+.BI hw_addr " ADDR"
+Hardware address of the function to set. This is a Ethernet MAC address when
port type is Ethernet.
.TP
.BR state " { " active " | " inactive " } "
-- new state of the function to change to.
+New state of the function to change to.
.I active
- Once configuration of the function is done, activate the function.
@@ -213,13 +213,13 @@ port type is Ethernet.
.ti -8
.SS devlink port del - delete a devlink port
.PP
-.B "DEV/PORT_INDEX"
+.I "DEV/PORT_INDEX"
- specifies the devlink port to delete.
.ti -8
.SS devlink port param set - set new value to devlink port configuration parameter
.PP
-.B "DEV/PORT_INDEX"
+.I "DEV/PORT_INDEX"
- specifies the devlink port to operate on.
.TP
@@ -246,7 +246,7 @@ Configuration mode in which the new value is set.
.SS devlink port param show - display devlink port supported configuration parameters attributes
.PP
-.B "DEV/PORT_INDEX"
+.I "DEV/PORT_INDEX"
- specifies the devlink port to operate on.
.B name
--
2.31.1
next prev parent reply other threads:[~2021-10-06 9:45 UTC|newest]
Thread overview: 4+ messages / expand[flat|nested] mbox.gz Atom feed top
2021-10-06 9:44 [PATCH iproute2-next 1/3] man: devlink-port: fix the devlink port add synopsis Antoine Tenart
2021-10-06 9:44 ` Antoine Tenart [this message]
2021-10-06 9:44 ` [PATCH iproute2-next 3/3] man: devlink-port: remove extra .br Antoine Tenart
2021-10-06 9:51 ` [PATCH iproute2-next 1/3] man: devlink-port: fix the devlink port add synopsis Antoine Tenart
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20211006094455.138504-2-atenart@kernel.org \
--to=atenart@kernel.org \
--cc=dsahern@gmail.com \
--cc=jiri@nvidia.com \
--cc=netdev@vger.kernel.org \
--cc=stephen@networkplumber.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).