git: ad4aa53b46e2 - stable/12 - pw.8: Improve use of mdoc macros in description section

From: Mateusz Piotrowski <>
Date: Fri, 08 Apr 2022 09:03:51 UTC
The branch stable/12 has been updated by 0mp (doc, ports committer):


commit ad4aa53b46e22789c4abf7ee7475c20efe7509cb
Author:     Mateusz Piotrowski <>
AuthorDate: 2022-04-01 10:58:52 +0000
Commit:     Mateusz Piotrowski <>
CommitDate: 2022-04-08 08:59:33 +0000

    pw.8: Improve use of mdoc macros in description section
    MFC after:      1 week
    (cherry picked from commit 61e11ed9bd183aacc684b56d96177a194053f622)
 usr.sbin/pw/pw.8 | 36 +++++++++++++++++++-----------------
 1 file changed, 19 insertions(+), 17 deletions(-)

diff --git a/usr.sbin/pw/pw.8 b/usr.sbin/pw/pw.8
index 721b4fbdb209..f7b6a8a4830b 100644
--- a/usr.sbin/pw/pw.8
+++ b/usr.sbin/pw/pw.8
@@ -202,9 +202,9 @@ server.
 utility handles updating the
-.Pa passwd ,
-.Pa master.passwd ,
-.Pa group
+.Xr passwd 5 ,
+.Xr master.passwd 5 ,
+.Xr group 5
 and the secure and insecure
 password database files, and must be run as root.
@@ -212,23 +212,23 @@ The first one or two keywords provided to
 on the command line provide the context for the remainder of the arguments.
 The keywords
-.Ar user
+.Cm user
-.Ar group
+.Cm group
 may be combined with
-.Ar add ,
-.Ar del ,
-.Ar mod ,
-.Ar show ,
+.Cm add ,
+.Cm del ,
+.Cm mod ,
+.Cm show ,
-.Ar next
+.Cm next
 in any order.
 (For example,
-.Ar showuser ,
-.Ar usershow ,
-.Ar show user ,
+.Cm showuser ,
+.Cm usershow ,
+.Cm show user ,
-.Ar user show
+.Cm user show
 all mean the same thing.)
 This flexibility is useful for interactive scripts calling
@@ -255,7 +255,9 @@ Can be used to maintain a user/group database in an alternate location.
 If this switch is specified, the system
 .Pa /etc/pw.conf
 will not be sourced for default configuration data,
-but the file pw.conf in the specified directory will be used instead
+but the file
+.Pa pw.conf
+in the specified directory will be used instead
 .Pq or none, if it does not exist .
 .Fl C
@@ -286,9 +288,9 @@ is preferable to interpret status codes returned by
 rather than messing up a carefully formatted display.
 .It Fl N
 This option is available in
-.Ar add
+.Cm add
-.Ar modify
+.Cm modify
 operations, and tells
 to output the result of the operation without updating the user or group