- df

[packages/coreutils.git] / coreutils-info.patch
diff --git a/coreutils-info.patch b/coreutils-info.patch

index 848ab64532339f9ba2b8a95a13961c4fe646603a..6782eb18563624dd9822c7cfe4f9e84acf1ee68e 100644 (file)
--- a/coreutils-info.patch
+++ b/coreutils-info.patch
@@ -1,6 +1,7 @@
---- 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 @@
+diff -ruN coreutils-8.27.orig/doc/coreutils.texi coreutils-8.27/doc/coreutils.texi
+--- coreutils-8.27.orig/doc/coreutils.texi     2017-03-09 02:24:43.000000000 +0100
++++ coreutils-8.27/doc/coreutils.texi  2017-06-10 21:44:38.201424527 +0200
+@@ -22,122 +22,114 @@
   @syncodeindex pg cp
   @syncodeindex vr cp
   
   @syncodeindex pg cp
   @syncodeindex vr cp
   
@@ -8,10 +9,9 @@
  +@dircategory Core utilities:
   @direntry
  -* Coreutils: (coreutils).       Core GNU (file, text, shell) utilities.
  +@dircategory Core utilities:
   @direntry
  -* Coreutils: (coreutils).       Core GNU (file, text, shell) utilities.
--* Common options: (coreutils)Common options.      Common options.
--* File permissions: (coreutils)File permissions.  Access modes.
  +* Coreutils: (coreutils).             Core GNU (file, text, shell) utilities
  +* Coreutils: (coreutils).             Core GNU (file, text, shell) utilities
-+* Common options: (coreutils)Common options.  Common options
+ * Common options: (coreutils)Common options.
+-* File permissions: (coreutils)File permissions.  Access modes.
  +* 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
@@ -23,13 +23,15 @@
  -@dircategory Individual utilities
  -@direntry
  -* arch: (coreutils)arch invocation.             Print machine hardware name.
  -@dircategory Individual utilities
  -@direntry
  -* arch: (coreutils)arch invocation.             Print machine hardware name.
+-* b2sum: (coreutils)b2sum invocation.           Print or check BLAKE2 digests.
+-* base32: (coreutils)base32 invocation.         Base32 encode/decode data.
  -* base64: (coreutils)base64 invocation.         Base64 encode/decode data.
  -* basename: (coreutils)basename invocation.     Strip directory and suffix.
  -* cat: (coreutils)cat invocation.               Concatenate and write files.
  -* chcon: (coreutils)chcon invocation.           Change SELinux CTX of files.
  -* chgrp: (coreutils)chgrp invocation.           Change file groups.
  -* base64: (coreutils)base64 invocation.         Base64 encode/decode data.
  -* basename: (coreutils)basename invocation.     Strip directory and suffix.
  -* 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.
@@ -56,7 +58,7 @@
  -* hostid: (coreutils)hostid invocation.         Print numeric host identifier.
  -* hostname: (coreutils)hostname invocation.     Print or set system name.
  -* id: (coreutils)id invocation.                 Print user identity.
  -* hostid: (coreutils)hostid invocation.         Print numeric host identifier.
  -* hostname: (coreutils)hostname invocation.     Print or set system name.
  -* id: (coreutils)id invocation.                 Print user identity.
--* install: (coreutils)install invocation.       Copy and change attributes.
+-* install: (coreutils)install invocation.       Copy files and set attributes.
  -* join: (coreutils)join invocation.             Join lines on a common field.
  -* kill: (coreutils)kill invocation.             Send a signal to processes.
  -* link: (coreutils)link invocation.             Make hard links between files.
  -* join: (coreutils)join invocation.             Join lines on a common field.
  -* kill: (coreutils)kill invocation.             Send a signal to processes.
  -* link: (coreutils)link invocation.             Make hard links between files.
@@ -73,6 +75,7 @@
  -* 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.
+-* numfmt: (coreutils)numfmt invocation.         Reformat numbers.
  -* 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.
@@ -82,6 +85,7 @@
  -* ptx: (coreutils)ptx invocation.               Produce permuted indexes.
  -* pwd: (coreutils)pwd invocation.               Print working directory.
  -* readlink: (coreutils)readlink invocation.     Print referent of a symlink.
  -* ptx: (coreutils)ptx invocation.               Produce permuted indexes.
  -* pwd: (coreutils)pwd invocation.               Print working directory.
  -* readlink: (coreutils)readlink invocation.     Print referent of a symlink.
+-* realpath: (coreutils)realpath invocation.     Print resolved file names.
  -* rm: (coreutils)rm invocation.                 Remove files.
  -* rmdir: (coreutils)rmdir invocation.           Remove empty directories.
  -* runcon: (coreutils)runcon invocation.         Run in specified SELinux CTX.
  -* rm: (coreutils)rm invocation.                 Remove files.
  -* rmdir: (coreutils)rmdir invocation.           Remove empty directories.
  -* runcon: (coreutils)runcon invocation.         Run in specified SELinux CTX.
@@ -96,9 +100,8 @@
  -* 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.
--* su: (coreutils)su invocation.                 Modify user and group ID.
  -* sum: (coreutils)sum invocation.               Print traditional checksum.
  -* sum: (coreutils)sum invocation.               Print traditional checksum.
--* sync: (coreutils)sync invocation.             Synchronize memory and disk.
+-* sync: (coreutils)sync invocation.             Synchronize memory to disk.
  -* tac: (coreutils)tac invocation.               Reverse files.
  -* tail: (coreutils)tail invocation.             Output the last part of files.
  -* tee: (coreutils)tee invocation.               Redirect to multiple files.
  -* tac: (coreutils)tac invocation.               Reverse files.
  -* tail: (coreutils)tail invocation.             Output the last part of files.
  -* tee: (coreutils)tee invocation.               Redirect to multiple files.
@@ -122,13 +125,15 @@
  -* whoami: (coreutils)whoami invocation.         Print effective user ID.
  -* yes: (coreutils)yes invocation.               Print a string indefinitely.
  +* arch: (coreutils)arch.              Print machine hardware name
  -* whoami: (coreutils)whoami invocation.         Print effective user ID.
  -* yes: (coreutils)yes invocation.               Print a string indefinitely.
  +* arch: (coreutils)arch.              Print machine hardware name
++* b2sum: (coreutils)b2sum.            Print or check BLAKE2 digests
++* base32: (coreutils)base32.          Base32 encode/decode data
  +* base64: (coreutils)base64.          Base64 encode/decode data
  +* basename: (coreutils)basename.      Strip directory and suffix
  +* cat: (coreutils)cat.                        Concatenate and write files
  +* chcon: (coreutils)chcon.            Change SELinux CTX of files
  +* chgrp: (coreutils)chgrp.            Change file groups
  +* base64: (coreutils)base64.          Base64 encode/decode data
  +* basename: (coreutils)basename.      Strip directory and suffix
  +* 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
@@ -155,7 +160,7 @@
  +* hostid: (coreutils)hostid.          Print numeric host identifier
  +* hostname: (coreutils)hostname.      Print or set system name
  +* id: (coreutils)id.                  Print user identity
  +* hostid: (coreutils)hostid.          Print numeric host identifier
  +* hostname: (coreutils)hostname.      Print or set system name
  +* id: (coreutils)id.                  Print user identity
-+* install: (coreutils)install.                Copy and change attributes
++* install: (coreutils)install.                Copy files and set attributes
  +* join: (coreutils)join.              Join lines on a common field
  +* kill: (coreutils)kill.              Send a signal to processes
  +* link: (coreutils)link.              Make hard links between files
  +* join: (coreutils)join.              Join lines on a common field
  +* kill: (coreutils)kill.              Send a signal to processes
  +* link: (coreutils)link.              Make hard links between files
@@ -172,7 +177,8 @@
  +* 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.
++* numfmt: (coreutils)numfmt.          Reformat numbers
++* od: (coreutils)od.                  Dump files in octal, etc
  +* paste: (coreutils)paste.            Merge lines of files
  +* pathchk: (coreutils)pathchk.                Check file name portability
  +* pr: (coreutils)pr.                  Paginate or columnate files
  +* paste: (coreutils)paste.            Merge lines of files
  +* pathchk: (coreutils)pathchk.                Check file name portability
  +* pr: (coreutils)pr.                  Paginate or columnate files
@@ -181,6 +187,7 @@
  +* 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
++* realpath: (coreutils)realpath.      Print resolved file names
  +* 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
@@ -195,9 +202,8 @@
  +* 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
-+* su: (coreutils)su.                  Modify user and group ID
  +* sum: (coreutils)sum.                        Print traditional checksum
  +* sum: (coreutils)sum.                        Print traditional checksum
-+* sync: (coreutils)sync.              Synchronize memory and disk
++* sync: (coreutils)sync.              Synchronize memory to disk
  +* tac: (coreutils)tac.                        Reverse files
  +* tail: (coreutils)tail.              Output the last part of files
  +* tee: (coreutils)tee.                        Redirect to multiple files
  +* tac: (coreutils)tac.                        Reverse files
  +* tail: (coreutils)tail.              Output the last part of files
  +* tee: (coreutils)tee.                        Redirect to multiple files
@@ -223,19 +229,19 @@
   @end direntry
   
   @copying
   @end direntry
   
   @copying
-@@ -197,10 +189,9 @@
- * File name manipulation::       dirname basename pathchk mktemp
+@@ -202,10 +194,9 @@
+ * File name manipulation::       dirname basename pathchk mktemp realpath
   * 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
- * Modified command invocation::  chroot env nice nohup stdbuf su timeout
+ * Modified command invocation::  chroot env nice nohup stdbuf timeout
  -* Process control::              kill
   * Delaying::                     sleep
  -* Process control::              kill
   * Delaying::                     sleep
- * Numeric operations::           factor seq
+ * Numeric operations::           factor numfmt seq
   * File permissions::             Access modes
   * File permissions::             Access modes
-@@ -228,42 +219,42 @@
+@@ -236,44 +227,44 @@
   
   Output of entire files
   
   
   Output of entire files
   
@@ -243,11 +249,13 @@
  -* tac invocation::               Concatenate and write files in reverse
  -* nl invocation::                Number lines and write files
  -* od invocation::                Write files in octal or other formats
  -* tac invocation::               Concatenate and write files in reverse
  -* nl invocation::                Number lines and write files
  -* od invocation::                Write files in octal or other formats
+-* base32 invocation::            Transform data into printable data
  -* base64 invocation::            Transform data into printable data
  +* cat::                          Concatenate and write files
  +* tac::                          Concatenate and write files in reverse
  +* nl::                           Number lines and write files
  +* od::                           Write files in octal or other formats
  -* base64 invocation::            Transform data into printable data
  +* cat::                          Concatenate and write files
  +* tac::                          Concatenate and write files in reverse
  +* nl::                           Number lines and write files
  +* od::                           Write files in octal or other formats
++* base32::                       Transform data into printable data
  +* base64::                       Transform data into printable data
   
   Formatting file contents
  +* base64::                       Transform data into printable data
   
   Formatting file contents
@@ -275,11 +283,13 @@
  -* wc invocation::                Print newline, word, and byte counts
  -* sum invocation::               Print checksum and block counts
  -* cksum invocation::             Print CRC checksum and byte counts
  -* wc invocation::                Print newline, word, and byte counts
  -* sum invocation::               Print checksum and block counts
  -* cksum invocation::             Print CRC checksum and byte counts
+-* b2sum invocation::             Print or check BLAKE2 digests
  -* md5sum invocation::            Print or check MD5 digests
  -* sha1sum invocation::           Print or check SHA-1 digests
  +* wc::                           Print newline, word, and byte counts
  +* sum::                          Print checksum and block counts
  +* cksum::                        Print CRC checksum and byte counts
  -* md5sum invocation::            Print or check MD5 digests
  -* sha1sum invocation::           Print or check SHA-1 digests
  +* wc::                           Print newline, word, and byte counts
  +* sum::                          Print checksum and block counts
  +* cksum::                        Print CRC checksum and byte counts
++* b2sum::                        Print or check BLAKE2 digests
  +* md5sum::                       Print or check MD5 digests
  +* sha1sum::                      Print or check SHA-1 digests
   * sha2 utilities::               Print or check SHA-2 digests
  +* md5sum::                       Print or check MD5 digests
  +* sha1sum::                      Print or check SHA-1 digests
   * sha2 utilities::               Print or check SHA-2 digests
@@ -301,7 +311,7 @@
   
   @command{ptx}: Produce permuted indexes
   
   
   @command{ptx}: Produce permuted indexes
   
-@@ -275,15 +266,15 @@
+@@ -285,15 +276,15 @@
   
   Operating on fields
   
   
   Operating on fields
   
@@ -323,7 +333,7 @@
   
   @command{tr}: Translate, squeeze, and/or delete characters
   
   
   @command{tr}: Translate, squeeze, and/or delete characters
   
-@@ -293,10 +284,10 @@
+@@ -303,10 +294,10 @@
   
   Directory listing
   
   
   Directory listing
   
@@ -338,7 +348,7 @@
   
   @command{ls}:  List directory contents
   
   
   @command{ls}:  List directory contents
   
-@@ -309,51 +300,51 @@
+@@ -319,51 +310,51 @@
   
   Basic operations
   
   
   Basic operations
   
@@ -390,12 +400,12 @@
  -* df invocation::                Report file system disk space usage
  -* du invocation::                Estimate file space usage
  -* stat invocation::              Report file or file system status
  -* df invocation::                Report file system disk space usage
  -* du invocation::                Estimate file space usage
  -* stat invocation::              Report file or file system status
--* sync invocation::              Synchronize data on disk with memory
+-* sync invocation::              Synchronize cached writes to persistent storage
  -* truncate invocation::          Shrink or extend the size of a file
  +* df::                           Report file system disk space usage
  +* du::                           Estimate file space usage
  +* stat::                         Report file or file system status
  -* truncate invocation::          Shrink or extend the size of a file
  +* df::                           Report file system disk space usage
  +* du::                           Estimate file space usage
  +* stat::                         Report file or file system status
-+* sync::                         Synchronize data on disk with memory
++* sync::                         Synchronize cached writes to persistent storage
  +* truncate::                     Shrink or extend the size of a file
   
   Printing text
  +* truncate::                     Shrink or extend the size of a file
   
   Printing text
@@ -420,7 +430,7 @@
   
   @command{test}: Check file types and compare values
   
   
   @command{test}: Check file types and compare values
   
-@@ -372,21 +363,21 @@
+@@ -382,22 +373,22 @@
   
   Redirection
   
   
   Redirection
   
@@ -433,10 +443,12 @@
  -* dirname invocation::           Strip last file name component
  -* pathchk invocation::           Check file name validity and portability
  -* mktemp invocation::            Create temporary file or directory
  -* dirname invocation::           Strip last file name component
  -* pathchk invocation::           Check file name validity and portability
  -* mktemp invocation::            Create temporary file or directory
+-* realpath invocation::          Print resolved file names
  +* basename::                     Strip directory and suffix from a file name
  +* dirname::                      Strip last file name component
  +* pathchk::                      Check file name validity and portability
  +* mktemp::                       Create temporary file or directory
  +* basename::                     Strip directory and suffix from a file name
  +* dirname::                      Strip last file name component
  +* pathchk::                      Check file name validity and portability
  +* mktemp::                       Create temporary file or directory
++* realpath::                     Print resolved file names
   
   Working context
   
   
   Working context
   
@@ -451,7 +463,7 @@
   
   @command{stty}: Print or change terminal characteristics
   
   
   @command{stty}: Print or change terminal characteristics
   
-@@ -400,22 +391,20 @@
+@@ -411,22 +402,20 @@
   
   User information
   
   
   User information
   
@@ -485,7 +497,7 @@
   
   @command{date}: Print or set system date and time
   
   
   @command{date}: Print or set system date and time
   
-@@ -430,31 +419,27 @@
+@@ -441,31 +430,27 @@
   
   SELinux context
   
   
   SELinux context
   
@@ -501,7 +513,6 @@
  -* 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
--* su invocation::                Run a command with substitute user and group ID
  -* timeout invocation::           Run a command with a time limit
  -
  -Process control
  -* timeout invocation::           Run a command with a time limit
  -
  -Process control
@@ -512,7 +523,6 @@
  +* 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
-+* su::                           Run a command with substitute user and group ID
  +* timeout::                      Run a command with a time limit
   
   Delaying
  +* timeout::                      Run a command with a time limit
   
   Delaying
@@ -523,13 +533,15 @@
   Numeric operations
   
  -* factor invocation::            Print prime factors
   Numeric operations
   
  -* factor invocation::            Print prime factors
+-* numfmt invocation::            Reformat numbers
  -* seq invocation::               Print numeric sequences
  +* factor::                       Print prime factors
  -* seq invocation::               Print numeric sequences
  +* factor::                       Print prime factors
++* numfmt::                       Reformat numbers
  +* seq::                          Print numeric sequences
   
  +* seq::                          Print numeric sequences
   
- File permissions
   
   
-@@ -1443,14 +1428,14 @@
+ File timestamps
+@@ -1566,15 +1551,15 @@
   in some way.
   
   @menu
   in some way.
   
   @menu
@@ -537,11 +549,13 @@
  -* tac invocation::              Concatenate and write files in reverse.
  -* nl invocation::               Number lines and write files.
  -* od invocation::               Write files in octal or other formats.
  -* tac invocation::              Concatenate and write files in reverse.
  -* nl invocation::               Number lines and write files.
  -* od invocation::               Write files in octal or other formats.
+-* base32 invocation::           Transform data into printable data.
  -* base64 invocation::           Transform data into printable data.
  +* cat::                         Concatenate and write files.
  +* tac::                         Concatenate and write files in reverse.
  +* nl::                          Number lines and write files.
  +* od::                          Write files in octal or other formats.
  -* base64 invocation::           Transform data into printable data.
  +* cat::                         Concatenate and write files.
  +* tac::                         Concatenate and write files in reverse.
  +* nl::                          Number lines and write files.
  +* od::                          Write files in octal or other formats.
++* base32::                      Transform data into printable data.
  +* base64::                      Transform data into printable data.
   @end menu
   
  +* base64::                      Transform data into printable data.
   @end menu
   
@@ -550,7 +564,7 @@
   @section @command{cat}: Concatenate and write files
   
   @pindex cat
   @section @command{cat}: Concatenate and write files
   
   @pindex cat
-@@ -1550,7 +1535,7 @@
+@@ -1675,7 +1660,7 @@
   @end smallexample
   
   
   @end smallexample
   
   
@@ -559,8 +573,8 @@
   @section @command{tac}: Concatenate and write files in reverse
   
   @pindex tac
   @section @command{tac}: Concatenate and write files in reverse
   
   @pindex tac
-@@ -1599,7 +1584,7 @@
- @exitstatus
+@@ -1733,7 +1718,7 @@
+ @end example
   
   
  -@node nl invocation
   
   
  -@node nl invocation
@@ -568,7 +582,7 @@
   @section @command{nl}: Number lines and write files
   
   @pindex nl
   @section @command{nl}: Number lines and write files
   
   @pindex nl
-@@ -1762,7 +1747,7 @@
+@@ -1896,7 +1881,7 @@
   @exitstatus
   
   
   @exitstatus
   
   
@@ -577,16 +591,29 @@
   @section @command{od}: Write files in octal or other formats
   
   @pindex od
   @section @command{od}: Write files in octal or other formats
   
   @pindex od
-@@ -2016,7 +2001,7 @@
- 
+@@ -2162,7 +2147,7 @@
   @exitstatus
   
   @exitstatus
   
+ 
+-@node base32 invocation
++@node base32
+ @section @command{base32}: Transform data into printable data
+ 
+ @pindex base32
+@@ -2172,10 +2157,10 @@
+ into (or from) base32 encoded form.  The base32 encoded form uses
+ printable ASCII characters to represent binary data.
+ The usage and options of this command are precisely the
+-same as for @command{base64}.  @xref{base64 invocation}.
++same as for @command{base64}.  @xref{base64}.
+ 
+ 
  -@node base64 invocation
  +@node base64
   @section @command{base64}: Transform data into printable data
   
   @pindex base64
  -@node base64 invocation
  +@node base64
   @section @command{base64}: Transform data into printable data
   
   @pindex base64
-@@ -2084,13 +2069,13 @@
+@@ -2244,13 +2229,13 @@
   These commands reformat the contents of files.
   
   @menu
   These commands reformat the contents of files.
   
   @menu
@@ -604,25 +631,25 @@
   @section @command{fmt}: Reformat paragraph text
   
   @pindex fmt
   @section @command{fmt}: Reformat paragraph text
   
   @pindex fmt
-@@ -2189,7 +2174,7 @@
- @exitstatus
+@@ -2354,7 +2339,7 @@
   
   
+ @exitstatus
   
  -@node pr invocation
  +@node pr
   @section @command{pr}: Paginate or columnate files for printing
   
   @pindex pr
   
  -@node pr invocation
  +@node pr
   @section @command{pr}: Paginate or columnate files for printing
   
   @pindex pr
-@@ -2329,7 +2314,7 @@
+@@ -2464,7 +2449,7 @@
   @cindex time formats
   @cindex formatting times
   Format header dates using @var{format}, using the same conventions as
   @cindex time formats
   @cindex formatting times
   Format header dates using @var{format}, using the same conventions as
--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,
-@@ -2556,7 +2541,7 @@
+@@ -2694,7 +2679,7 @@
   @exitstatus
   
   
   @exitstatus
   
   
@@ -631,7 +658,7 @@
   @section @command{fold}: Wrap input lines to fit in specified width
   
   @pindex fold
   @section @command{fold}: Wrap input lines to fit in specified width
   
   @pindex fold
-@@ -2623,13 +2608,13 @@
+@@ -2761,13 +2746,13 @@
   These commands output pieces of the input.
   
   @menu
   These commands output pieces of the input.
   
   @menu
@@ -650,7 +677,7 @@
   @section @command{head}: Output the first part of files
   
   @pindex head
   @section @command{head}: Output the first part of files
   
   @pindex head
-@@ -2706,7 +2691,7 @@
+@@ -2846,7 +2831,7 @@
   @exitstatus
   
   
   @exitstatus
   
   
@@ -659,7 +686,7 @@
   @section @command{tail}: Output the last part of files
   
   @pindex tail
   @section @command{tail}: Output the last part of files
   
   @pindex tail
-@@ -2922,7 +2907,7 @@
+@@ -3097,7 +3082,7 @@
   @exitstatus
   
   
   @exitstatus
   
   
@@ -668,7 +695,7 @@
   @section @command{split}: Split a file into pieces.
   
   @pindex split
   @section @command{split}: Split a file into pieces.
   
   @pindex split
-@@ -3112,7 +3097,7 @@
+@@ -3346,7 +3331,7 @@
   @end example
   
   
   @end example
   
   
@@ -677,18 +704,20 @@
   @section @command{csplit}: Split a file into context-determined pieces
   
   @pindex csplit
   @section @command{csplit}: Split a file into context-determined pieces
   
   @pindex csplit
-@@ -3303,16 +3288,16 @@
+@@ -3562,17 +3547,17 @@
   contents of files.
   
   @menu
  -* wc invocation::               Print newline, word, and byte counts.
  -* sum invocation::              Print checksum and block counts.
  -* cksum invocation::            Print CRC checksum and byte counts.
   contents of files.
   
   @menu
  -* wc invocation::               Print newline, word, and byte counts.
  -* sum invocation::              Print checksum and block counts.
  -* cksum invocation::            Print CRC checksum and byte counts.
+-* b2sum invocation::            Print or check BLAKE2 digests.
  -* md5sum invocation::           Print or check MD5 digests.
  -* sha1sum invocation::          Print or check SHA-1 digests.
  +* wc::                          Print newline, word, and byte counts.
  +* sum::                         Print checksum and block counts.
  +* cksum::                       Print CRC checksum and byte counts.
  -* md5sum invocation::           Print or check MD5 digests.
  -* sha1sum invocation::          Print or check SHA-1 digests.
  +* wc::                          Print newline, word, and byte counts.
  +* sum::                         Print checksum and block counts.
  +* cksum::                       Print CRC checksum and byte counts.
++* b2sum::                       Print or check BLAKE2 digests.
  +* md5sum::                      Print or check MD5 digests.
  +* sha1sum::                     Print or check SHA-1 digests.
   * sha2 utilities::              Print or check SHA-2 digests.
  +* md5sum::                      Print or check MD5 digests.
  +* sha1sum::                     Print or check SHA-1 digests.
   * sha2 utilities::              Print or check SHA-2 digests.
@@ -700,7 +729,7 @@
   @section @command{wc}: Print newline, word, and byte counts
   
   @pindex wc
   @section @command{wc}: Print newline, word, and byte counts
   
   @pindex wc
-@@ -3430,7 +3415,7 @@
+@@ -3693,7 +3678,7 @@
   @exitstatus
   
   
   @exitstatus
   
   
@@ -709,7 +738,7 @@
   @section @command{sum}: Print checksum and block counts
   
   @pindex sum
   @section @command{sum}: Print checksum and block counts
   
   @pindex sum
-@@ -3481,7 +3466,7 @@
+@@ -3744,7 +3729,7 @@
   @exitstatus
   
   
   @exitstatus
   
   
@@ -718,16 +747,43 @@
   @section @command{cksum}: Print CRC checksum and byte counts
   
   @pindex cksum
   @section @command{cksum}: Print CRC checksum and byte counts
   
   @pindex cksum
-@@ -3515,7 +3500,7 @@
+@@ -3778,7 +3763,7 @@
   @exitstatus
   
   
   @exitstatus
   
   
+-@node b2sum invocation
++@node b2sum
+ @section @command{b2sum}: Print or check BLAKE2 digests
+ 
+ @pindex b2sum
+@@ -3790,7 +3775,7 @@
+ 
+ @command{b2sum} computes a 512-bit checksum for each specified
+ @var{file}.  The same usage and options as the @command{md5sum}
+-command are supported.  @xref{md5sum invocation}.
++command are supported.  @xref{md5sum}.
+ In addition @command{b2sum} supports the following options.
+ 
+ @table @samp
+@@ -3805,7 +3790,7 @@
+ as the length is automatically determined when checking.
+ @end table
+ 
  -@node md5sum invocation
  +@node md5sum
   @section @command{md5sum}: Print or check MD5 digests
   
   @pindex md5sum
  -@node md5sum invocation
  +@node md5sum
   @section @command{md5sum}: Print or check MD5 digests
   
   @pindex md5sum
-@@ -3643,7 +3628,7 @@
+@@ -3828,7 +3813,7 @@
+ to modify certain files, including digital certificates, so that they
+ appear valid when signed with an \hash\ digest.  For more secure hashes,
+ consider using SHA-2, or the newer @command{b2sum} command.
+-@xref{sha2 utilities}. @xref{b2sum invocation}.
++@xref{sha2 utilities}. @xref{b2sum}.
+ @end macro
+ @weakHash{MD5}
+ 
+@@ -3968,7 +3953,7 @@
   @exitstatus
   
   
   @exitstatus
   
   
@@ -736,25 +792,25 @@
   @section @command{sha1sum}: Print or check SHA-1 digests
   
   @pindex sha1sum
   @section @command{sha1sum}: Print or check SHA-1 digests
   
   @pindex sha1sum
-@@ -3655,7 +3640,7 @@
+@@ -3980,7 +3965,7 @@
   
   @command{sha1sum} computes a 160-bit checksum for each specified
   @var{file}.  The usage and options of this command are precisely the
  -same as for @command{md5sum}.  @xref{md5sum invocation}.
  +same as for @command{md5sum}.  @xref{md5sum}.
   
   
   @command{sha1sum} computes a 160-bit checksum for each specified
   @var{file}.  The usage and options of this command are precisely the
  -same as for @command{md5sum}.  @xref{md5sum invocation}.
  +same as for @command{md5sum}.  @xref{md5sum}.
   
- Note: The SHA-1 digest is more secure than MD5, and no collisions of
- it are known (different files having the same fingerprint).  However,
-@@ -3695,7 +3680,7 @@
- various lengths (respectively 224, 256, 384 and 512 bits),
+ @weakHash{SHA-1}
+ 
+@@ -4016,7 +4001,7 @@
   collectively known as the SHA-2 hashes.  The usage and options of
   collectively known as the SHA-2 hashes.  The usage and options of
- these commands are precisely the same as for @command{md5sum}.
+ these commands are precisely the same as for @command{md5sum}
+ and @command{sha1sum}.
  -@xref{md5sum invocation}.
  +@xref{md5sum}.
   
  -@xref{md5sum invocation}.
  +@xref{md5sum}.
   
- Note: The SHA384 and SHA512 digests are considerably slower to
- compute, especially on 32-bit computers, than SHA224 or SHA256.
-@@ -3710,16 +3695,16 @@
+ 
+ @node Operating on sorted files
+@@ -4028,16 +4013,16 @@
   These commands work with (or produce) sorted files.
   
   @menu
   These commands work with (or produce) sorted files.
   
   @menu
@@ -778,7 +834,7 @@
   @section @command{sort}: Sort text files
   
   @pindex sort
   @section @command{sort}: Sort text files
   
   @pindex sort
-@@ -4008,7 +3993,7 @@
+@@ -4327,7 +4312,7 @@
   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
@@ -787,7 +843,7 @@
   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
-@@ -4196,7 +4181,7 @@
+@@ -4525,7 +4510,7 @@
   @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
@@ -796,16 +852,16 @@
   
   @item -u
   @itemx --unique
   
   @item -u
   @itemx --unique
-@@ -4214,7 +4199,7 @@
+@@ -4543,7 +4528,7 @@
   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 |
  -uniq} inspects the entire line.  @xref{uniq invocation}.
  +uniq} inspects the entire line.  @xref{uniq}.
   
   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 |
  -uniq} inspects the entire line.  @xref{uniq invocation}.
  +uniq} inspects the entire line.  @xref{uniq}.
   
- @macro zeroTerminatedOption
- @item -z
-@@ -4437,7 +4422,7 @@
+ @optZeroTerminated
+ @macro newlineFieldSeparator
+@@ -4756,7 +4741,7 @@
   @end itemize
   
   
   @end itemize
   
   
@@ -814,7 +870,7 @@
   @section @command{shuf}: Shuffling text
   
   @pindex shuf
   @section @command{shuf}: Shuffling text
   
   @pindex shuf
-@@ -4567,7 +4552,7 @@
+@@ -4912,7 +4897,7 @@
   @exitstatus
   
   
   @exitstatus
   
   
@@ -823,7 +879,7 @@
   @section @command{uniq}: Uniquify files
   
   @pindex uniq
   @section @command{uniq}: Uniquify files
   
   @pindex uniq
-@@ -4589,7 +4574,7 @@
+@@ -4934,7 +4919,7 @@
   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}.
@@ -832,7 +888,7 @@
   
   @vindex LC_COLLATE
   Comparisons honor the rules specified by the @env{LC_COLLATE}
   
   @vindex LC_COLLATE
   Comparisons honor the rules specified by the @env{LC_COLLATE}
-@@ -4716,7 +4701,7 @@
+@@ -5099,7 +5084,7 @@
   @exitstatus
   
   
   @exitstatus
   
   
@@ -841,7 +897,7 @@
   @section @command{comm}: Compare two sorted files line by line
   
   @pindex comm
   @section @command{comm}: Compare two sorted files line by line
   
   @pindex comm
-@@ -4792,7 +4777,7 @@
+@@ -5214,7 +5199,7 @@
   
   @end table
   
   
   @end table
   
@@ -850,7 +906,7 @@
   @section @command{ptx}: Produce permuted indexes
   
   @pindex ptx
   @section @command{ptx}: Produce permuted indexes
   
   @pindex ptx
-@@ -5249,7 +5234,7 @@
+@@ -5703,7 +5688,7 @@
   @end itemize
   
   
   @end itemize
   
   
@@ -859,7 +915,7 @@
   @section @command{tsort}: Topological sort
   
   @pindex tsort
   @section @command{tsort}: Topological sort
   
   @pindex tsort
-@@ -5411,13 +5396,13 @@
+@@ -5865,13 +5850,13 @@
   @chapter Operating on fields
   
   @menu
   @chapter Operating on fields
   
   @menu
@@ -877,7 +933,7 @@
   @section @command{cut}: Print selected parts of lines
   
   @pindex cut
   @section @command{cut}: Print selected parts of lines
   
   @pindex cut
-@@ -5522,7 +5507,7 @@
+@@ -5996,7 +5981,7 @@
   @exitstatus
   
   
   @exitstatus
   
   
@@ -886,7 +942,7 @@
   @section @command{paste}: Merge lines of files
   
   @pindex paste
   @section @command{paste}: Merge lines of files
   
   @pindex paste
-@@ -5592,7 +5577,7 @@
+@@ -6094,7 +6079,7 @@
   @exitstatus
   
   
   @exitstatus
   
   
@@ -895,8 +951,8 @@
   @section @command{join}: Join lines on a common field
   
   @pindex join
   @section @command{join}: Join lines on a common field
   
   @pindex join
-@@ -5757,13 +5742,13 @@
- This commands operate on individual characters.
+@@ -6625,13 +6610,13 @@
+ These commands operate on individual characters.
   
   @menu
  -* tr invocation::               Translate, squeeze, and/or delete characters.
   
   @menu
  -* tr invocation::               Translate, squeeze, and/or delete characters.
@@ -913,7 +969,7 @@
   @section @command{tr}: Translate, squeeze, and/or delete characters
   
   @pindex tr
   @section @command{tr}: Translate, squeeze, and/or delete characters
   
   @pindex tr
-@@ -6142,7 +6127,7 @@
+@@ -7014,7 +6999,7 @@
   @end itemize
   
   
   @end itemize
   
   
@@ -922,7 +978,7 @@
   @section @command{expand}: Convert tabs to spaces
   
   @pindex expand
   @section @command{expand}: Convert tabs to spaces
   
   @pindex expand
-@@ -6195,7 +6180,7 @@
+@@ -7075,7 +7060,7 @@
   @exitstatus
   
   
   @exitstatus
   
   
@@ -931,7 +987,7 @@
   @section @command{unexpand}: Convert spaces to tabs
   
   @pindex unexpand
   @section @command{unexpand}: Convert spaces to tabs
   
   @pindex unexpand
-@@ -6256,14 +6241,14 @@
+@@ -7138,14 +7123,14 @@
   and @command{vdir}, which list information about files.
   
   @menu
   and @command{vdir}, which list information about files.
   
   @menu
@@ -951,7 +1007,7 @@
   @section @command{ls}: List directory contents
   
   @pindex ls
   @section @command{ls}: List directory contents
   
   @pindex ls
-@@ -7101,7 +7086,7 @@
+@@ -8014,7 +7999,7 @@
   @item +@var{format}
   @vindex LC_TIME
   List timestamps using @var{format}, where @var{format} is interpreted
   @item +@var{format}
   @vindex LC_TIME
   List timestamps using @var{format}, where @var{format} is interpreted
@@ -960,7 +1016,7 @@
   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
-@@ -7293,7 +7278,7 @@
+@@ -8215,7 +8200,7 @@
   @end table
   
   
   @end table
   
   
@@ -969,7 +1025,7 @@
   @section @command{dir}: Briefly list directory contents
   
   @pindex dir
   @section @command{dir}: Briefly list directory contents
   
   @pindex dir
-@@ -7303,10 +7288,10 @@
+@@ -8225,10 +8210,10 @@
   -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.
   
@@ -982,16 +1038,19 @@
   @section @command{vdir}: Verbosely list directory contents
   
   @pindex vdir
   @section @command{vdir}: Verbosely list directory contents
   
   @pindex vdir
-@@ -7316,7 +7301,7 @@
+@@ -8238,9 +8223,9 @@
   -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.
   
+-@xref{ls invocation, @command{ls}}.
++@xref{ls, @command{ls}}.
+ 
  -@node dircolors invocation
  +@node dircolors
   @section @command{dircolors}: Color setup for @command{ls}
   
   @pindex dircolors
  -@node dircolors invocation
  +@node dircolors
   @section @command{dircolors}: Color setup for @command{ls}
   
   @pindex dircolors
-@@ -7403,16 +7388,16 @@
+@@ -8327,16 +8312,16 @@
   copying, moving (renaming), and deleting (removing).
   
   @menu
   copying, moving (renaming), and deleting (removing).
   
   @menu
@@ -1015,7 +1074,7 @@
   @section @command{cp}: Copy files and directories
   
   @pindex cp
   @section @command{cp}: Copy files and directories
   
   @pindex cp
-@@ -7861,7 +7846,7 @@
+@@ -8818,7 +8803,7 @@
   @exitstatus
   
   
   @exitstatus
   
   
@@ -1024,7 +1083,7 @@
   @section @command{dd}: Convert and copy a file
   
   @pindex dd
   @section @command{dd}: Convert and copy a file
   
   @pindex dd
-@@ -8226,7 +8211,7 @@
+@@ -9340,7 +9325,7 @@
   @exitstatus
   
   
   @exitstatus
   
   
@@ -1033,7 +1092,7 @@
   @section @command{install}: Copy files and set attributes
   
   @pindex install
   @section @command{install}: Copy files and set attributes
   
   @pindex install
-@@ -8407,7 +8392,7 @@
+@@ -9522,7 +9507,7 @@
   @exitstatus
   
   
   @exitstatus
   
   
@@ -1042,7 +1101,7 @@
   @section @command{mv}: Move (rename) files
   
   @pindex mv
   @section @command{mv}: Move (rename) files
   
   @pindex mv
-@@ -8538,7 +8523,7 @@
+@@ -9666,7 +9651,7 @@
   @exitstatus
   
   
   @exitstatus
   
   
@@ -1051,7 +1110,7 @@
   @section @command{rm}: Remove files or directories
   
   @pindex rm
   @section @command{rm}: Remove files or directories
   
   @pindex rm
-@@ -8693,7 +8678,7 @@
+@@ -9829,7 +9814,7 @@
   @exitstatus
   
   
   @exitstatus
   
   
@@ -1060,7 +1119,7 @@
   @section @command{shred}: Remove files more securely
   
   @pindex shred
   @section @command{shred}: Remove files more securely
   
   @pindex shred
-@@ -8703,7 +8688,7 @@
+@@ -9839,7 +9824,7 @@
   @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.
   
@@ -1069,7 +1128,7 @@
   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
-@@ -8936,18 +8921,18 @@
+@@ -10099,18 +10084,18 @@
   (FIFOs), symbolic links, sockets, and so-called @dfn{special files}.
   
   @menu
   (FIFOs), symbolic links, sockets, and so-called @dfn{special files}.
   
   @menu
@@ -1081,14 +1140,14 @@
  -* readlink invocation::         Print value of a symlink or canonical file name.
  -* rmdir invocation::            Remove empty directories.
  -* unlink invocation::           Remove files via the unlink syscall
  -* readlink invocation::         Print value of a symlink or canonical file name.
  -* rmdir invocation::            Remove empty directories.
  -* unlink invocation::           Remove files via the unlink syscall
-+* link::                        Make a hard link via the link syscall
-+* ln::                          Make links between files.
-+* mkdir::                       Make directories.
-+* mkfifo::                      Make FIFOs (named pipes).
-+* mknod::                       Make block or character special files.
-+* readlink::                    Print value of a symlink or canonical file name.
-+* rmdir::                       Remove empty directories.
-+* unlink::                      Remove files via the unlink syscall
++* link::             Make a hard link via the link syscall
++* ln::               Make links between files.
++* mkdir::            Make directories.
++* mkfifo::           Make FIFOs (named pipes).
++* mknod::            Make block or character special files.
++* readlink::         Print value of a symlink or canonical file name.
++* rmdir::            Remove empty directories.
++* unlink::           Remove files via the unlink syscall
   @end menu
   
   
   @end menu
   
   
@@ -1097,7 +1156,7 @@
   @section @command{link}: Make a hard link via the link syscall
   
   @pindex link
   @section @command{link}: Make a hard link via the link syscall
   
   @pindex link
-@@ -8960,7 +8945,7 @@
+@@ -10123,7 +10108,7 @@
   @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
@@ -1106,7 +1165,7 @@
   Synopsis:
   
   @example
   Synopsis:
   
   @example
-@@ -8986,7 +8971,7 @@
+@@ -10149,7 +10134,7 @@
   @exitstatus
   
   
   @exitstatus
   
   
@@ -1115,7 +1174,16 @@
   @section @command{ln}: Make links between files
   
   @pindex ln
   @section @command{ln}: Make links between files
   
   @pindex ln
-@@ -9215,7 +9200,7 @@
+@@ -10335,7 +10320,7 @@
+ Relative symbolic links are generated based on their canonicalized
+ containing directory, and canonicalized targets.  I.e., all symbolic
+ links in these file names will be resolved.
+-@xref{realpath invocation}, which gives greater control
++@xref{realpath}, which gives greater control
+ over relative file name generation, as demonstrated in the following example:
+ 
+ @example
+@@ -10412,7 +10397,7 @@
   @end smallexample
   
   
   @end smallexample
   
   
@@ -1124,7 +1192,7 @@
   @section @command{mkdir}: Make directories
   
   @pindex mkdir
   @section @command{mkdir}: Make directories
   
   @pindex mkdir
-@@ -9294,7 +9279,7 @@
+@@ -10485,7 +10470,7 @@
   @exitstatus
   
   
   @exitstatus
   
   
@@ -1133,7 +1201,7 @@
   @section @command{mkfifo}: Make FIFOs (named pipes)
   
   @pindex mkfifo
   @section @command{mkfifo}: Make FIFOs (named pipes)
   
   @pindex mkfifo
-@@ -9341,7 +9326,7 @@
+@@ -10526,7 +10511,7 @@
   @exitstatus
   
   
   @exitstatus
   
   
@@ -1142,7 +1210,7 @@
   @section @command{mknod}: Make block or character special files
   
   @pindex mknod
   @section @command{mknod}: Make block or character special files
   
   @pindex mknod
-@@ -9424,7 +9409,7 @@
+@@ -10603,7 +10588,7 @@
   @exitstatus
   
   
   @exitstatus
   
   
@@ -1151,7 +1219,16 @@
   @section @command{readlink}: Print value of a symlink or canonical file name
   
   @pindex readlink
   @section @command{readlink}: Print value of a symlink or canonical file name
   
   @pindex readlink
-@@ -9520,7 +9505,7 @@
+@@ -10627,7 +10612,7 @@
+ @command{readlink} outputs the absolute name of the given files which contain
+ no @file{.}, @file{..} components nor any repeated separators
+ (@file{/}) or symbolic links.  Note the @command{realpath} command is the
+-preferred command to use for canonicalization.  @xref{realpath invocation}.
++preferred command to use for canonicalization.  @xref{realpath}.
+ 
+ @end table
+ 
+@@ -10702,7 +10687,7 @@
   @exitstatus
   
   
   @exitstatus
   
   
@@ -1160,7 +1237,7 @@
   @section @command{rmdir}: Remove empty directories
   
   @pindex rmdir
   @section @command{rmdir}: Remove empty directories
   
   @pindex rmdir
-@@ -9568,12 +9553,12 @@
+@@ -10750,12 +10735,12 @@
   
   @end table
   
   
   @end table
   
@@ -1175,7 +1252,7 @@
   @section @command{unlink}: Remove files via the unlink syscall
   
   @pindex unlink
   @section @command{unlink}: Remove files via the unlink syscall
   
   @pindex unlink
-@@ -9584,7 +9569,7 @@
+@@ -10766,7 +10751,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
@@ -1184,17 +1261,17 @@
   
   @example
   unlink @var{filename}
   
   @example
   unlink @var{filename}
-@@ -9618,14 +9603,14 @@
+@@ -10800,14 +10785,14 @@
   These commands change file attributes.
   
   @menu
   These commands change file attributes.
   
   @menu
+-* chown invocation::            Change file owners and groups.
  -* chgrp invocation::            Change file groups.
  -* chmod invocation::            Change access permissions.
  -* chgrp invocation::            Change file groups.
  -* chmod invocation::            Change access permissions.
--* chown invocation::            Change file owners and groups.
  -* touch invocation::            Change file timestamps.
  -* touch invocation::            Change file timestamps.
++* chown::                       Change file owners and groups.
  +* chgrp::                       Change file groups.
  +* chmod::                       Change access permissions.
  +* chgrp::                       Change file groups.
  +* chmod::                       Change access permissions.
-+* chown::                       Change file owners and groups.
  +* touch::                       Change file timestamps.
   @end menu
   
  +* touch::                       Change file timestamps.
   @end menu
   
@@ -1204,7 +1281,7 @@
   @section @command{chown}: Change file owner and group
   
   @pindex chown
   @section @command{chown}: Change file owner and group
   
   @pindex chown
-@@ -9843,7 +9828,7 @@
+@@ -11032,7 +11017,7 @@
   @end smallexample
   
   
   @end smallexample
   
   
@@ -1213,7 +1290,16 @@
   @section @command{chgrp}: Change group ownership
   
   @pindex chgrp
   @section @command{chgrp}: Change group ownership
   
   @pindex chgrp
-@@ -9966,7 +9951,7 @@
+@@ -11041,7 +11026,7 @@
+ 
+ @command{chgrp} changes the group ownership of each given @var{file}
+ to @var{group} (which can be either a group name or a numeric group ID)
+-or to the group of an existing reference file.  @xref{chown invocation}.
++or to the group of an existing reference file.  @xref{chown}.
+ Synopsis:
+ 
+ @example
+@@ -11158,7 +11143,7 @@
   @end smallexample
   
   
   @end smallexample
   
   
@@ -1222,7 +1308,7 @@
   @section @command{chmod}: Change access permissions
   
   @pindex chmod
   @section @command{chmod}: Change access permissions
   
   @pindex chmod
-@@ -10066,7 +10051,7 @@
+@@ -11258,7 +11243,7 @@
   @exitstatus
   
   
   @exitstatus
   
   
@@ -1231,19 +1317,19 @@
   @section @command{touch}: Change file timestamps
   
   @pindex touch
   @section @command{touch}: Change file timestamps
   
   @pindex touch
-@@ -10243,15 +10228,15 @@
+@@ -11432,15 +11417,15 @@
   file status information, and write buffers to disk.
   
   @menu
  -* df invocation::               Report file system disk space usage.
  -* du invocation::               Estimate file space usage.
  -* stat invocation::             Report file or file system status.
   file status information, and write buffers to disk.
   
   @menu
  -* df invocation::               Report file system disk space usage.
  -* du invocation::               Estimate file space usage.
  -* stat invocation::             Report file or file system status.
--* sync invocation::             Synchronize memory and disk.
+-* sync invocation::             Synchronize cached writes to persistent storage.
  -* truncate invocation::         Shrink or extend the size of a file.
  +* df::                          Report file system disk space usage.
  +* du::                          Estimate file space usage.
  +* stat::                        Report file or file system status.
  -* truncate invocation::         Shrink or extend the size of a file.
  +* df::                          Report file system disk space usage.
  +* du::                          Estimate file space usage.
  +* stat::                        Report file or file system status.
-+* sync::                        Synchronize memory and disk.
++* sync::                        Synchronize cached writes to persistent storage.
  +* truncate::                    Shrink or extend the size of a file.
   @end menu
   
  +* truncate::                    Shrink or extend the size of a file.
   @end menu
   
@@ -1253,8 +1339,8 @@
   @section @command{df}: Report file system disk space usage
   
   @pindex df
   @section @command{df}: Report file system disk space usage
   
   @pindex df
-@@ -10464,7 +10449,7 @@
- @samp{ext3} or @samp{reiserfs}.
+@@ -11748,7 +11733,7 @@
+ or @option{-x} is used together with a file name argument.
   
   
  -@node du invocation
   
   
  -@node du invocation
@@ -1262,7 +1348,7 @@
   @section @command{du}: Estimate file space usage
   
   @pindex du
   @section @command{du}: Estimate file space usage
   
   @pindex du
-@@ -10662,7 +10647,7 @@
+@@ -12005,7 +11990,7 @@
   @item +@var{format}
   @vindex LC_TIME
   List timestamps using @var{format}, where @var{format} is interpreted
   @item +@var{format}
   @vindex LC_TIME
   List timestamps using @var{format}, where @var{format} is interpreted
@@ -1271,7 +1357,7 @@
   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
-@@ -10730,7 +10715,7 @@
+@@ -12073,7 +12058,7 @@
   @exitstatus
   
   
   @exitstatus
   
   
@@ -1280,16 +1366,16 @@
   @section @command{stat}: Report file or file system status
   
   @pindex stat
   @section @command{stat}: Report file or file system status
   
   @pindex stat
-@@ -10914,7 +10899,7 @@
+@@ -12286,7 +12271,7 @@
   @exitstatus
   
   
  -@node sync invocation
  +@node sync
   @exitstatus
   
   
  -@node sync invocation
  +@node sync
- @section @command{sync}: Synchronize data on disk with memory
+ @section @command{sync}: Synchronize cached writes to persistent storage
   
   @pindex sync
   
   @pindex sync
-@@ -10941,7 +10926,7 @@
+@@ -12345,7 +12330,7 @@
   @exitstatus
   
   
   @exitstatus
   
   
@@ -1298,7 +1384,7 @@
   @section @command{truncate}: Shrink or extend the size of a file
   
   @pindex truncate
   @section @command{truncate}: Shrink or extend the size of a file
   
   @pindex truncate
-@@ -11017,13 +11002,13 @@
+@@ -12422,13 +12407,13 @@
   This section describes commands that display text strings.
   
   @menu
   This section describes commands that display text strings.
   
   @menu
@@ -1316,7 +1402,7 @@
   @section @command{echo}: Print a line of text
   
   @pindex echo
   @section @command{echo}: Print a line of text
   
   @pindex echo
-@@ -11110,12 +11095,12 @@
+@@ -12517,12 +12502,12 @@
   @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
@@ -1331,7 +1417,7 @@
   @section @command{printf}: Format and print data
   
   @pindex printf
   @section @command{printf}: Format and print data
   
   @pindex printf
-@@ -11264,7 +11249,7 @@
+@@ -12684,7 +12669,7 @@
   @exitstatus
   
   
   @exitstatus
   
   
@@ -1340,7 +1426,7 @@
   @section @command{yes}: Print a string until interrupted
   
   @pindex yes
   @section @command{yes}: Print a string until interrupted
   
   @pindex yes
-@@ -11295,14 +11280,14 @@
+@@ -12715,14 +12700,14 @@
   pipeline.
   
   @menu
   pipeline.
   
   @menu
@@ -1360,8 +1446,8 @@
   @section @command{false}: Do nothing, unsuccessfully
   
   @pindex false
   @section @command{false}: Do nothing, unsuccessfully
   
   @pindex false
-@@ -11332,7 +11317,7 @@
- non-@acronym{GNU} hosts.
+@@ -12752,7 +12737,7 @@
+ non-GNU hosts.
   
   
  -@node true invocation
   
   
  -@node true invocation
@@ -1369,7 +1455,7 @@
   @section @command{true}: Do nothing, successfully
   
   @pindex true
   @section @command{true}: Do nothing, successfully
   
   @pindex true
-@@ -11368,7 +11353,7 @@
+@@ -12788,7 +12773,7 @@
   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.
   
@@ -1378,7 +1464,7 @@
   @section @command{test}: Check file types and compare values
   
   @pindex test
   @section @command{test}: Check file types and compare values
   
   @pindex test
-@@ -11696,7 +11681,7 @@
+@@ -13151,7 +13136,7 @@
   @end table
   
   
   @end table
   
   
@@ -1387,7 +1473,7 @@
   @section @command{expr}: Evaluate expressions
   
   @pindex expr
   @section @command{expr}: Evaluate expressions
   
   @pindex expr
-@@ -11973,11 +11958,11 @@
+@@ -13428,11 +13413,11 @@
   it's described here.
   
   @menu
   it's described here.
   
   @menu
@@ -1401,7 +1487,7 @@
   @section @command{tee}: Redirect output to multiple files or processes
   
   @pindex tee
   @section @command{tee}: Redirect output to multiple files or processes
   
   @pindex tee
-@@ -12138,14 +12123,14 @@
+@@ -13639,15 +13624,15 @@
   This section describes commands that manipulate file names.
   
   @menu
   This section describes commands that manipulate file names.
   
   @menu
@@ -1409,10 +1495,12 @@
  -* dirname invocation::          Strip last file name component.
  -* pathchk invocation::          Check file name validity and portability.
  -* mktemp invocation::           Create temporary file or directory.
  -* dirname invocation::          Strip last file name component.
  -* pathchk invocation::          Check file name validity and portability.
  -* mktemp invocation::           Create temporary file or directory.
+-* realpath invocation::         Print resolved file names.
  +* basename::                    Strip directory and suffix from a file name.
  +* dirname::                     Strip last file name component.
  +* pathchk::                     Check file name validity and portability.
  +* mktemp::                      Create temporary file or directory.
  +* basename::                    Strip directory and suffix from a file name.
  +* dirname::                     Strip last file name component.
  +* pathchk::                     Check file name validity and portability.
  +* mktemp::                      Create temporary file or directory.
++* realpath::                    Print resolved file names.
   @end menu
   
   
   @end menu
   
   
@@ -1421,7 +1509,7 @@
   @section @command{basename}: Strip directory and suffix from a file name
   
   @pindex basename
   @section @command{basename}: Strip directory and suffix from a file name
   
   @pindex basename
-@@ -12199,7 +12184,7 @@
+@@ -13729,7 +13714,7 @@
   @end smallexample
   
   
   @end smallexample
   
   
@@ -1430,7 +1518,7 @@
   @section @command{dirname}: Strip last file name component
   
   @pindex dirname
   @section @command{dirname}: Strip last file name component
   
   @pindex dirname
-@@ -12244,7 +12229,7 @@
+@@ -13782,7 +13767,7 @@
   @end smallexample
   
   
   @end smallexample
   
   
@@ -1439,7 +1527,7 @@
   @section @command{pathchk}: Check file name validity and portability
   
   @pindex pathchk
   @section @command{pathchk}: Check file name validity and portability
   
   @pindex pathchk
-@@ -12320,7 +12305,7 @@
+@@ -13858,7 +13843,7 @@
   1 otherwise.
   @end display
   
   1 otherwise.
   @end display
   
@@ -1448,7 +1536,16 @@
   @section @command{mktemp}: Create temporary file or directory
   
   @pindex mktemp
   @section @command{mktemp}: Create temporary file or directory
   
   @pindex mktemp
-@@ -12506,14 +12491,14 @@
+@@ -14033,7 +14018,7 @@
+ @end display
+ 
+ 
+-@node realpath invocation
++@node realpath
+ @section @command{realpath}: Print the resolved file name.
+ 
+ @pindex realpath
+@@ -14162,14 +14147,14 @@
   so forth.  See also the user-related commands in the next section.
   
   @menu
   so forth.  See also the user-related commands in the next section.
   
   @menu
@@ -1468,7 +1565,7 @@
   @section @command{pwd}: Print working directory
   
   @pindex pwd
   @section @command{pwd}: Print working directory
   
   @pindex pwd
-@@ -12560,7 +12545,7 @@
+@@ -14216,7 +14201,7 @@
   @exitstatus
   
   
   @exitstatus
   
   
@@ -1477,7 +1574,7 @@
   @section @command{stty}: Print or change terminal characteristics
   
   @pindex stty
   @section @command{stty}: Print or change terminal characteristics
   
   @pindex stty
-@@ -13244,7 +13229,7 @@
+@@ -14958,7 +14943,7 @@
   @end table
   
   
   @end table
   
   
@@ -1486,7 +1583,7 @@
   @section @command{printenv}: Print all or some environment variables
   
   @pindex printenv
   @section @command{printenv}: Print all or some environment variables
   
   @pindex printenv
-@@ -13279,7 +13264,7 @@
+@@ -14993,7 +14978,7 @@
   @end display
   
   
   @end display
   
   
@@ -1495,7 +1592,7 @@
   @section @command{tty}: Print file name of terminal on standard input
   
   @pindex tty
   @section @command{tty}: Print file name of terminal on standard input
   
   @pindex tty
-@@ -13329,16 +13314,16 @@
+@@ -15043,16 +15028,16 @@
   logins, groups, and so forth.
   
   @menu
   logins, groups, and so forth.
   
   @menu
@@ -1519,16 +1616,16 @@
   @section @command{id}: Print user identity
   
   @pindex id
   @section @command{id}: Print user identity
   
   @pindex id
-@@ -13424,7 +13409,7 @@
- @end macro
- @primaryAndSupplementaryGroups{id,user argument}
+@@ -15156,7 +15141,7 @@
+ 
+ @exitstatus
   
  -@node logname invocation
  +@node logname
   @section @command{logname}: Print current login name
   
   @pindex logname
   
  -@node logname invocation
  +@node logname
   @section @command{logname}: Print current login name
   
   @pindex logname
-@@ -13445,7 +13430,7 @@
+@@ -15177,7 +15162,7 @@
   @exitstatus
   
   
   @exitstatus
   
   
@@ -1537,7 +1634,7 @@
   @section @command{whoami}: Print effective user ID
   
   @pindex whoami
   @section @command{whoami}: Print effective user ID
   
   @pindex whoami
-@@ -13461,7 +13446,7 @@
+@@ -15193,7 +15178,7 @@
   @exitstatus
   
   
   @exitstatus
   
   
@@ -1546,16 +1643,16 @@
   @section @command{groups}: Print group names a user is in
   
   @pindex groups
   @section @command{groups}: Print group names a user is in
   
   @pindex groups
-@@ -13489,7 +13474,7 @@
- @exitstatus
+@@ -15220,7 +15205,7 @@
   
   
+ @exitstatus
   
  -@node users invocation
  +@node users
   @section @command{users}: Print login names of users currently logged in
   
   @pindex users
   
  -@node users invocation
  +@node users
   @section @command{users}: Print login names of users currently logged in
   
   @pindex users
-@@ -13520,7 +13505,7 @@
+@@ -15255,7 +15240,7 @@
   @exitstatus
   
   
   @exitstatus
   
   
@@ -1564,7 +1661,7 @@
   @section @command{who}: Print who is currently logged in
   
   @pindex who
   @section @command{who}: Print who is currently logged in
   
   @pindex who
-@@ -13679,16 +13664,14 @@
+@@ -15418,16 +15403,14 @@
   information.
   
   @menu
   information.
   
   @menu
@@ -1575,11 +1672,11 @@
  -* hostname invocation::         Print or set system name.
  -* hostid invocation::           Print numeric host identifier.
  -* uptime invocation::           Print system uptime and load.
  -* hostname invocation::         Print or set system name.
  -* hostid invocation::           Print numeric host identifier.
  -* uptime invocation::           Print system uptime and load.
-+* date::                        Print or set system date and time.
-+* arch::                        Print machine hardware name.
-+* nproc::                       Print the number of processors.
-+* uname::                       Print system information.
-+* hostid::                      Print numeric host identifier.
++* date::             Print or set system date and time.
++* arch::             Print machine hardware name.
++* nproc::            Print the number of processors.
++* uname::            Print system information.
++* hostid::           Print numeric host identifier.
   @end menu
   
  -@node date invocation
   @end menu
   
  -@node date invocation
@@ -1587,7 +1684,7 @@
   @section @command{date}: Print or set system date and time
   
   @pindex date
   @section @command{date}: Print or set system date and time
   
   @pindex date
-@@ -14321,7 +14304,7 @@
+@@ -16137,7 +16120,7 @@
   @end itemize
   
   
   @end itemize
   
   
@@ -1596,7 +1693,7 @@
   @section @command{arch}: Print machine hardware name
   
   @pindex arch
   @section @command{arch}: Print machine hardware name
   
   @pindex arch
-@@ -14341,7 +14324,7 @@
+@@ -16160,7 +16143,7 @@
   @exitstatus
   
   
   @exitstatus
   
   
@@ -1605,7 +1702,7 @@
   @section @command{nproc}: Print the number of available processors
   
   @pindex nproc
   @section @command{nproc}: Print the number of available processors
   
   @pindex nproc
-@@ -14378,7 +14361,7 @@
+@@ -16199,7 +16182,7 @@
   @exitstatus
   
   
   @exitstatus
   
   
@@ -1614,7 +1711,7 @@
   @section @command{uname}: Print system information
   
   @pindex uname
   @section @command{uname}: Print system information
   
   @pindex uname
-@@ -14508,31 +14491,7 @@
+@@ -16329,35 +16312,7 @@
   @exitstatus
   
   
   @exitstatus
   
   
@@ -1639,6 +1736,10 @@
  -The only options are @option{--help} and @option{--version}.  @xref{Common
  -options}.
  -
  -The only options are @option{--help} and @option{--version}.  @xref{Common
  -options}.
  -
+-@command{hostname} is not installed by default, and other packages
+-also supply a @command{hostname} command, so portable scripts should
+-not rely on its existence or on the exact behavior documented above.
+-
  -@exitstatus
  -
  -
  -@exitstatus
  -
  -
@@ -1647,7 +1748,7 @@
   @section @command{hostid}: Print numeric host identifier
   
   @pindex hostid
   @section @command{hostid}: Print numeric host identifier
   
   @pindex hostid
-@@ -14556,37 +14515,6 @@
+@@ -16385,44 +16340,6 @@
   
   @exitstatus
   
   
   @exitstatus
   
@@ -1681,11 +1782,18 @@
  -also include processes in the uninterruptible sleep state (that is,
  -those processes which are waiting for disk I/O).  The Linux kernel
  -includes uninterruptible processes.
  -also include processes in the uninterruptible sleep state (that is,
  -those processes which are waiting for disk I/O).  The Linux kernel
  -includes uninterruptible processes.
+-
+-@command{uptime} is installed only on platforms with infrastructure
+-for obtaining the boot time, and other packages also supply an
+-@command{uptime} command, so portable scripts should not rely on its
+-existence or on the exact behavior documented above.
+-
+-@exitstatus
  -
   @node SELinux context
   @chapter SELinux context
   
  -
   @node SELinux context
   @chapter SELinux context
   
-@@ -14598,11 +14526,11 @@
+@@ -16434,11 +16351,11 @@
   contexts.
   
   @menu
   contexts.
   
   @menu
@@ -1700,7 +1808,7 @@
   @section @command{chcon}: Change SELinux context of file
   
   @pindex chcon
   @section @command{chcon}: Change SELinux context of file
   
   @pindex chcon
-@@ -14689,7 +14617,7 @@
+@@ -16541,7 +16458,7 @@
   
   @exitstatus
   
   
   @exitstatus
   
@@ -1709,7 +1817,7 @@
   @section @command{runcon}: Run a command in specified SELinux context
   
   @pindex runcon
   @section @command{runcon}: Run a command in specified SELinux context
   
   @pindex runcon
-@@ -14774,17 +14702,17 @@
+@@ -16626,16 +16543,16 @@
   user, etc.
   
   @menu
   user, etc.
   
   @menu
@@ -1718,14 +1826,12 @@
  -* 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.
--* su invocation::               Modify user and group ID.
  -* 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.
-+* su::                          Modify user and group ID.
  +* timeout::                     Run with time limit.
   @end menu
   
  +* timeout::                     Run with time limit.
   @end menu
   
@@ -1735,7 +1841,7 @@
   @section @command{chroot}: Run a command with a different root directory
   
   @pindex chroot
   @section @command{chroot}: Run a command with a different root directory
   
   @pindex chroot
-@@ -14872,7 +14800,7 @@
+@@ -16751,7 +16668,7 @@
   @end display
   
   
   @end display
   
   
@@ -1744,7 +1850,7 @@
   @section @command{env}: Run a command in a modified environment
   
   @pindex env
   @section @command{env}: Run a command in a modified environment
   
   @pindex env
-@@ -15022,7 +14950,7 @@
+@@ -16901,7 +16818,7 @@
   @end display
   
   
   @end display
   
   
@@ -1753,7 +1859,7 @@
   @section @command{nice}: Run a command with modified niceness
   
   @pindex nice
   @section @command{nice}: Run a command with modified niceness
   
   @pindex nice
-@@ -15145,7 +15073,7 @@
+@@ -17032,7 +16949,7 @@
   @end example
   
   
   @end example
   
   
@@ -1762,7 +1868,7 @@
   @section @command{nohup}: Run a command immune to hangups
   
   @pindex nohup
   @section @command{nohup}: Run a command immune to hangups
   
   @pindex nohup
-@@ -15218,7 +15146,7 @@
+@@ -17106,7 +17023,7 @@
   instead of 125.
   
   
   instead of 125.
   
   
@@ -1771,25 +1877,16 @@
   @section @command{stdbuf}: Run a command with modified I/O stream buffering
   
   @pindex stdbuf
   @section @command{stdbuf}: Run a command with modified I/O stream buffering
   
   @pindex stdbuf
-@@ -15297,7 +15225,7 @@
+@@ -17200,7 +17117,7 @@
   @end display
   
   
   @end display
   
   
--@node su invocation
-+@node su
- @section @command{su}: Run a command with substitute user and group ID
- 
- @pindex su
-@@ -15454,7 +15382,7 @@
- might find this idea strange at first.
- 
- 
  -@node timeout invocation
  +@node timeout
   @section @command{timeout}: Run a command with a time limit
   
   @pindex timeout
  -@node timeout invocation
  +@node timeout
   @section @command{timeout}: Run a command with a time limit
   
   @pindex timeout
-@@ -15515,89 +15443,6 @@
+@@ -17290,90 +17207,6 @@
   @end display
   
   
   @end display
   
   
@@ -1823,7 +1920,7 @@
  -
  -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
--is @samp{TERM}.  The special signal number @samp{0} does not denote a
+-is @samp{TERM}@.  The special signal number @samp{0} does not denote a
  -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.
  -
@@ -1841,7 +1938,7 @@
  -
  -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
--@acronym{POSIX}, @option{--} is not required with @samp{kill
+-POSIX, @option{--} is not required with @samp{kill
  --@var{signal} -@var{pid}}.  The following commands are equivalent:
  -
  -@example
  --@var{signal} -@var{pid}}.  The following commands are equivalent:
  -
  -@example
@@ -1871,15 +1968,16 @@
  -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
--@samp{SIG}.  The case of the letters is ignored, except for the
+-@samp{SIG}@.  The case of the letters is ignored, except for the
  -@option{-@var{signal}} option which must use upper case to avoid
  -@option{-@var{signal}} option which must use upper case to avoid
--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.
  -
   @node Delaying
   @chapter Delaying
   
  -
   @node Delaying
   @chapter Delaying
   
-@@ -15607,11 +15452,11 @@
+@@ -17383,11 +17216,11 @@
   @c Perhaps @command{wait} or other commands should be described here also?
   
   @menu
   @c Perhaps @command{wait} or other commands should be described here also?
   
   @menu
@@ -1893,13 +1991,15 @@
   @section @command{sleep}: Delay for a specified time
   
   @pindex sleep
   @section @command{sleep}: Delay for a specified time
   
   @pindex sleep
-@@ -15662,12 +15507,12 @@
+@@ -17437,13 +17270,13 @@
   These programs do numerically-related operations.
   
   @menu
  -* factor invocation::              Show factors of numbers.
   These programs do numerically-related operations.
   
   @menu
  -* factor invocation::              Show factors of numbers.
+-* numfmt invocation::              Reformat numbers.
  -* seq invocation::                 Print sequences of numbers.
  +* factor::                         Show factors of numbers.
  -* seq invocation::                 Print sequences of numbers.
  +* factor::                         Show factors of numbers.
++* numfmt::                         Reformat numbers.
  +* seq::                            Print sequences of numbers.
   @end menu
   
  +* seq::                            Print sequences of numbers.
   @end menu
   
@@ -1909,12 +2009,30 @@
   @section @command{factor}: Print prime factors
   
   @pindex factor
   @section @command{factor}: Print prime factors
   
   @pindex factor
-@@ -15723,7 +15568,7 @@
+@@ -17501,7 +17334,7 @@
   @exitstatus
   
   
   @exitstatus
   
   
+-@node numfmt invocation
++@node numfmt
+ @section @command{numfmt}: Reformat numbers
+ 
+ @pindex numfmt
+@@ -17841,7 +17674,7 @@
+ @end example
+ 
+ 
  -@node seq invocation
  +@node seq
   @section @command{seq}: Print numeric sequences
   
   @pindex seq
  -@node seq invocation
  +@node seq
   @section @command{seq}: Print numeric sequences
   
   @pindex seq
+@@ -18012,7 +17845,7 @@
+ whenever you read, write, or change the attributes of the file
+ respectively, and searching a directory counts as reading it.  A
+ file's atime and mtime can also be set directly, via the
+-@command{touch} command (@pxref{touch invocation}).  In practice,
++@command{touch} command (@pxref{touch}).  In practice,
+ though, timestamps are not updated quite that way.
+ 
+ For efficiency reasons, many systems are lazy about updating atimes: