summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authormsi <bugcounterism@malbolge.net>2021-01-20 22:31:34 (GMT)
committermsi <bugcounterism@malbolge.net>2021-01-20 22:31:34 (GMT)
commitca8cef9587599a3fcb93852f9e573379ac56dafd (patch)
tree748c5587886aff46610b539204fa083793b86580 /doc
parent9038dae6fe99056c48f4f3c5afab6695bd982fc9 (diff)
parent0befd21328e7c588add11917de378e0915012ad3 (diff)
downloadtcl-ca8cef9587599a3fcb93852f9e573379ac56dafd.zip
tcl-ca8cef9587599a3fcb93852f9e573379ac56dafd.tar.gz
tcl-ca8cef9587599a3fcb93852f9e573379ac56dafd.tar.bz2
Improve [file attributes] documentation
Diffstat (limited to 'doc')
-rw-r--r--doc/file.n28
1 files changed, 14 insertions, 14 deletions
diff --git a/doc/file.n b/doc/file.n
index 1e9dcc9..0ea53f4 100644
--- a/doc/file.n
+++ b/doc/file.n
@@ -38,31 +38,31 @@ generated. On Windows, FAT file systems do not support access time.
.TP
\fBfile attributes \fIname\fR ?\fIoption value option value...\fR?
.
-This subcommand returns or sets platform specific values associated
-with a file. The first form returns a list of the platform specific
-flags and their values. The second form returns the value for the
-specific option. The third form sets one or more of the values. The
-values are as follows:
+This subcommand returns or sets platform-specific values associated
+with a file. The first form returns a list of the platform-specific
+options and their values. The second form returns the value for the
+given option. The third form sets one or more of the values. The values
+are as follows:
.RS
.PP
On Unix, \fB\-group\fR gets or sets the group name for the file. A
group id can be given to the command, but it returns a group name.
\fB\-owner\fR gets or sets the user name of the owner of the file. The
command returns the owner name, but the numerical id can be passed when
-setting the owner. \fB\-permissions\fR retrieves or sets a file's access
-permissions, using octal notation by default. This option also provides
-limited support for setting permissions using the symbolic notation
-accepted by the \fBchmod\fR command, following the form
+setting the owner. \fB\-permissions\fR retrieves or sets a file's
+access permissions, using octal notation by default. This option also
+provides limited support for setting permissions using the symbolic
+notation accepted by the \fBchmod\fR command, following the form
[\fBugo\fR]?[[\fB+-=\fR][\fBrwxst\fR]\fB,\fR[...]]. Multiple permission
specifications may be given, separated by commas. E.g., \fBu+s,go-rw\fR
would set the setuid bit for a file's owner as well as remove read and
write permission for the file's group and other users. An
\fBls\fR-style string of the form \fBrwxrwxrwx\fR is also accepted but
-must always be 9 characters long. E.g., \fBrwxr-xr-t\fR is equivalent to
-\fB01755\fR. On versions of Unix supporting file flags, \fB-readonly\fR
-returns the value of, or sets, or clears the readonly attribute of a
-file, i.e., the user immutable flag (\fBuchg\fR) to the \fBchflags\fR
-command.
+must always be 9 characters long. E.g., \fBrwxr-xr-t\fR is equivalent
+to \fB01755\fR. On versions of Unix supporting file flags,
+\fB-readonly\fR returns the value of, or sets, or clears the readonly
+attribute of a file, i.e., the user immutable flag (\fBuchg\fR) to the
+\fBchflags\fR command.
.PP
On Windows, \fB\-archive\fR gives the value or sets or clears the
archive attribute of the file. \fB\-hidden\fR gives the value or sets