git: 210c02a2ce63 - stable/13 - pw.8: Improve use of mdoc macros in description section
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Fri, 08 Apr 2022 09:04:00 UTC
The branch stable/13 has been updated by 0mp (doc, ports committer): URL: https://cgit.FreeBSD.org/src/commit/?id=210c02a2ce63b7541e0a4e75853932e9de33b299 commit 210c02a2ce63b7541e0a4e75853932e9de33b299 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2022-04-01 10:58:52 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2022-04-08 09:03:23 +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. The .Nm 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. .Pp @@ -212,23 +212,23 @@ The first one or two keywords provided to .Nm on the command line provide the context for the remainder of the arguments. The keywords -.Ar user +.Cm user and -.Ar group +.Cm group may be combined with -.Ar add , -.Ar del , -.Ar mod , -.Ar show , +.Cm add , +.Cm del , +.Cm mod , +.Cm show , or -.Ar next +.Cm next in any order. (For example, -.Ar showuser , -.Ar usershow , -.Ar show user , +.Cm showuser , +.Cm usershow , +.Cm show user , and -.Ar user show +.Cm user show all mean the same thing.) This flexibility is useful for interactive scripts calling .Nm @@ -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 . The .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 and -.Ar modify +.Cm modify operations, and tells .Nm to output the result of the operation without updating the user or group