[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
coreutils doc patches inspired by Debian 5.2.1-2.
From: |
Paul Eggert |
Subject: |
coreutils doc patches inspired by Debian 5.2.1-2. |
Date: |
Tue, 16 Nov 2004 12:32:32 -0800 |
User-agent: |
Gnus/5.1006 (Gnus v5.10.6) Emacs/21.3 (gnu/linux) |
I looked at the Debian 5.2.1-2 patches for the coreutils texinfo
documentation and was inspired to write the following patch. It uses
my own wording but addresses the Debian issues.
2004-11-16 Paul Eggert <address@hidden>
* coreutils.texi: Changes inspired by Debian coreutils 5.2.1-2.
(General output formatting): -x doesn't have an operand.
(Formatting the file names): Warn that even with -N unprintable
chars are still printed as '?' some times.
(rm invocation): Reword rm -d to note that it's sometimes useful
on non-directories.
(logname invocation, users invocation, who invocation):
The utmp and wtmp file names vary from system to system.
Index: doc/coreutils.texi
===================================================================
RCS file: /fetish/cu/doc/coreutils.texi,v
retrieving revision 1.226
diff -p -u -r1.226 coreutils.texi
--- doc/coreutils.texi 16 Nov 2004 07:48:36 -0000 1.226
+++ doc/coreutils.texi 16 Nov 2004 20:27:33 -0000
@@ -5900,7 +5900,7 @@ separated by @samp{, } (a comma and a sp
Append a character to each file name indicating the file type. This is
like @option{-F}, except that executables are not marked.
address@hidden -x @var{format}
address@hidden -x
@itemx --format=across
@itemx --format=horizontal
@opindex -x
@@ -6077,7 +6077,10 @@ backslash sequences like those used in C
@opindex -N
@opindex --literal
@opindex --quoting-style
-Do not quote file names.
+Do not quote file names. However, with @command{ls} nongraphic
+characters are still printed as question marks if the output is a
+terminal and you do not specify the @option{--show-control-chars}
+option.
@item -q
@itemx --hide-control-chars
@@ -7170,13 +7173,15 @@ The program accepts the following option
@cindex directories, removing with @code{unlink}
@findex unlink
@pindex fsck
-Attempt to remove directories using the @code{unlink} function rather than
-the @code{rmdir} function, and
-don't require a directory to be empty before trying to unlink it. This works
+Use the @code{unlink} function unconditionally rather than attempting
+to check whether the file is a directory and using @code{rmdir} if it
+is a directory. This can be useful on corrupted file systems where
address@hidden works even though other, file-checking functions fail.
+For directories, this works
only if you have appropriate privileges and if your operating system supports
@code{unlink} for directories. Because unlinking a directory causes any files
in the deleted directory to become unreferenced, it is wise to @command{fsck}
-the file system after doing this.
+the file system afterwards.
@item -f
@itemx --force
@@ -11095,12 +11100,11 @@ Print only the user id.
@cindex login name, printing
@cindex user name, printing
address@hidden /etc/utmp
@flindex utmp
-
address@hidden prints the calling user's name, as found in the file
address@hidden/etc/utmp}, and exits with a status of 0. If there is no
address@hidden/etc/utmp} entry for the calling process, @command{logname} prints
address@hidden prints the calling user's name, as found in a
+system-maintained file (often @file{/var/run/utmp} or
address@hidden/etc/utmp}), and exits with a status of 0. If there is no entry
+for the calling process, @command{logname} prints
an error message and exits with a status of 1.
The only options are @option{--help} and @option{--version}. @xref{Common
@@ -11167,11 +11171,12 @@ output. Synopsis:
users address@hidden
@end example
address@hidden /etc/utmp
address@hidden /etc/wtmp
address@hidden utmp
address@hidden wtmp
With no @var{file} argument, @command{users} extracts its information from
-the file @file{/etc/utmp}. If a file argument is given, @command{users}
-uses that file instead. A common choice is @file{/etc/wtmp}.
+a system-maintained file (often @file{/var/run/utmp} or
address@hidden/etc/utmp}). If a file argument is given, @command{users} uses
+that file instead. A common choice is @file{/var/log/wtmp}.
The only options are @option{--help} and @option{--version}. @xref{Common
options}.
@@ -11200,11 +11205,12 @@ If given no non-option arguments, @comma
information for each user currently logged on: login name, terminal
line, login time, and remote hostname or X display.
address@hidden /etc/utmp
address@hidden /etc/wtmp
address@hidden utmp
address@hidden wtmp
If given one non-option argument, @command{who} uses that instead of
address@hidden/etc/utmp} as the name of the file containing the record of
-users logged on. @file{/etc/wtmp} is commonly given as an argument
+a default system-maintained file (often @file{/var/run/utmp} or
address@hidden/etc/utmp}) as the name of the file containing the record of
+users logged on. @file{/var/log/wtmp} is commonly given as an argument
to @command{who} to look at who has previously logged on.
@opindex am i
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- coreutils doc patches inspired by Debian 5.2.1-2.,
Paul Eggert <=