[src/trunk]: src/usr.bin/chflags chflags(1): minor markup fixes

[uwe <uwe%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/ceb1a044f03f
branches:  trunk
changeset: 375892:ceb1a044f03f
user:      uwe <uwe%NetBSD.org@localhost>
date:      Fri May 19 19:50:59 2023 +0000

description:
chflags(1): minor markup fixes

diffstat:

 usr.bin/chflags/chflags.1 |  43 +++++++++++++++++++++----------------------
 1 files changed, 21 insertions(+), 22 deletions(-)

diffs (92 lines):

diff -r 5ae30c848879 -r ceb1a044f03f usr.bin/chflags/chflags.1
--- a/usr.bin/chflags/chflags.1 Fri May 19 18:45:52 2023 +0000
+++ b/usr.bin/chflags/chflags.1 Fri May 19 19:50:59 2023 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: chflags.1,v 1.27 2023/05/19 16:14:00 jschauma Exp $
+.\"    $NetBSD: chflags.1,v 1.28 2023/05/19 19:50:59 uwe Exp $
 .\"
 .\" Copyright (c) 1989, 1990, 1993, 1994
 .\"    The Regents of the University of California.  All rights reserved.
@@ -57,7 +57,7 @@ as specified by the
 operand.
 .Pp
 The options are as follows:
-.Bl -tag -width Ds
+.Bl -tag -width Fl
 .It Fl d
 If the change requested would not alter the
 flags currently set for
@@ -67,12 +67,12 @@ then attempt no change operation.
 If the
 .Fl R
 option is specified, symbolic links on the command line are followed.
-(Symbolic links encountered in the tree traversal are not followed.)
+Symbolic links encountered in the tree traversal are not followed.
 .It Fl h
 If the
 .Ar file
 or a file encountered during directory traversal is a symbolic link,
-the file flags of the link itself is changed.
+the file flags of the link itself are changed.
 .It Fl L
 If the
 .Fl R
@@ -84,33 +84,32 @@ option is specified, no symbolic links a
 .It Fl R
 Change the file flags for the file hierarchies rooted
 in the
-.Ar files
+.Ar file\^ Ns s
 instead of just the
-.Ar files
+.Ar file\^ Ns s
 themselves.
 .El
 .Pp
 Flags are a comma separated list of keywords.
 The following keywords are currently defined:
-.Bl -column -offset indent "Keyword   " "system append-only" "Permission"
+.\" XXX: list the actual chflags(2) macro names
+.Bl -column -offset indent ".Sy Keyword" "system append-only"
 .It Sy Keyword Ta Sy Flag Ta Sy Permission
-.It arch Ta archived Ta super-user only
-.It opaque Ta opaque Ta owner or super-user
-.It nodump Ta nodump Ta owner or super-user
-.It sappnd Ta system append-only Ta super-user only
-.It schg Ta system immutable Ta super-user only
-.It uappnd Ta user append-only Ta owner or super-user
-.It uchg Ta user immutable Ta owner or super-user
+.It Li arch Ta archived Ta super-user only
+.It Li opaque Ta opaque Ta owner or super-user
+.It Li nodump Ta nodump Ta owner or super-user
+.It Li sappnd Ta system append-only Ta super-user only
+.It Li schg Ta system immutable Ta super-user only
+.It Li uappnd Ta user append-only Ta owner or super-user
+.It Li uchg Ta user immutable Ta owner or super-user
 .El
 .Pp
 Putting the letters
-.Dq no
-before an option causes the flag to be turned off.
-For example:
-.Bl -tag -offset indent -width "nouchg"
-.It nouchg
-the immutable bit should be cleared
-.El
+.Sq Cm no
+before a keyword causes the flag to be turned off.
+For example,
+.Li nouchg
+requests the immutable bit should be cleared.
 .Pp
 The
 .Fl H ,
@@ -138,7 +137,7 @@ devices to be changed except by the supe
 .Pp
 Note that the ability to clear certain flags is
 dependent on the current kernel
-.Em securelevel .
+.Va securelevel .
 See
 .Xr secmodel_securelevel 9
 for details.