---- coreutils-8.9/doc/coreutils.texi.orig 2011-01-01 22:19:23.000000000 +0100
-+++ coreutils-8.9/doc/coreutils.texi 2011-01-09 12:28:09.837901529 +0100
-@@ -20,119 +20,111 @@
+--- coreutils-8.21/doc/coreutils.texi.orig 2013-02-11 10:37:28.000000000 +0100
++++ coreutils-8.21/doc/coreutils.texi 2013-02-24 17:41:00.409391351 +0100
+@@ -20,120 +20,109 @@
+@dircategory Core utilities:
@direntry
-* Coreutils: (coreutils). Core GNU (file, text, shell) utilities.
+@dircategory Core utilities:
@direntry
-* Coreutils: (coreutils). Core GNU (file, text, shell) utilities.
+* File permissions: (coreutils)File permissions. Access modes
* Date input formats: (coreutils)Date input formats.
-@end direntry
+* File permissions: (coreutils)File permissions. Access modes
* Date input formats: (coreutils)Date input formats.
-@end direntry
-* cat: (coreutils)cat invocation. Concatenate and write files.
-* chcon: (coreutils)chcon invocation. Change SELinux CTX of files.
-* chgrp: (coreutils)chgrp invocation. Change file groups.
-* cat: (coreutils)cat invocation. Concatenate and write files.
-* chcon: (coreutils)chcon invocation. Change SELinux CTX of files.
-* chgrp: (coreutils)chgrp invocation. Change file groups.
--* chmod: (coreutils)chmod invocation. Change file permissions.
--* chown: (coreutils)chown invocation. Change file owners/groups.
+-* chmod: (coreutils)chmod invocation. Change access permissions.
+-* chown: (coreutils)chown invocation. Change file owners and groups.
-* chroot: (coreutils)chroot invocation. Specify the root directory.
-* cksum: (coreutils)cksum invocation. Print POSIX CRC checksum.
-* comm: (coreutils)comm invocation. Compare sorted files by line.
-* chroot: (coreutils)chroot invocation. Specify the root directory.
-* cksum: (coreutils)cksum invocation. Print POSIX CRC checksum.
-* comm: (coreutils)comm invocation. Compare sorted files by line.
-* nl: (coreutils)nl invocation. Number lines and write files.
-* nohup: (coreutils)nohup invocation. Immunize to hangups.
-* nproc: (coreutils)nproc invocation. Print the number of processors.
-* nl: (coreutils)nl invocation. Number lines and write files.
-* nohup: (coreutils)nohup invocation. Immunize to hangups.
-* nproc: (coreutils)nproc invocation. Print the number of processors.
-* od: (coreutils)od invocation. Dump files in octal, etc.
-* paste: (coreutils)paste invocation. Merge lines of files.
-* pathchk: (coreutils)pathchk invocation. Check file name portability.
-* od: (coreutils)od invocation. Dump files in octal, etc.
-* paste: (coreutils)paste invocation. Merge lines of files.
-* pathchk: (coreutils)pathchk invocation. Check file name portability.
-* stat: (coreutils)stat invocation. Report file(system) status.
-* stdbuf: (coreutils)stdbuf invocation. Modify stdio buffering.
-* stty: (coreutils)stty invocation. Print/change terminal settings.
-* stat: (coreutils)stat invocation. Report file(system) status.
-* stdbuf: (coreutils)stdbuf invocation. Modify stdio buffering.
-* stty: (coreutils)stty invocation. Print/change terminal settings.
-* sum: (coreutils)sum invocation. Print traditional checksum.
-* sync: (coreutils)sync invocation. Synchronize memory and disk.
-* tac: (coreutils)tac invocation. Reverse files.
-* sum: (coreutils)sum invocation. Print traditional checksum.
-* sync: (coreutils)sync invocation. Synchronize memory and disk.
-* tac: (coreutils)tac invocation. Reverse files.
+* cat: (coreutils)cat. Concatenate and write files
+* chcon: (coreutils)chcon. Change SELinux CTX of files
+* chgrp: (coreutils)chgrp. Change file groups
+* cat: (coreutils)cat. Concatenate and write files
+* chcon: (coreutils)chcon. Change SELinux CTX of files
+* chgrp: (coreutils)chgrp. Change file groups
-+* chmod: (coreutils)chmod. Change file permissions
-+* chown: (coreutils)chown. Change file owners/groups
++* chmod: (coreutils)chmod. Change access permissions
++* chown: (coreutils)chown. Change file owners and groups
+* chroot: (coreutils)chroot. Specify the root directory
+* cksum: (coreutils)cksum. Print POSIX CRC checksum
+* comm: (coreutils)comm. Compare sorted files by line
+* chroot: (coreutils)chroot. Specify the root directory
+* cksum: (coreutils)cksum. Print POSIX CRC checksum
+* comm: (coreutils)comm. Compare sorted files by line
+* groups: (coreutils)groups. Print group names a user is in
+* head: (coreutils)head. Output the first part of files
+* hostid: (coreutils)hostid. Print numeric host identifier
+* groups: (coreutils)groups. Print group names a user is in
+* head: (coreutils)head. Output the first part of files
+* hostid: (coreutils)hostid. Print numeric host identifier
+* id: (coreutils)id. Print user identity
+* install: (coreutils)install. Copy and change attributes
+* join: (coreutils)join. Join lines on a common field
+* id: (coreutils)id. Print user identity
+* install: (coreutils)install. Copy and change attributes
+* join: (coreutils)join. Join lines on a common field
+* link: (coreutils)link. Make hard links between files
+* ln: (coreutils)ln. Make links between files
+* logname: (coreutils)logname. Print current login name
+* link: (coreutils)link. Make hard links between files
+* ln: (coreutils)ln. Make links between files
+* logname: (coreutils)logname. Print current login name
+* nl: (coreutils)nl. Number lines and write files
+* nohup: (coreutils)nohup. Immunize to hangups
+* nproc: (coreutils)nproc. Print the number of processors
+* nl: (coreutils)nl. Number lines and write files
+* nohup: (coreutils)nohup. Immunize to hangups
+* nproc: (coreutils)nproc. Print the number of processors
+* od: (coreutils)od. Dump files in octal, etc.
+* paste: (coreutils)paste. Merge lines of files
+* pathchk: (coreutils)pathchk. Check file name portability
+* od: (coreutils)od. Dump files in octal, etc.
+* paste: (coreutils)paste. Merge lines of files
+* pathchk: (coreutils)pathchk. Check file name portability
+* ptx: (coreutils)ptx. Produce permuted indexes
+* pwd: (coreutils)pwd. Print working directory
+* readlink: (coreutils)readlink. Print referent of a symlink
+* ptx: (coreutils)ptx. Produce permuted indexes
+* pwd: (coreutils)pwd. Print working directory
+* readlink: (coreutils)readlink. Print referent of a symlink
+* rm: (coreutils)rm. Remove files
+* rmdir: (coreutils)rmdir. Remove empty directories
+* runcon: (coreutils)runcon. Run in specified SELinux CTX
+* rm: (coreutils)rm. Remove files
+* rmdir: (coreutils)rmdir. Remove empty directories
+* runcon: (coreutils)runcon. Run in specified SELinux CTX
+* stat: (coreutils)stat. Report file(system) status
+* stdbuf: (coreutils)stdbuf. Modify stdio buffering
+* stty: (coreutils)stty. Print/change terminal settings
+* stat: (coreutils)stat. Report file(system) status
+* stdbuf: (coreutils)stdbuf. Modify stdio buffering
+* stty: (coreutils)stty. Print/change terminal settings
+* sum: (coreutils)sum. Print traditional checksum
+* sync: (coreutils)sync. Synchronize memory and disk
+* tac: (coreutils)tac. Reverse files
+* sum: (coreutils)sum. Print traditional checksum
+* sync: (coreutils)sync. Synchronize memory and disk
+* tac: (coreutils)tac. Reverse files
+* unexpand: (coreutils)unexpand. Convert spaces to tabs
+* uniq: (coreutils)uniq. Uniquify files
+* unlink: (coreutils)unlink. Removal via unlink(2)
+* unexpand: (coreutils)unexpand. Convert spaces to tabs
+* uniq: (coreutils)uniq. Uniquify files
+* unlink: (coreutils)unlink. Removal via unlink(2)
+* users: (coreutils)users. Print current user names
+* vdir: (coreutils)vdir. List directories verbosely
+* wc: (coreutils)wc. Line, word, and byte counts
+* users: (coreutils)users. Print current user names
+* vdir: (coreutils)vdir. List directories verbosely
+* wc: (coreutils)wc. Line, word, and byte counts
* Working context:: pwd stty printenv tty
* User information:: id logname whoami groups users who
-* System context:: date arch nproc uname hostname hostid uptime
+* System context:: date arch nproc uname hostid
* SELinux context:: chcon runcon
* Working context:: pwd stty printenv tty
* User information:: id logname whoami groups users who
-* System context:: date arch nproc uname hostname hostid uptime
+* System context:: date arch nproc uname hostid
* SELinux context:: chcon runcon
-* Process control:: kill
* Delaying:: sleep
* Numeric operations:: factor seq
* File permissions:: Access modes
-* Process control:: kill
* Delaying:: sleep
* Numeric operations:: factor seq
* File permissions:: Access modes
-* pr invocation:: Paginate or columnate files for printing
-* fold invocation:: Wrap input lines to fit in specified width
+* fmt:: Reformat paragraph text
-* pr invocation:: Paginate or columnate files for printing
-* fold invocation:: Wrap input lines to fit in specified width
+* fmt:: Reformat paragraph text
+* pr:: Paginate or columnate files for printing
+* fold:: Wrap input lines to fit in specified width
+* pr:: Paginate or columnate files for printing
+* fold:: Wrap input lines to fit in specified width
-* nice invocation:: Run a command with modified niceness
-* nohup invocation:: Run a command immune to hangups
-* stdbuf invocation:: Run a command with modified I/O buffering
-* nice invocation:: Run a command with modified niceness
-* nohup invocation:: Run a command immune to hangups
-* stdbuf invocation:: Run a command with modified I/O buffering
+* nice:: Run a command with modified niceness
+* nohup:: Run a command immune to hangups
+* stdbuf:: Run a command with modified I/O buffering
+* nice:: Run a command with modified niceness
+* nohup:: Run a command immune to hangups
+* stdbuf:: Run a command with modified I/O buffering
-* pr invocation:: Paginate or columnate files for printing.
-* fold invocation:: Wrap input lines to fit in specified width.
+* fmt:: Reformat paragraph text.
-* pr invocation:: Paginate or columnate files for printing.
-* fold invocation:: Wrap input lines to fit in specified width.
+* fmt:: Reformat paragraph text.
+* pr:: Paginate or columnate files for printing.
+* fold:: Wrap input lines to fit in specified width.
@end menu
+* pr:: Paginate or columnate files for printing.
+* fold:: Wrap input lines to fit in specified width.
@end menu
--for the command @samp{date +@var{format}}; @xref{date invocation}.
-+for the command @samp{date +@var{format}}; @xref{date}.
+-for the command @samp{date +@var{format}}. @xref{date invocation}.
++for the command @samp{date +@var{format}}. @xref{date}.
Except for directives, which start with
@samp{%}, characters in @var{format} are printed unchanged. You can use
this option to specify an arbitrary string in place of the header date,
Except for directives, which start with
@samp{%}, characters in @var{format} are printed unchanged. You can use
this option to specify an arbitrary string in place of the header date,
@command{sha1sum} computes a 160-bit checksum for each specified
@var{file}. The usage and options of this command are precisely the
@command{sha1sum} computes a 160-bit checksum for each specified
@var{file}. The usage and options of this command are precisely the
Note: The SHA-1 digest is more secure than MD5, and no collisions of
it are known (different files having the same fingerprint). However,
Note: The SHA-1 digest is more secure than MD5, and no collisions of
it are known (different files having the same fingerprint). However,
various lengths (respectively 224, 256, 384 and 512 bits),
collectively known as the SHA-2 hashes. The usage and options of
these commands are precisely the same as for @command{md5sum}.
various lengths (respectively 224, 256, 384 and 512 bits),
collectively known as the SHA-2 hashes. The usage and options of
these commands are precisely the same as for @command{md5sum}.
Note: The SHA384 and SHA512 digests are considerably slower to
compute, especially on 32-bit computers, than SHA224 or SHA256.
Note: The SHA384 and SHA512 digests are considerably slower to
compute, especially on 32-bit computers, than SHA224 or SHA256.
Sort by hashing the input keys and then sorting the hash values.
Choose the hash function at random, ensuring that it is free of
collisions so that differing keys have differing hash values. This is
Sort by hashing the input keys and then sorting the hash values.
Choose the hash function at random, ensuring that it is free of
collisions so that differing keys have differing hash values. This is
except that keys with the same value sort together.
If multiple random sort fields are specified, the same random hash
except that keys with the same value sort together.
If multiple random sort fields are specified, the same random hash
@var{n} is set to the number of available processors, but limited
to 8, as there are diminishing performance gains after that.
Note also that using @var{n} threads increases the memory usage by
@var{n} is set to the number of available processors, but limited
to 8, as there are diminishing performance gains after that.
Note also that using @var{n} threads increases the memory usage by
this equivalence does not extend to arbitrary @command{sort} options.
For example, @code{sort -n -u} inspects only the value of the initial
numeric string when checking for uniqueness, whereas @code{sort -n |
this equivalence does not extend to arbitrary @command{sort} options.
For example, @code{sort -n -u} inspects only the value of the initial
numeric string when checking for uniqueness, whereas @code{sort -n |
The input need not be sorted, but repeated input lines are detected
only if they are adjacent. If you want to discard non-adjacent
duplicate lines, perhaps you want to use @code{sort -u}.
The input need not be sorted, but repeated input lines are detected
only if they are adjacent. If you want to discard non-adjacent
duplicate lines, perhaps you want to use @code{sort -u}.
For example, @option{--time-style="+%Y-%m-%d %H:%M:%S"} causes
@command{ls} to list timestamps like @samp{2002-03-30 23:45:56}. As
with @command{date}, @var{format}'s interpretation is affected by the
For example, @option{--time-style="+%Y-%m-%d %H:%M:%S"} causes
@command{ls} to list timestamps like @samp{2002-03-30 23:45:56}. As
with @command{date}, @var{format}'s interpretation is affected by the
-b}; that is, by default files are listed in columns, sorted vertically,
and special characters are represented by backslash escape sequences.
-b}; that is, by default files are listed in columns, sorted vertically,
and special characters are represented by backslash escape sequences.
-b}; that is, by default files are listed in long format and special
characters are represented by backslash escape sequences.
-b}; that is, by default files are listed in long format and special
characters are represented by backslash escape sequences.
@command{shred} overwrites devices or files, to help prevent even
very expensive hardware from recovering the data.
@command{shred} overwrites devices or files, to help prevent even
very expensive hardware from recovering the data.
not actually destroyed. Only the index listing where the file is
stored is destroyed, and the storage is made available for reuse.
There are undelete utilities that will attempt to reconstruct the index
not actually destroyed. Only the index listing where the file is
stored is destroyed, and the storage is made available for reuse.
There are undelete utilities that will attempt to reconstruct the index
(FIFOs), symbolic links, sockets, and so-called @dfn{special files}.
@menu
(FIFOs), symbolic links, sockets, and so-called @dfn{special files}.
@menu
@code{link} function. @xref{Hard Links, , , libc,
The GNU C Library Reference Manual}.
It avoids the bells and whistles of the more commonly-used
@code{link} function. @xref{Hard Links, , , libc,
The GNU C Library Reference Manual}.
It avoids the bells and whistles of the more commonly-used
+@@ -9760,7 +9742,7 @@
+ '/tmp/file' -> '../a/file'
+ @end smallexample
+
+-@xref{realpath invocation}, which gives greater control
++@xref{realpath}, which gives greater control
+ over relative file name generation.
+
+ @item -s
+@@ -9824,7 +9806,7 @@
@code{unlink} function. @xref{Deleting Files, , , libc,
The GNU C Library Reference Manual}. Synopsis:
It avoids the bells and whistles of the more commonly-used
@code{unlink} function. @xref{Deleting Files, , , libc,
The GNU C Library Reference Manual}. Synopsis:
It avoids the bells and whistles of the more commonly-used
For example, @option{--time-style="+%Y-%m-%d %H:%M:%S"} causes
@command{du} to list timestamps like @samp{2002-03-30 23:45:56}. As
with @command{date}, @var{format}'s interpretation is affected by the
For example, @option{--time-style="+%Y-%m-%d %H:%M:%S"} causes
@command{du} to list timestamps like @samp{2002-03-30 23:45:56}. As
with @command{date}, @var{format}'s interpretation is affected by the
@var{string} contains a backslash or if the first argument is
@option{-n}. Portable programs can use the @command{printf} command
if they need to omit trailing newlines or output control characters or
@var{string} contains a backslash or if the first argument is
@option{-n}. Portable programs can use the @command{printf} command
if they need to omit trailing newlines or output control characters or
more secure and faster than a shell script implementation, and may safely
be used as a dummy shell for the purpose of disabling accounts.
more secure and faster than a shell script implementation, and may safely
be used as a dummy shell for the purpose of disabling accounts.
-@@ -12506,14 +12491,14 @@
+@@ -13314,7 +13296,7 @@
+ @end display
+
+
+-@node realpath invocation
++@node realpath
+ @section @command{realpath}: Print the resolved file name.
+
+ @pindex realpath
+@@ -13442,14 +13424,14 @@
-* nice invocation:: Modify niceness.
-* nohup invocation:: Immunize to hangups.
-* stdbuf invocation:: Modify buffering of standard streams.
-* nice invocation:: Modify niceness.
-* nohup invocation:: Immunize to hangups.
-* stdbuf invocation:: Modify buffering of standard streams.
-* timeout invocation:: Run with time limit.
+* chroot:: Modify the root directory.
+* env:: Modify environment variables.
+* nice:: Modify niceness.
+* nohup:: Immunize to hangups.
+* stdbuf:: Modify buffering of standard streams.
-* timeout invocation:: Run with time limit.
+* chroot:: Modify the root directory.
+* env:: Modify environment variables.
+* nice:: Modify niceness.
+* nohup:: Immunize to hangups.
+* stdbuf:: Modify buffering of standard streams.
-
-The first form of the @command{kill} command sends a signal to all
-@var{pid} arguments. The default signal to send if none is specified
-
-The first form of the @command{kill} command sends a signal to all
-@var{pid} arguments. The default signal to send if none is specified
-valid signal, but can be used to test whether the @var{pid} arguments
-specify processes to which a signal could be sent.
-
-valid signal, but can be used to test whether the @var{pid} arguments
-specify processes to which a signal could be sent.
-
-
-If a negative @var{pid} argument is desired as the first one, it
-should be preceded by @option{--}. However, as a common extension to
-
-If a negative @var{pid} argument is desired as the first one, it
-should be preceded by @option{--}. However, as a common extension to
-A @var{signal} may be a signal name like @samp{HUP}, or a signal
-number like @samp{1}, or an exit status of a process terminated by the
-signal. A signal name can be given in canonical form or prefixed by
-A @var{signal} may be a signal name like @samp{HUP}, or a signal
-number like @samp{1}, or an exit status of a process terminated by the
-signal. A signal name can be given in canonical form or prefixed by
--ambiguity with lower case option letters. For a list of supported
--signal names and numbers see @xref{Signal specifications}.
+-ambiguity with lower case option letters.
+-@xref{Signal specifications}, for a list of supported
+-signal names and numbers.