coreutils doc patches inspired by Debian 5.2.1-2.

[Paul Eggert]

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