diff options
author | msi <bugcounterism@malbolge.net> | 2021-01-20 22:31:34 (GMT) |
---|---|---|
committer | msi <bugcounterism@malbolge.net> | 2021-01-20 22:31:34 (GMT) |
commit | ca8cef9587599a3fcb93852f9e573379ac56dafd (patch) | |
tree | 748c5587886aff46610b539204fa083793b86580 /doc | |
parent | 9038dae6fe99056c48f4f3c5afab6695bd982fc9 (diff) | |
parent | 0befd21328e7c588add11917de378e0915012ad3 (diff) | |
download | tcl-ca8cef9587599a3fcb93852f9e573379ac56dafd.zip tcl-ca8cef9587599a3fcb93852f9e573379ac56dafd.tar.gz tcl-ca8cef9587599a3fcb93852f9e573379ac56dafd.tar.bz2 |
Improve [file attributes] documentation
Diffstat (limited to 'doc')
-rw-r--r-- | doc/file.n | 28 |
1 files changed, 14 insertions, 14 deletions
@@ -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 |