lists.openwall.net   lists  /  announce  owl-users  owl-dev  john-users  john-dev  passwdqc-users  yescrypt  popa3d-users  /  oss-security  kernel-hardening  musl  sabotage  tlsify  passwords  /  crypt-dev  xvendor  /  Bugtraq  Full-Disclosure  linux-kernel  linux-netdev  linux-ext4  linux-hardening  linux-cve-announce  PHC 
Open Source and information security mailing list archives
 
Hash Suite: Windows password security audit tool. GUI, reports in PDF.
[<prev] [next>] [thread-next>] [day] [month] [year] [list]
Message-ID: <20260124195824.221305-1-stephen@networkplumber.org>
Date: Sat, 24 Jan 2026 11:49:24 -0800
From: Stephen Hemminger <stephen@...workplumber.org>
To: netdev@...r.kernel.org
Cc: Stephen Hemminger <stephen@...workplumber.org>
Subject: [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(-)

-- 
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


Powered by blists - more mailing lists

Powered by Openwall GNU/*/Linux Powered by OpenVZ