Skip to content

man page corrections

Stephen Hemminger netdev 1 version Applied

Status from this message: This series was applied to iproute2/iproute2-next.git (main)

Get series with b4
b4 am [email protected]

Versions newest first

  1. v1 Latest7 patches 0 repliesApplied

Patches in v1 Applied

#Subject and filesSizeRepliesApplied
1/7dcb: fix grammar and style issues in man pagesman/man8/dcb-app.8 man/man8/dcb-apptrust.8 man/man8/dcb-buffer.8 +4 more+46 -450 replies
2/7devlink: fix grammar and style issues in man pagesman/man8/devlink-dev.8 man/man8/devlink-port.8 man/man8/devlink-rate.8 +1 more+42 -270 replies
3/7fix grammar and style issues in man pages for stat related pagesman/man8/ifstat.8 man/man8/lnstat.8 man/man8/rtacct.8+15 -150 replies
4/7netshaper: fix grammar and style issues in man pageman/man8/netshaper.8+10 -90 replies
5/7tipc: fix grammar and style issues in man pagesman/man8/tipc-bearer.8 man/man8/tipc-link.8 man/man8/tipc-nametable.8 +3 more+17 -180 replies
6/7vdpa: fix grammar, titles, and formatting in man pagesman/man8/vdpa-dev.8 man/man8/vdpa-mgmtdev.8 man/man8/vdpa.8+13 -110 replies
7/7rdma: fix grammar, formatting, and style in man pagesman/man8/rdma-dev.8 man/man8/rdma-link.8 man/man8/rdma-monitor.8 +4 more+46 -350 replies

Reviews trailers per patch

No Reviewed-by, Acked-by or Tested-by trailers for v1 yet.

Read the v1 thread

Cover letter [PATCH iproute2-next 0/7] man page corrections

AI does a great job of finding and fixing manual pages.
This patch series is the result of editorial review and correction of subsystem man pages, addressing grammatical errors, style inconsistencies, and clarity issues throughout the documentation.

The corrections cover the following subsystems:
- DCB (Data Center Bridging)
- devlink
- Statistics tools (lnstat, rtacct, nstat)
- netshaper
- TIPC
- vdpa
- RDMA

Common patterns corrected across all man pages:
- Subject-verb agreement and singular/plural consistency
- Missing or incorrect articles (a, an, the)
- Inconsistent verb tenses in command descriptions
- Missing terminal punctuation in examples and descriptions
- Overly long section headers (split into concise headers + body text)
- Awkward or non-idiomatic English phrasing
- Copy-paste errors (e.g., incorrect titles from template files)
- Formatting issues (duplicate markup, missing commas in cross-references)

All corrections are purely editorial. No functional changes have been made, and all technical content remains accurate. The documentation now maintains consistent style and proper grammar while preserving the original technical information.

Total corrections: approximately 100+ individual fixes across 40+ man page files.

Stephen Hemminger (7):
dcb: fix grammar and style issues in man pages
devlink: fix grammar and style issues in man pages fix grammar and style issues in man pages for stat tools
netshaper: fix grammar and style issues in man page
tipc: fix grammar and style issues in man pages
vdpa: fix grammar, titles, and formatting in man pages
rdma: fix grammar, formatting, and style in man pages

 man/man8/dcb-app.8          |  24 +++---
 man/man8/dcb-apptrust.8     |  16 ++--
 man/man8/dcb-buffer.8       |   4 +-
 man/man8/dcb-dcbx.8         |   2 +-
 man/man8/dcb-ets.8          |   4 +-
 man/man8/dcb-rewr.8         |  34 ++++----
 man/man8/dcb.8              |   7 +-
 man/man8/devlink-dev.8      |  38 ++++-----
 man/man8/devlink-port.8     |  42 +++++-----
 man/man8/devlink-rate.8     |  28 +++----
 man/man8/devlink.8          |  12 +--
 man/man8/lnstat.8           |  10 +--
 man/man8/netshaper.8        |  14 ++--
 man/man8/rdma-dev.8         |  28 +++----
 man/man8/rdma-link.8        |  12 +--
 man/man8/rdma-monitor.8     |   8 +-
 man/man8/rdma-resource.8    |  14 ++--
 man/man8/rdma-statistic.8   |  36 ++++----
 man/man8/rdma-system.8      |   6 +-
 man/man8/rdma.8             |  12 +--
 man/man8/rtacct.8           |  18 ++--
 man/man8/tipc-bearer.8      |  10 +--
 man/man8/tipc-link.8        |  16 ++--
 man/man8/tipc-nametable.8   |  18 ++--
 man/man8/tipc-node.8        |   6 +-
 man/man8/tipc-socket.8      |   4 +-
 man/man8/tipc.8             |   4 +-
 man/man8/vdpa-dev.8         |  24 +++---
 man/man8/vdpa-mgmtdev.8     |   6 +-
 man/man8/vdpa.8             |   4 +-
 30 files changed, 231 insertions(+), 230 deletions(-)
Signature · 46 lines
2.43.0

Stephen Hemminger (7):
  dcb: fix grammar and style issues in man pages
  devlink: fix grammar and style issues in man pages
  fix grammar and style issues in man pages for stat related pages
  netshaper: fix grammar and style issues in man page
  tipc: fix grammar and style issues in man pages
  vdpa: fix grammar, titles, and formatting in man pages
  rdma: fix grammar, formatting, and style in man pages

 man/man8/dcb-app.8        | 24 ++++++++++++------------
 man/man8/dcb-apptrust.8   | 16 ++++++++--------
 man/man8/dcb-buffer.8     |  4 ++--
 man/man8/dcb-dcbx.8       |  2 +-
 man/man8/dcb-ets.8        |  4 ++--
 man/man8/dcb-rewr.8       | 34 +++++++++++++++++-----------------
 man/man8/dcb.8            |  7 ++++---
 man/man8/devlink-dev.8    |  8 ++++----
 man/man8/devlink-port.8   | 18 +++++++++---------
 man/man8/devlink-rate.8   | 18 +++++++++---------
 man/man8/devlink.8        | 25 ++++++++++++++++++++-----
 man/man8/ifstat.8         |  4 ++--
 man/man8/lnstat.8         | 10 +++++-----
 man/man8/netshaper.8      | 19 ++++++++++---------
 man/man8/rdma-dev.8       | 23 ++++++++++++++---------
 man/man8/rdma-link.8      | 10 ++++++----
 man/man8/rdma-monitor.8   |  7 +++++--
 man/man8/rdma-resource.8  |  6 +++---
 man/man8/rdma-statistic.8 | 24 +++++++++++++-----------
 man/man8/rdma-system.8    |  3 +--
 man/man8/rdma.8           |  8 ++++----
 man/man8/rtacct.8         | 16 ++++++++--------
 man/man8/tipc-bearer.8    |  6 +++---
 man/man8/tipc-link.8      | 10 +++++-----
 man/man8/tipc-nametable.8 | 11 +++++------
 man/man8/tipc-node.8      |  4 ++--
 man/man8/tipc-socket.8    |  2 +-
 man/man8/tipc.8           |  2 +-
 man/man8/vdpa-dev.8       | 18 ++++++++++--------
 man/man8/vdpa-mgmtdev.8   |  4 ++--
 man/man8/vdpa.8           |  2 +-
 31 files changed, 189 insertions(+), 160 deletions(-)

-- 
2.51.0