Module Name: src
Committed By: uwe
Date: Fri May 19 19:50:59 UTC 2023
Modified Files:
src/usr.bin/chflags: chflags.1
Log Message:
chflags(1): minor markup fixes
To generate a diff of this commit:
cvs rdiff -u -r1.27 -r1.28 src/usr.bin/chflags/chflags.1
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/usr.bin/chflags/chflags.1
diff -u src/usr.bin/chflags/chflags.1:1.27 src/usr.bin/chflags/chflags.1:1.28
--- src/usr.bin/chflags/chflags.1:1.27 Fri May 19 16:14:00 2023
+++ src/usr.bin/chflags/chflags.1 Fri May 19 19:50:59 2023
@@ -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.
