coreutils-info.patch

   1 --- coreutils-6.10/doc/coreutils.texi.orig      2008-01-11 14:47:21.000000000 +0100
   2 +++ coreutils-6.10/doc/coreutils.texi   2008-03-02 02:00:24.656756959 +0100
   3 @@ -20,114 +20,100 @@
   4  @syncodeindex pg cp
   5  @syncodeindex vr cp
   6
   7 -@dircategory Basics
   8 +@dircategory Core utilities:
   9  @direntry
  10 -* Coreutils: (coreutils).       Core GNU (file, text, shell) utilities.
  11 -* Common options: (coreutils)Common options.      Common options.
  12 -* File permissions: (coreutils)File permissions.  Access modes.
  13 -* Date input formats: (coreutils)Date input formats.
  14 -@end direntry
  15 -
  16 -@c FIXME: the following need documentation
  17 -@c * [: (coreutils)[ invocation.                   File/string tests.
  18 -@c * pinky: (coreutils)pinky invocation.           FIXME.
  19 -@c * uptime: (coreutils)uptime invocation.         FIXME.
  20 -@c * mktemp: (coreutils)mktemp invocation.         FIXME.
  21 -@c * chcon: (coreutils)chcon invocation.           FIXME.
  22 -
  23 -@dircategory Individual utilities
  24 -@direntry
  25 -* arch: (coreutils)arch invocation.             Print machine hardware name.
  26 -* base64: (coreutils)base64 invocation.         Base64 encode/decode data.
  27 -* basename: (coreutils)basename invocation.     Strip directory and suffix.
  28 -* cat: (coreutils)cat invocation.               Concatenate and write files.
  29 -* chgrp: (coreutils)chgrp invocation.           Change file groups.
  30 -* chmod: (coreutils)chmod invocation.           Change file permissions.
  31 -* chown: (coreutils)chown invocation.           Change file owners/groups.
  32 -* chroot: (coreutils)chroot invocation.         Specify the root directory.
  33 -* cksum: (coreutils)cksum invocation.           Print POSIX CRC checksum.
  34 -* comm: (coreutils)comm invocation.             Compare sorted files by line.
  35 -* cp: (coreutils)cp invocation.                 Copy files.
  36 -* csplit: (coreutils)csplit invocation.         Split by context.
  37 -* cut: (coreutils)cut invocation.               Print selected parts of lines.
  38 -* date: (coreutils)date invocation.             Print/set system date and time.
  39 -* dd: (coreutils)dd invocation.                 Copy and convert a file.
  40 -* df: (coreutils)df invocation.                 Report file system disk usage.
  41 -* dir: (coreutils)dir invocation.               List directories briefly.
  42 -* dircolors: (coreutils)dircolors invocation.   Color setup for ls.
  43 -* dirname: (coreutils)dirname invocation.       Strip non-directory suffix.
  44 -* du: (coreutils)du invocation.                 Report on disk usage.
  45 -* echo: (coreutils)echo invocation.             Print a line of text.
  46 -* env: (coreutils)env invocation.               Modify the environment.
  47 -* expand: (coreutils)expand invocation.         Convert tabs to spaces.
  48 -* expr: (coreutils)expr invocation.             Evaluate expressions.
  49 -* factor: (coreutils)factor invocation.         Print prime factors
  50 -* false: (coreutils)false invocation.           Do nothing, unsuccessfully.
  51 -* fmt: (coreutils)fmt invocation.               Reformat paragraph text.
  52 -* fold: (coreutils)fold invocation.             Wrap long input lines.
  53 -* groups: (coreutils)groups invocation.         Print group names a user is in.
  54 -* head: (coreutils)head invocation.             Output the first part of files.
  55 -* hostid: (coreutils)hostid invocation.         Print numeric host identifier.
  56 -* hostname: (coreutils)hostname invocation.     Print or set system name.
  57 -* id: (coreutils)id invocation.                 Print user identity.
  58 -* install: (coreutils)install invocation.       Copy and change attributes.
  59 -* join: (coreutils)join invocation.             Join lines on a common field.
  60 -* kill: (coreutils)kill invocation.             Send a signal to processes.
  61 -* link: (coreutils)link invocation.             Make hard links between files.
  62 -* ln: (coreutils)ln invocation.                 Make links between files.
  63 -* logname: (coreutils)logname invocation.       Print current login name.
  64 -* ls: (coreutils)ls invocation.                 List directory contents.
  65 -* md5sum: (coreutils)md5sum invocation.         Print or check MD5 digests.
  66 -* mkdir: (coreutils)mkdir invocation.           Create directories.
  67 -* mkfifo: (coreutils)mkfifo invocation.         Create FIFOs (named pipes).
  68 -* mknod: (coreutils)mknod invocation.           Create special files.
  69 -* mv: (coreutils)mv invocation.                 Rename files.
  70 -* nice: (coreutils)nice invocation.             Modify niceness.
  71 -* nl: (coreutils)nl invocation.                 Number lines and write files.
  72 -* nohup: (coreutils)nohup invocation.           Immunize to hangups.
  73 -* od: (coreutils)od invocation.                 Dump files in octal, etc.
  74 -* paste: (coreutils)paste invocation.           Merge lines of files.
  75 -* pathchk: (coreutils)pathchk invocation.       Check file name portability.
  76 -* pr: (coreutils)pr invocation.                 Paginate or columnate files.
  77 -* printenv: (coreutils)printenv invocation.     Print environment variables.
  78 -* printf: (coreutils)printf invocation.         Format and print data.
  79 -* ptx: (coreutils)ptx invocation.               Produce permuted indexes.
  80 -* pwd: (coreutils)pwd invocation.               Print working directory.
  81 -* readlink: (coreutils)readlink invocation.     Print referent of a symlink.
  82 -* rm: (coreutils)rm invocation.                 Remove files.
  83 -* rmdir: (coreutils)rmdir invocation.           Remove empty directories.
  84 -* seq: (coreutils)seq invocation.               Print numeric sequences
  85 -* sha1sum: (coreutils)sha1sum invocation.       Print or check SHA-1 digests.
  86 -* sha2: (coreutils)sha2 utilities.              Print or check SHA-2 digests.
  87 -* shred: (coreutils)shred invocation.           Remove files more securely.
  88 -* shuf: (coreutils)shuf invocation.             Shuffling text files.
  89 -* sleep: (coreutils)sleep invocation.           Delay for a specified time.
  90 -* sort: (coreutils)sort invocation.             Sort text files.
  91 -* split: (coreutils)split invocation.           Split into fixed-size pieces.
  92 -* stat: (coreutils)stat invocation.             Report file(system) status.
  93 -* stty: (coreutils)stty invocation.             Print/change terminal settings.
  94 -* su: (coreutils)su invocation.                 Modify user and group ID.
  95 -* sum: (coreutils)sum invocation.               Print traditional checksum.
  96 -* sync: (coreutils)sync invocation.             Synchronize memory and disk.
  97 -* tac: (coreutils)tac invocation.               Reverse files.
  98 -* tail: (coreutils)tail invocation.             Output the last part of files.
  99 -* tee: (coreutils)tee invocation.               Redirect to multiple files.
 100 -* test: (coreutils)test invocation.             File/string tests.
 101 -* touch: (coreutils)touch invocation.           Change file timestamps.
 102 -* tr: (coreutils)tr invocation.                 Translate characters.
 103 -* true: (coreutils)true invocation.             Do nothing, successfully.
 104 -* tsort: (coreutils)tsort invocation.           Topological sort.
 105 -* tty: (coreutils)tty invocation.               Print terminal name.
 106 -* uname: (coreutils)uname invocation.           Print system information.
 107 -* unexpand: (coreutils)unexpand invocation.     Convert spaces to tabs.
 108 -* uniq: (coreutils)uniq invocation.             Uniquify files.
 109 -* unlink: (coreutils)unlink invocation.         Removal via unlink(2).
 110 -* users: (coreutils)users invocation.           Print current user names.
 111 -* vdir: (coreutils)vdir invocation.             List directories verbosely.
 112 -* wc: (coreutils)wc invocation.                 Line, word, and byte counts.
 113 -* who: (coreutils)who invocation.               Print who is logged in.
 114 -* whoami: (coreutils)whoami invocation.         Print effective user ID.
 115 -* yes: (coreutils)yes invocation.               Print a string indefinitely.
 116 +* Coreutils: (coreutils).                      Core GNU (file, text, shell) utilities.
 117 +* arch: (coreutils)arch invocation.            Print machine hardware name.
 118 +* base64: (coreutils)base64 invocation.                Base64 encode/decode data.
 119 +* basename: (coreutils)basename invocation.    Strip directory and suffix.
 120 +* cat: (coreutils)cat invocation.              Concatenate and write files.
 121 +* chgrp: (coreutils)chgrp invocation.          Change file groups.
 122 +* chmod: (coreutils)chmod invocation.          Change file permissions.
 123 +* chown: (coreutils)chown invocation.          Change file owners/groups.
 124 +* chroot: (coreutils)chroot invocation.                Specify the root directory.
 125 +* cksum: (coreutils)cksum invocation.          Print POSIX CRC checksum.
 126 +* comm: (coreutils)comm invocation.            Compare sorted files by line.
 127 +* cp: (coreutils)cp invocation.                        Copy files.
 128 +* csplit: (coreutils)csplit invocation.                Split by context.
 129 +* cut: (coreutils)cut invocation.              Print selected parts of lines.
 130 +* date: (coreutils)date invocation.            Print/set system date and time.
 131 +* dd: (coreutils)dd invocation.                        Copy and convert a file.
 132 +* df: (coreutils)df invocation.                        Report file system disk usage.
 133 +* dir: (coreutils)dir invocation.              List directories briefly.
 134 +* dircolors: (coreutils)dircolors invocation.  Color setup for ls.
 135 +* dirname: (coreutils)dirname invocation.      Strip non-directory suffix.
 136 +* du: (coreutils)du invocation.                        Report on disk usage.
 137 +* echo: (coreutils)echo invocation.            Print a line of text.
 138 +* env: (coreutils)env invocation.              Modify the environment.
 139 +* expand: (coreutils)expand invocation.                Convert tabs to spaces.
 140 +* expr: (coreutils)expr invocation.            Evaluate expressions.
 141 +* factor: (coreutils)factor invocation.                Print prime factors
 142 +* false: (coreutils)false invocation.          Do nothing, unsuccessfully.
 143 +* fmt: (coreutils)fmt invocation.              Reformat paragraph text.
 144 +* fold: (coreutils)fold invocation.            Wrap long input lines.
 145 +* groups: (coreutils)groups invocation.                Print group names a user is in.
 146 +* head: (coreutils)head invocation.            Output the first part of files.
 147 +* hostid: (coreutils)hostid invocation.                Print numeric host identifier.
 148 +* hostname: (coreutils)hostname invocation.    Print or set system name.
 149 +* id: (coreutils)id invocation.                        Print user identity.
 150 +* install: (coreutils)install invocation.      Copy and change attributes.
 151 +* join: (coreutils)join invocation.            Join lines on a common field.
 152 +* kill: (coreutils)kill invocation.            Send a signal to processes.
 153 +* link: (coreutils)link invocation.            Make hard links between files.
 154 +* ln: (coreutils)ln invocation.                        Make links between files.
 155 +* logname: (coreutils)logname invocation.      Print current login name.
 156 +* ls: (coreutils)ls invocation.                        List directory contents.
 157 +* md5sum: (coreutils)md5sum invocation.                Print or check MD5 digests.
 158 +* mkdir: (coreutils)mkdir invocation.          Create directories.
 159 +* mkfifo: (coreutils)mkfifo invocation.                Create FIFOs (named pipes).
 160 +* mknod: (coreutils)mknod invocation.          Create special files.
 161 +* mv: (coreutils)mv invocation.                        Rename files.
 162 +* nice: (coreutils)nice invocation.            Modify niceness.
 163 +* nl: (coreutils)nl invocation.                        Number lines and write files.
 164 +* nohup: (coreutils)nohup invocation.          Immunize to hangups.
 165 +* od: (coreutils)od invocation.                        Dump files in octal, etc.
 166 +* paste: (coreutils)paste invocation.          Merge lines of files.
 167 +* pathchk: (coreutils)pathchk invocation.      Check file name portability.
 168 +* pr: (coreutils)pr invocation.                        Paginate or columnate files.
 169 +* printenv: (coreutils)printenv invocation.    Print environment variables.
 170 +* printf: (coreutils)printf invocation.                Format and print data.
 171 +* ptx: (coreutils)ptx invocation.              Produce permuted indexes.
 172 +* pwd: (coreutils)pwd invocation.              Print working directory.
 173 +* readlink: (coreutils)readlink invocation.    Print referent of a symlink.
 174 +* rm: (coreutils)rm invocation.                        Remove files.
 175 +* rmdir: (coreutils)rmdir invocation.          Remove empty directories.
 176 +* seq: (coreutils)seq invocation.              Print numeric sequences
 177 +* sha1sum: (coreutils)sha1sum invocation.      Print or check SHA-1 digests.
 178 +* sha2: (coreutils)sha2 utilities.             Print or check SHA-2 digests.
 179 +* shred: (coreutils)shred invocation.          Remove files more securely.
 180 +* shuf: (coreutils)shuf invocation.            Shuffling text files.
 181 +* sleep: (coreutils)sleep invocation.          Delay for a specified time.
 182 +* sort: (coreutils)sort invocation.            Sort text files.
 183 +* split: (coreutils)split invocation.          Split into fixed-size pieces.
 184 +* stat: (coreutils)stat invocation.            Report file(system) status.
 185 +* stty: (coreutils)stty invocation.            Print/change terminal settings.
 186 +* su: (coreutils)su invocation.                        Modify user and group ID.
 187 +* sum: (coreutils)sum invocation.              Print traditional checksum.
 188 +* sync: (coreutils)sync invocation.            Synchronize memory and disk.
 189 +* tac: (coreutils)tac invocation.              Reverse files.
 190 +* tail: (coreutils)tail invocation.            Output the last part of files.
 191 +* tee: (coreutils)tee invocation.              Redirect to multiple files.
 192 +* test: (coreutils)test invocation.            File/string tests.
 193 +* touch: (coreutils)touch invocation.          Change file timestamps.
 194 +* tr: (coreutils)tr invocation.                        Translate characters.
 195 +* true: (coreutils)true invocation.            Do nothing, successfully.
 196 +* tsort: (coreutils)tsort invocation.          Topological sort.
 197 +* tty: (coreutils)tty invocation.              Print terminal name.
 198 +* uname: (coreutils)uname invocation.          Print system information.
 199 +* unexpand: (coreutils)unexpand invocation.    Convert spaces to tabs.
 200 +* uniq: (coreutils)uniq invocation.            Uniquify files.
 201 +* unlink: (coreutils)unlink invocation.                Removal via unlink(2).
 202 +* users: (coreutils)users invocation.          Print current user names.
 203 +* vdir: (coreutils)vdir invocation.            List directories verbosely.
 204 +* wc: (coreutils)wc invocation.                        Line, word, and byte counts.
 205 +* who: (coreutils)who invocation.              Print who is logged in.
 206 +* whoami: (coreutils)whoami invocation.                Print effective user ID.
 207 +* yes: (coreutils)yes invocation.              Print a string indefinitely.
 208  @end direntry
 209
 210  @copying
 211 @@ -189,9 +175,8 @@
 212  * File name manipulation::             dirname basename pathchk
 213  * Working context::                    pwd stty printenv tty
 214  * User information::                   id logname whoami groups users who
 215 -* System context::                     date uname hostname hostid
 216 +* System context::                     date uname hostid
 217  * Modified command invocation::        chroot env nice nohup su
 218 -* Process control::                    kill
 219  * Delaying::                           sleep
 220  * Numeric operations::                 factor seq
 221  * File permissions::                   Access modes.
 222 @@ -218,42 +203,42 @@
 223
 224  Output of entire files
 225
 226 -* cat invocation::              Concatenate and write files.
 227 -* tac invocation::              Concatenate and write files in reverse.
 228 -* nl invocation::               Number lines and write files.
 229 -* od invocation::               Write files in octal or other formats.
 230 -* base64 invocation::           Transform data into printable data.
 231 +* cat::                         Concatenate and write files.
 232 +* tac::                         Concatenate and write files in reverse.
 233 +* nl::                          Number lines and write files.
 234 +* od::                          Write files in octal or other formats.
 235 +* base64::                      Transform data into printable data.
 236
 237  Formatting file contents
 238
 239 -* fmt invocation::              Reformat paragraph text.
 240 -* pr invocation::               Paginate or columnate files for printing.
 241 -* fold invocation::             Wrap input lines to fit in specified width.
 242 +* fmt::                         Reformat paragraph text.
 243 +* pr::                          Paginate or columnate files for printing.
 244 +* fold::                        Wrap input lines to fit in specified width.
 245
 246  Output of parts of files
 247
 248 -* head invocation::             Output the first part of files.
 249 -* tail invocation::             Output the last part of files.
 250 -* split invocation::            Split a file into fixed-size pieces.
 251 -* csplit invocation::           Split a file into context-determined pieces.
 252 +* head::                        Output the first part of files.
 253 +* tail::                        Output the last part of files.
 254 +* split::                       Split a file into fixed-size pieces.
 255 +* csplit::                      Split a file into context-determined pieces.
 256
 257  Summarizing files
 258
 259 -* wc invocation::               Print newline, word, and byte counts.
 260 -* sum invocation::              Print checksum and block counts.
 261 -* cksum invocation::            Print CRC checksum and byte counts.
 262 -* md5sum invocation::           Print or check MD5 digests.
 263 -* sha1sum invocation::          Print or check SHA-1 digests.
 264 -* sha2 utilities::              Print or check SHA-2 digests.
 265 +* wc::                          Print newline, word, and byte counts.
 266 +* sum::                         Print checksum and block counts.
 267 +* cksum::                       Print CRC checksum and byte counts.
 268 +* md5sum::                      Print or check MD5 digests.
 269 +* sha1sum::                     Print or check SHA-1 digests.
 270 +* sha2::                        Print or check SHA-2 digests.
 271
 272  Operating on sorted files
 273
 274 -* sort invocation::             Sort text files.
 275 -* shuf invocation::             Shuffle text files.
 276 -* uniq invocation::             Uniquify files.
 277 -* comm invocation::             Compare two sorted files line by line.
 278 -* ptx invocation::              Produce a permuted index of file contents.
 279 -* tsort invocation::            Topological sort.
 280 +* sort::                        Sort text files.
 281 +* shuf::                        Shuffle text files.
 282 +* uniq::                        Uniquify files.
 283 +* comm::                        Compare two sorted files line by line.
 284 +* ptx::                         Produce a permuted index of file contents.
 285 +* tsort::                       Topological sort.
 286
 287  @command{ptx}: Produce permuted indexes
 288
 289 @@ -265,15 +250,15 @@
 290
 291  Operating on fields within a line
 292
 293 -* cut invocation::              Print selected parts of lines.
 294 -* paste invocation::            Merge lines of files.
 295 -* join invocation::             Join lines on a common field.
 296 +* cut::                         Print selected parts of lines.
 297 +* paste::                       Merge lines of files.
 298 +* join::                        Join lines on a common field.
 299
 300  Operating on characters
 301
 302 -* tr invocation::               Translate, squeeze, and/or delete characters.
 303 -* expand invocation::           Convert tabs to spaces.
 304 -* unexpand invocation::         Convert spaces to tabs.
 305 +* tr::                          Translate, squeeze, and/or delete characters.
 306 +* expand::                      Convert tabs to spaces.
 307 +* unexpand::                    Convert spaces to tabs.
 308
 309  @command{tr}: Translate, squeeze, and/or delete characters
 310
 311 @@ -283,10 +268,10 @@
 312
 313  Directory listing
 314
 315 -* ls invocation::               List directory contents
 316 -* dir invocation::              Briefly list directory contents
 317 -* vdir invocation::             Verbosely list directory contents
 318 -* dircolors invocation::        Color setup for @command{ls}
 319 +* ls::                          List directory contents
 320 +* dir::                         Briefly list directory contents
 321 +* vdir::                        Verbosely list directory contents
 322 +* dircolors::                   Color setup for @command{ls}
 323
 324  @command{ls}:  List directory contents
 325
 326 @@ -299,50 +284,50 @@
 327
 328  Basic operations
 329
 330 -* cp invocation::               Copy files and directories
 331 -* dd invocation::               Convert and copy a file
 332 -* install invocation::          Copy files and set attributes
 333 -* mv invocation::               Move (rename) files
 334 -* rm invocation::               Remove files or directories
 335 -* shred invocation::            Remove files more securely
 336 +* cp::                          Copy files and directories
 337 +* dd::                          Convert and copy a file
 338 +* install::                     Copy files and set attributes
 339 +* mv::                          Move (rename) files
 340 +* rm::                          Remove files or directories
 341 +* shred::                       Remove files more securely
 342
 343  Special file types
 344
 345 -* link invocation::             Make a hard link via the link syscall
 346 -* ln invocation::               Make links between files
 347 -* mkdir invocation::            Make directories
 348 -* mkfifo invocation::           Make FIFOs (named pipes)
 349 -* mknod invocation::            Make block or character special files
 350 -* readlink invocation::         Print the referent of a symbolic link
 351 -* rmdir invocation::            Remove empty directories
 352 -* unlink invocation::           Remove files via unlink syscall
 353 +* link::                        Make a hard link via the link syscall
 354 +* ln::                          Make links between files
 355 +* mkdir::                       Make directories
 356 +* mkfifo::                      Make FIFOs (named pipes)
 357 +* mknod::                       Make block or character special files
 358 +* readlink::                    Print the referent of a symbolic link
 359 +* rmdir::                       Remove empty directories
 360 +* unlink::                      Remove files via unlink syscall
 361
 362  Changing file attributes
 363
 364 -* chown invocation::            Change file owner and group
 365 -* chgrp invocation::            Change group ownership
 366 -* chmod invocation::            Change access permissions
 367 -* touch invocation::            Change file timestamps
 368 +* chown::                       Change file owner and group
 369 +* chgrp::                       Change group ownership
 370 +* chmod::                       Change access permissions
 371 +* touch::                       Change file timestamps
 372
 373  Disk usage
 374
 375 -* df invocation::               Report file system disk space usage
 376 -* du invocation::               Estimate file space usage
 377 -* stat invocation::             Report file or file system status
 378 -* sync invocation::             Synchronize data on disk with memory
 379 +* df::                          Report file system disk space usage
 380 +* du::                          Estimate file space usage
 381 +* stat::                        Report file or file system status
 382 +* sync::                        Synchronize data on disk with memory
 383
 384  Printing text
 385
 386 -* echo invocation::             Print a line of text
 387 -* printf invocation::           Format and print data
 388 -* yes invocation::              Print a string until interrupted
 389 +* echo::                        Print a line of text
 390 +* printf::                      Format and print data
 391 +* yes::                         Print a string until interrupted
 392
 393  Conditions
 394
 395 -* false invocation::              Do nothing, unsuccessfully
 396 -* true invocation::               Do nothing, successfully
 397 -* test invocation::               Check file types and compare values
 398 -* expr invocation::               Evaluate expressions
 399 +* false::                         Do nothing, unsuccessfully
 400 +* true::                          Do nothing, successfully
 401 +* test::                          Check file types and compare values
 402 +* expr::                          Evaluate expressions
 403
 404  @command{test}: Check file types and compare values
 405
 406 @@ -361,20 +346,20 @@
 407
 408  Redirection
 409
 410 -* tee invocation::               Redirect output to multiple files or processes
 411 +* tee::                          Redirect output to multiple files or processes
 412
 413  File name manipulation
 414
 415 -* basename invocation::          Strip directory and suffix from a file name
 416 -* dirname invocation::           Strip non-directory suffix from a file name
 417 -* pathchk invocation::           Check file name portability
 418 +* basename::                     Strip directory and suffix from a file name
 419 +* dirname::                      Strip non-directory suffix from a file name
 420 +* pathchk::                      Check file name portability
 421
 422  Working context
 423
 424 -* pwd invocation::               Print working directory
 425 -* stty invocation::              Print or change terminal characteristics
 426 -* printenv invocation::          Print all or some environment variables
 427 -* tty invocation::               Print file name of terminal on standard input
 428 +* pwd::                          Print working directory
 429 +* stty::                         Print or change terminal characteristics
 430 +* printenv::                     Print all or some environment variables
 431 +* tty::                          Print file name of terminal on standard input
 432
 433  @command{stty}: Print or change terminal characteristics
 434
 435 @@ -388,20 +373,19 @@
 436
 437  User information
 438
 439 -* id invocation::                Print user identity
 440 -* logname invocation::           Print current login name
 441 -* whoami invocation::            Print effective user ID
 442 -* groups invocation::            Print group names a user is in
 443 -* users invocation::             Print login names of users currently logged in
 444 -* who invocation::               Print who is currently logged in
 445 +* id::                           Print user identity
 446 +* logname::                      Print current login name
 447 +* whoami::                       Print effective user ID
 448 +* groups::                       Print group names a user is in
 449 +* users::                        Print login names of users currently logged in
 450 +* who::                          Print who is currently logged in
 451
 452  System context
 453
 454 -* arch invocation::              Print machine hardware name
 455 -* date invocation::              Print or set system date and time
 456 -* uname invocation::             Print system information
 457 -* hostname invocation::          Print or set system name
 458 -* hostid invocation::            Print numeric host identifier.
 459 +* arch::                         Print machine hardware name
 460 +* date::                         Print or set system date and time
 461 +* uname::                        Print system information
 462 +* hostid::                       Print numeric host identifier
 463
 464  @command{date}: Print or set system date and time
 465
 466 @@ -416,24 +400,20 @@
 467
 468  Modified command invocation
 469
 470 -* chroot invocation::            Run a command with a different root directory
 471 -* env invocation::               Run a command in a modified environment
 472 -* nice invocation::              Run a command with modified niceness
 473 -* nohup invocation::             Run a command immune to hangups
 474 -* su invocation::                Run a command with substitute user and group ID
 475 -
 476 -Process control
 477 -
 478 -* kill invocation::              Sending a signal to processes.
 479 +* chroot::                       Run a command with a different root directory
 480 +* env::                          Run a command in a modified environment
 481 +* nice::                         Run a command with modified niceness
 482 +* nohup::                        Run a command immune to hangups
 483 +* su::                           Run a command with substitute user and group ID
 484
 485  Delaying
 486
 487 -* sleep invocation::             Delay for a specified time
 488 +* sleep::                        Delay for a specified time
 489
 490  Numeric operations
 491
 492 -* factor invocation::            Print prime factors
 493 -* seq invocation::               Print numeric sequences
 494 +* factor::                       Print prime factors
 495 +* seq::                          Print numeric sequences
 496
 497  File permissions
 498
 499 @@ -1276,14 +1256,14 @@
 500  in some way.
 501
 502  @menu
 503 -* cat invocation::              Concatenate and write files.
 504 -* tac invocation::              Concatenate and write files in reverse.
 505 -* nl invocation::               Number lines and write files.
 506 -* od invocation::               Write files in octal or other formats.
 507 -* base64 invocation::           Transform data into printable data.
 508 +* cat::                         Concatenate and write files.
 509 +* tac::                         Concatenate and write files in reverse.
 510 +* nl::                          Number lines and write files.
 511 +* od::                          Write files in octal or other formats.
 512 +* base64::                      Transform data into printable data.
 513  @end menu
 514
 515 -@node cat invocation
 516 +@node cat
 517  @section @command{cat}: Concatenate and write files
 518
 519  @pindex cat
 520 @@ -1382,7 +1362,7 @@
 521  @end smallexample
 522
 523
 524 -@node tac invocation
 525 +@node tac
 526  @section @command{tac}: Concatenate and write files in reverse
 527
 528  @pindex tac
 529 @@ -1431,7 +1411,7 @@
 530  @exitstatus
 531
 532
 533 -@node nl invocation
 534 +@node nl
 535  @section @command{nl}: Number lines and write files
 536
 537  @pindex nl
 538 @@ -1594,7 +1574,7 @@
 539  @exitstatus
 540
 541
 542 -@node od invocation
 543 +@node od
 544  @section @command{od}: Write files in octal or other formats
 545
 546  @pindex od
 547 @@ -1850,7 +1830,7 @@
 548
 549  @exitstatus
 550
 551 -@node base64 invocation
 552 +@node base64
 553  @section @command{base64}: Transform data into printable data.
 554
 555  @pindex base64
 556 @@ -1917,13 +1897,13 @@
 557  These commands reformat the contents of files.
 558
 559  @menu
 560 -* fmt invocation::              Reformat paragraph text.
 561 -* pr invocation::               Paginate or columnate files for printing.
 562 -* fold invocation::             Wrap input lines to fit in specified width.
 563 +* fmt::                         Reformat paragraph text.
 564 +* pr::                          Paginate or columnate files for printing.
 565 +* fold::                        Wrap input lines to fit in specified width.
 566  @end menu
 567
 568
 569 -@node fmt invocation
 570 +@node fmt
 571  @section @command{fmt}: Reformat paragraph text
 572
 573  @pindex fmt
 574 @@ -2022,7 +2002,7 @@
 575  @exitstatus
 576
 577
 578 -@node pr invocation
 579 +@node pr
 580  @section @command{pr}: Paginate or columnate files for printing
 581
 582  @pindex pr
 583 @@ -2162,7 +2142,7 @@
 584  @cindex time formats
 585  @cindex formatting times
 586  Format header dates using @var{format}, using the same conventions as
 587 -for the command @samp{date +@var{format}}; @xref{date invocation}.
 588 +for the command @samp{date +@var{format}}; @xref{date}.
 589  Except for directives, which start with
 590  @samp{%}, characters in @var{format} are printed unchanged.  You can use
 591  this option to specify an arbitrary string in place of the header date,
 592 @@ -2389,7 +2369,7 @@
 593  @exitstatus
 594
 595
 596 -@node fold invocation
 597 +@node fold
 598  @section @command{fold}: Wrap input lines to fit in specified width
 599
 600  @pindex fold
 601 @@ -2456,13 +2436,13 @@
 602  These commands output pieces of the input.
 603
 604  @menu
 605 -* head invocation::             Output the first part of files.
 606 -* tail invocation::             Output the last part of files.
 607 -* split invocation::            Split a file into fixed-size pieces.
 608 -* csplit invocation::           Split a file into context-determined pieces.
 609 +* head::                        Output the first part of files.
 610 +* tail::                        Output the last part of files.
 611 +* split::                       Split a file into fixed-size pieces.
 612 +* csplit::                      Split a file into context-determined pieces.
 613  @end menu
 614
 615 -@node head invocation
 616 +@node head
 617  @section @command{head}: Output the first part of files
 618
 619  @pindex head
 620 @@ -2543,7 +2523,7 @@
 621  @exitstatus
 622
 623
 624 -@node tail invocation
 625 +@node tail
 626  @section @command{tail}: Output the last part of files
 627
 628  @pindex tail
 629 @@ -2758,7 +2738,7 @@
 630  @exitstatus
 631
 632
 633 -@node split invocation
 634 +@node split
 635  @section @command{split}: Split a file into fixed-size pieces
 636
 637  @pindex split
 638 @@ -2845,7 +2825,7 @@
 639  @exitstatus
 640
 641
 642 -@node csplit invocation
 643 +@node csplit
 644  @section @command{csplit}: Split a file into context-determined pieces
 645
 646  @pindex csplit
 647 @@ -2985,16 +2965,16 @@
 648  contents of files.
 649
 650  @menu
 651 -* wc invocation::               Print newline, word, and byte counts.
 652 -* sum invocation::              Print checksum and block counts.
 653 -* cksum invocation::            Print CRC checksum and byte counts.
 654 -* md5sum invocation::           Print or check MD5 digests.
 655 -* sha1sum invocation::          Print or check SHA-1 digests.
 656 -* sha2 utilities::              Print or check SHA-2 digests.
 657 +* wc::                          Print newline, word, and byte counts.
 658 +* sum::                         Print checksum and block counts.
 659 +* cksum::                       Print CRC checksum and byte counts.
 660 +* md5sum::                      Print or check MD5 digests.
 661 +* sha1sum::                     Print or check SHA-1 digests.
 662 +* sha2::                        Print or check SHA-2 digests.
 663  @end menu
 664
 665
 666 -@node wc invocation
 667 +@node wc
 668  @section @command{wc}: Print newline, word, and byte counts
 669
 670  @pindex wc
 671 @@ -3101,7 +3081,7 @@
 672  @exitstatus
 673
 674
 675 -@node sum invocation
 676 +@node sum
 677  @section @command{sum}: Print checksum and block counts
 678
 679  @pindex sum
 680 @@ -3152,7 +3132,7 @@
 681  @exitstatus
 682
 683
 684 -@node cksum invocation
 685 +@node cksum
 686  @section @command{cksum}: Print CRC checksum and byte counts
 687
 688  @pindex cksum
 689 @@ -3186,7 +3166,7 @@
 690  @exitstatus
 691
 692
 693 -@node md5sum invocation
 694 +@node md5sum
 695  @section @command{md5sum}: Print or check MD5 digests
 696
 697  @pindex md5sum
 698 @@ -3208,8 +3188,8 @@
 699  considered infeasible at the moment, it is known how to produce
 700  different files with identical MD5 (a ``collision''), something which
 701  can be a security issue in certain contexts.  For more secure hashes,
 702 -consider using SHA-1 or SHA-2.  @xref{sha1sum invocation}, and
 703 -@ref{sha2 utilities}.
 704 +consider using SHA-1 or SHA-2.  @xref{sha1sum}, and
 705 +@ref{sha2}.
 706
 707  If a @var{file} is specified as @samp{-} or if no files are given
 708  @command{md5sum} computes the checksum for the standard input.
 709 @@ -3307,7 +3287,7 @@
 710  @exitstatus
 711
 712
 713 -@node sha1sum invocation
 714 +@node sha1sum
 715  @section @command{sha1sum}: Print or check SHA-1 digests
 716
 717  @pindex sha1sum
 718 @@ -3319,17 +3299,17 @@
 719
 720  @command{sha1sum} computes a 160-bit checksum for each specified
 721  @var{file}.  The usage and options of this command are precisely the
 722 -same as for @command{md5sum}.  @xref{md5sum invocation}.
 723 +same as for @command{md5sum}.  @xref{md5sum}.
 724
 725  Note: The SHA-1 digest is more secure than MD5, and no collisions of
 726  it are known (different files having the same fingerprint).  However,
 727  it is known that they can be produced with considerable, but not
 728  unreasonable, resources.  For this reason, it is generally considered
 729  that SHA-1 should be gradually phased out in favor of the more secure
 730 -SHA-2 hash algorithms.  @xref{sha2 utilities}.
 731 +SHA-2 hash algorithms.  @xref{sha2}.
 732
 733
 734 -@node sha2 utilities
 735 +@node sha2
 736  @section sha2 utilities: Print or check SHA-2 digests
 737
 738  @pindex sha224sum
 739 @@ -3359,7 +3339,7 @@
 740  various lengths (respectively 224, 256, 384 and 512 bits),
 741  collectively known as the SHA-2 hashes.  The usage and options of
 742  these commands are precisely the same as for @command{md5sum}.
 743 -@xref{md5sum invocation}.
 744 +@xref{md5sum}.
 745
 746  Note: The SHA384 and SHA512 digests are considerably slower to
 747  compute, especially on 32-bit computers, than SHA224 or SHA256.
 748 @@ -3374,17 +3354,17 @@
 749  These commands work with (or produce) sorted files.
 750
 751  @menu
 752 -* sort invocation::             Sort text files.
 753 -* shuf invocation::             Shuffle text files.
 754 -* uniq invocation::             Uniquify files.
 755 -* comm invocation::             Compare two sorted files line by line.
 756 -* ptx invocation::              Produce a permuted index of file contents.
 757 -* tsort invocation::            Topological sort.
 758 +* sort::                        Sort text files.
 759 +* shuf::                        Shuffle text files.
 760 +* uniq::                        Uniquify files.
 761 +* comm::                        Compare two sorted files line by line.
 762 +* ptx::                         Produce a permuted index of file contents.
 763 +* tsort::                       Topological sort.
 764  * tsort background::            Where tsort came from.
 765  @end menu
 766
 767
 768 -@node sort invocation
 769 +@node sort
 770  @section @command{sort}: Sort text files
 771
 772  @pindex sort
 773 @@ -3629,7 +3609,7 @@
 774  Sort by hashing the input keys and then sorting the hash values.
 775  Choose the hash function at random, ensuring that it is free of
 776  collisions so that differing keys have differing hash values.  This is
 777 -like a random permutation of the inputs (@pxref{shuf invocation}),
 778 +like a random permutation of the inputs (@pxref{shuf}),
 779  except that keys with the same value sort together.
 780
 781  If multiple random sort fields are specified, the same random hash
 782 @@ -3792,7 +3772,7 @@
 783  this equivalence does not extend to arbitrary @command{sort} options.
 784  For example, @code{sort -n -u} inspects only the value of the initial
 785  numeric string when checking for uniqueness, whereas @code{sort -n |
 786 -uniq} inspects the entire line.  @xref{uniq invocation}.
 787 +uniq} inspects the entire line.  @xref{uniq}.
 788
 789  @item -z
 790  @itemx --zero-terminated
 791 @@ -3985,7 +3965,7 @@
 792  @end itemize
 793
 794
 795 -@node shuf invocation
 796 +@node shuf
 797  @section @command{shuf}: Shuffling text
 798
 799  @pindex shuf
 800 @@ -4126,7 +4106,7 @@
 801  @exitstatus
 802
 803
 804 -@node uniq invocation
 805 +@node uniq
 806  @section @command{uniq}: Uniquify files
 807
 808  @pindex uniq
 809 @@ -4148,7 +4128,7 @@
 810  The input need not be sorted, but repeated input lines are detected
 811  only if they are adjacent.  If you want to discard non-adjacent
 812  duplicate lines, perhaps you want to use @code{sort -u}.
 813 -@xref{sort invocation}.
 814 +@xref{sort}.
 815
 816  @vindex LC_COLLATE
 817  Comparisons use the character collating sequence specified by the
 818 @@ -4286,7 +4266,7 @@
 819  @exitstatus
 820
 821
 822 -@node comm invocation
 823 +@node comm
 824  @section @command{comm}: Compare two sorted files line by line
 825
 826  @pindex comm
 827 @@ -4329,7 +4309,7 @@
 828  If there is an error it exits with nonzero status.
 829
 830
 831 -@node tsort invocation
 832 +@node tsort
 833  @section @command{tsort}: Topological sort
 834
 835  @pindex tsort
 836 @@ -4483,7 +4463,7 @@
 837  @exitstatus
 838
 839
 840 -@node ptx invocation
 841 +@node ptx
 842  @section @command{ptx}: Produce permuted indexes
 843
 844  @pindex ptx
 845 @@ -4942,13 +4922,13 @@
 846  @chapter Operating on fields within a line
 847
 848  @menu
 849 -* cut invocation::              Print selected parts of lines.
 850 -* paste invocation::            Merge lines of files.
 851 -* join invocation::             Join lines on a common field.
 852 +* cut::                         Print selected parts of lines.
 853 +* paste::                       Merge lines of files.
 854 +* join::                        Join lines on a common field.
 855  @end menu
 856
 857
 858 -@node cut invocation
 859 +@node cut
 860  @section @command{cut}: Print selected parts of lines
 861
 862  @pindex cut
 863 @@ -5047,7 +5027,7 @@
 864  @exitstatus
 865
 866
 867 -@node paste invocation
 868 +@node paste
 869  @section @command{paste}: Merge lines of files
 870
 871  @pindex paste
 872 @@ -5117,7 +5097,7 @@
 873  @exitstatus
 874
 875
 876 -@node join invocation
 877 +@node join
 878  @section @command{join}: Join lines on a common field
 879
 880  @pindex join
 881 @@ -5260,13 +5240,13 @@
 882  This commands operate on individual characters.
 883
 884  @menu
 885 -* tr invocation::               Translate, squeeze, and/or delete characters.
 886 -* expand invocation::           Convert tabs to spaces.
 887 -* unexpand invocation::         Convert spaces to tabs.
 888 +* tr::                          Translate, squeeze, and/or delete characters.
 889 +* expand::                      Convert tabs to spaces.
 890 +* unexpand::                    Convert spaces to tabs.
 891  @end menu
 892
 893
 894 -@node tr invocation
 895 +@node tr
 896  @section @command{tr}: Translate, squeeze, and/or delete characters
 897
 898  @pindex tr
 899 @@ -5644,7 +5624,7 @@
 900  @end itemize
 901
 902
 903 -@node expand invocation
 904 +@node expand
 905  @section @command{expand}: Convert tabs to spaces
 906
 907  @pindex expand
 908 @@ -5697,7 +5677,7 @@
 909  @exitstatus
 910
 911
 912 -@node unexpand invocation
 913 +@node unexpand
 914  @section @command{unexpand}: Convert spaces to tabs
 915
 916  @pindex unexpand
 917 @@ -5758,14 +5738,14 @@
 918  and @command{vdir}, which list information about files.
 919
 920  @menu
 921 -* ls invocation::               List directory contents.
 922 -* dir invocation::              Briefly ls.
 923 -* vdir invocation::             Verbosely ls.
 924 -* dircolors invocation::        Color setup for ls, etc.
 925 +* ls::                          List directory contents.
 926 +* dir::                         Briefly ls.
 927 +* vdir::                        Verbosely ls.
 928 +* dircolors::                   Color setup for ls, etc.
 929  @end menu
 930
 931
 932 -@node ls invocation
 933 +@node ls
 934  @section @command{ls}: List directory contents
 935
 936  @pindex ls
 937 @@ -6570,7 +6550,7 @@
 938  @item +@var{format}
 939  @vindex LC_TIME
 940  List timestamps using @var{format}, where @var{format} is interpreted
 941 -like the format argument of @command{date} (@pxref{date invocation}).
 942 +like the format argument of @command{date} (@pxref{date}).
 943  For example, @option{--time-style="+%Y-%m-%d %H:%M:%S"} causes
 944  @command{ls} to list timestamps like @samp{2002-03-30 23:45:56}.  As
 945  with @command{date}, @var{format}'s interpretation is affected by the
 946 @@ -6762,7 +6742,7 @@
 947  @end table
 948
 949
 950 -@node dir invocation
 951 +@node dir
 952  @section @command{dir}: Briefly list directory contents
 953
 954  @pindex dir
 955 @@ -6772,10 +6752,10 @@
 956  -b}; that is, by default files are listed in columns, sorted vertically,
 957  and special characters are represented by backslash escape sequences.
 958
 959 -@xref{ls invocation, @command{ls}}.
 960 +@xref{ls, @command{ls}}.
 961
 962
 963 -@node vdir invocation
 964 +@node vdir
 965  @section @command{vdir}: Verbosely list directory contents
 966
 967  @pindex vdir
 968 @@ -6785,7 +6765,7 @@
 969  -b}; that is, by default files are listed in long format and special
 970  characters are represented by backslash escape sequences.
 971
 972 -@node dircolors invocation
 973 +@node dircolors
 974  @section @command{dircolors}: Color setup for @command{ls}
 975
 976  @pindex dircolors
 977 @@ -6863,16 +6843,16 @@
 978  copying, moving (renaming), and deleting (removing).
 979
 980  @menu
 981 -* cp invocation::               Copy files.
 982 -* dd invocation::               Convert and copy a file.
 983 -* install invocation::          Copy files and set attributes.
 984 -* mv invocation::               Move (rename) files.
 985 -* rm invocation::               Remove files or directories.
 986 -* shred invocation::            Remove files more securely.
 987 +* cp::                          Copy files.
 988 +* dd::                          Convert and copy a file.
 989 +* install::                     Copy files and set attributes.
 990 +* mv::                          Move (rename) files.
 991 +* rm::                          Remove files or directories.
 992 +* shred::                       Remove files more securely.
 993  @end menu
 994
 995
 996 -@node cp invocation
 997 +@node cp
 998  @section @command{cp}: Copy files and directories
 999
1000  @pindex cp
1001 @@ -7251,7 +7231,7 @@
1002  @exitstatus
1003
1004
1005 -@node dd invocation
1006 +@node dd
1007  @section @command{dd}: Convert and copy a file
1008
1009  @pindex dd
1010 @@ -7580,7 +7560,7 @@
1011  @exitstatus
1012
1013
1014 -@node install invocation
1015 +@node install
1016  @section @command{install}: Copy files and set attributes
1017
1018  @pindex install
1019 @@ -7726,7 +7706,7 @@
1020  @exitstatus
1021
1022
1023 -@node mv invocation
1024 +@node mv
1025  @section @command{mv}: Move (rename) files
1026
1027  @pindex mv
1028 @@ -7847,7 +7827,7 @@
1029  @exitstatus
1030
1031
1032 -@node rm invocation
1033 +@node rm
1034  @section @command{rm}: Remove files or directories
1035
1036  @pindex rm
1037 @@ -8001,7 +7981,7 @@
1038  @exitstatus
1039
1040
1041 -@node shred invocation
1042 +@node shred
1043  @section @command{shred}: Remove files more securely
1044
1045  @pindex shred
1046 @@ -8011,7 +7991,7 @@
1047  @command{shred} overwrites devices or files, to help prevent even
1048  very expensive hardware from recovering the data.
1049
1050 -Ordinarily when you remove a file (@pxref{rm invocation}), the data is
1051 +Ordinarily when you remove a file (@pxref{rm}), the data is
1052  not actually destroyed.  Only the index listing where the file is
1053  stored is destroyed, and the storage is made available for reuse.
1054  There are undelete utilities that will attempt to reconstruct the index
1055 @@ -8243,18 +8223,18 @@
1056  (FIFOs), symbolic links, sockets, and so-called @dfn{special files}.
1057
1058  @menu
1059 -* link invocation::             Make a hard link via the link syscall
1060 -* ln invocation::               Make links between files.
1061 -* mkdir invocation::            Make directories.
1062 -* mkfifo invocation::           Make FIFOs (named pipes).
1063 -* mknod invocation::            Make block or character special files.
1064 -* readlink invocation::         Print the referent of a symbolic link.
1065 -* rmdir invocation::            Remove empty directories.
1066 -* unlink invocation::           Remove files via the unlink syscall
1067 +* link::                        Make a hard link via the link syscall.
1068 +* ln::                          Make links between files.
1069 +* mkdir::                       Make directories.
1070 +* mkfifo::                      Make FIFOs (named pipes).
1071 +* mknod::                       Make block or character special files.
1072 +* readlink::                    Print the referent of a symbolic link.
1073 +* rmdir::                       Remove empty directories.
1074 +* unlink::                      Remove files via the unlink syscall.
1075  @end menu
1076
1077
1078 -@node link invocation
1079 +@node link
1080  @section @command{link}: Make a hard link via the link syscall
1081
1082  @pindex link
1083 @@ -8267,7 +8247,7 @@
1084  @code{link} function.  @xref{Hard Links, , , libc,
1085  The GNU C Library Reference Manual}.
1086  It avoids the bells and whistles of the more commonly-used
1087 -@command{ln} command (@pxref{ln invocation}).
1088 +@command{ln} command (@pxref{ln}).
1089  Synopsis:
1090
1091  @example
1092 @@ -8288,7 +8268,7 @@
1093  @exitstatus
1094
1095
1096 -@node ln invocation
1097 +@node ln
1098  @section @command{ln}: Make links between files
1099
1100  @pindex ln
1101 @@ -8460,7 +8440,7 @@
1102  @end smallexample
1103
1104
1105 -@node mkdir invocation
1106 +@node mkdir
1107  @section @command{mkdir}: Make directories
1108
1109  @pindex mkdir
1110 @@ -8530,7 +8510,7 @@
1111  @exitstatus
1112
1113
1114 -@node mkfifo invocation
1115 +@node mkfifo
1116  @section @command{mkfifo}: Make FIFOs (named pipes)
1117
1118  @pindex mkfifo
1119 @@ -8569,7 +8549,7 @@
1120  @exitstatus
1121
1122
1123 -@node mknod invocation
1124 +@node mknod
1125  @section @command{mknod}: Make block or character special files
1126
1127  @pindex mknod
1128 @@ -8641,7 +8621,7 @@
1129  @exitstatus
1130
1131
1132 -@node readlink invocation
1133 +@node readlink
1134  @section @command{readlink}: Print the referent of a symbolic link
1135
1136  @pindex readlink
1137 @@ -8728,7 +8708,7 @@
1138  @exitstatus
1139
1140
1141 -@node rmdir invocation
1142 +@node rmdir
1143  @section @command{rmdir}: Remove empty directories
1144
1145  @pindex rmdir
1146 @@ -8776,12 +8756,12 @@
1147
1148  @end table
1149
1150 -@xref{rm invocation}, for how to remove non-empty directories (recursively).
1151 +@xref{rm}, for how to remove non-empty directories (recursively).
1152
1153  @exitstatus
1154
1155
1156 -@node unlink invocation
1157 +@node unlink
1158  @section @command{unlink}: Remove files via the unlink syscall
1159
1160  @pindex unlink
1161 @@ -8792,7 +8772,7 @@
1162  @code{unlink} function.  @xref{Deleting Files, , , libc,
1163  The GNU C Library Reference Manual}.  Synopsis:
1164  It avoids the bells and whistles of the more commonly-used
1165 -@command{rm} command (@pxref{rm invocation}).
1166 +@command{rm} command (@pxref{rm}).
1167
1168  @example
1169  unlink @var{filename}
1170 @@ -8826,14 +8806,14 @@
1171  These commands change file attributes.
1172
1173  @menu
1174 -* chgrp invocation::            Change file groups.
1175 -* chmod invocation::            Change access permissions.
1176 -* chown invocation::            Change file owners and groups.
1177 -* touch invocation::            Change file timestamps.
1178 +* chgrp::                       Change file groups.
1179 +* chmod::                       Change access permissions.
1180 +* chown::                       Change file owners and groups.
1181 +* touch::                       Change file timestamps.
1182  @end menu
1183
1184
1185 -@node chown invocation
1186 +@node chown
1187  @section @command{chown}: Change file owner and group
1188
1189  @pindex chown
1190 @@ -9050,7 +9030,7 @@
1191  @end smallexample
1192
1193
1194 -@node chgrp invocation
1195 +@node chgrp
1196  @section @command{chgrp}: Change group ownership
1197
1198  @pindex chgrp
1199 @@ -9172,7 +9152,7 @@
1200  @end smallexample
1201
1202
1203 -@node chmod invocation
1204 +@node chmod
1205  @section @command{chmod}: Change access permissions
1206
1207  @pindex chmod
1208 @@ -9271,7 +9251,7 @@
1209  @exitstatus
1210
1211
1212 -@node touch invocation
1213 +@node touch
1214  @section @command{touch}: Change file timestamps
1215
1216  @pindex touch
1217 @@ -9421,14 +9401,14 @@
1218  file status information, and write buffers to disk.
1219
1220  @menu
1221 -* df invocation::               Report file system disk space usage.
1222 -* du invocation::               Estimate file space usage.
1223 -* stat invocation::             Report file or file system status.
1224 -* sync invocation::             Synchronize memory and disk.
1225 +* df::                          Report file system disk space usage.
1226 +* du::                          Estimate file space usage.
1227 +* stat::                        Report file or file system status.
1228 +* sync::                        Synchronize memory and disk.
1229  @end menu
1230
1231
1232 -@node df invocation
1233 +@node df
1234  @section @command{df}: Report file system disk space usage
1235
1236  @pindex df
1237 @@ -9633,7 +9613,7 @@
1238  @samp{ext3} or @samp{reiserfs}.
1239
1240
1241 -@node du invocation
1242 +@node du
1243  @section @command{du}: Estimate file space usage
1244
1245  @pindex du
1246 @@ -9842,7 +9822,7 @@
1247  @item +@var{format}
1248  @vindex LC_TIME
1249  List timestamps using @var{format}, where @var{format} is interpreted
1250 -like the format argument of @command{date} (@pxref{date invocation}).
1251 +like the format argument of @command{date} (@pxref{date}).
1252  For example, @option{--time-style="+%Y-%m-%d %H:%M:%S"} causes
1253  @command{du} to list timestamps like @samp{2002-03-30 23:45:56}.  As
1254  with @command{date}, @var{format}'s interpretation is affected by the
1255 @@ -9910,7 +9890,7 @@
1256  @exitstatus
1257
1258
1259 -@node stat invocation
1260 +@node stat
1261  @section @command{stat}: Report file or file system status
1262
1263  @pindex stat
1264 @@ -10044,7 +10024,7 @@
1265  @exitstatus
1266
1267
1268 -@node sync invocation
1269 +@node sync
1270  @section @command{sync}: Synchronize data on disk with memory
1271
1272  @pindex sync
1273 @@ -10080,13 +10060,13 @@
1274  This section describes commands that display text strings.
1275
1276  @menu
1277 -* echo invocation::             Print a line of text.
1278 -* printf invocation::           Format and print data.
1279 -* yes invocation::              Print a string until interrupted.
1280 +* echo::                        Print a line of text.
1281 +* printf::                      Format and print data.
1282 +* yes::                         Print a string until interrupted.
1283  @end menu
1284
1285
1286 -@node echo invocation
1287 +@node echo
1288  @section @command{echo}: Print a line of text
1289
1290  @pindex echo
1291 @@ -10169,12 +10149,12 @@
1292  @var{string} contains a backslash or if the first argument is
1293  @option{-n}.  Portable programs can use the @command{printf} command
1294  if they need to omit trailing newlines or output control characters or
1295 -backslashes.  @xref{printf invocation}.
1296 +backslashes.  @xref{printf}.
1297
1298  @exitstatus
1299
1300
1301 -@node printf invocation
1302 +@node printf
1303  @section @command{printf}: Format and print data
1304
1305  @pindex printf
1306 @@ -10317,7 +10297,7 @@
1307  @exitstatus
1308
1309
1310 -@node yes invocation
1311 +@node yes
1312  @section @command{yes}: Print a string until interrupted
1313
1314  @pindex yes
1315 @@ -10348,14 +10328,14 @@
1316  pipeline.
1317
1318  @menu
1319 -* false invocation::            Do nothing, unsuccessfully.
1320 -* true invocation::             Do nothing, successfully.
1321 -* test invocation::             Check file types and compare values.
1322 -* expr invocation::             Evaluate expressions.
1323 +* false::                       Do nothing, unsuccessfully.
1324 +* true::                        Do nothing, successfully.
1325 +* test::                        Check file types and compare values.
1326 +* expr::                        Evaluate expressions.
1327  @end menu
1328
1329
1330 -@node false invocation
1331 +@node false
1332  @section @command{false}: Do nothing, unsuccessfully
1333
1334  @pindex false
1335 @@ -10385,7 +10365,7 @@
1336  non-@acronym{GNU} hosts.
1337
1338
1339 -@node true invocation
1340 +@node true
1341  @section @command{true}: Do nothing, successfully
1342
1343  @pindex true
1344 @@ -10421,7 +10401,7 @@
1345  more secure and faster than a shell script implementation, and may safely
1346  be used as a dummy shell for the purpose of disabling accounts.
1347
1348 -@node test invocation
1349 +@node test
1350  @section @command{test}: Check file types and compare values
1351
1352  @pindex test
1353 @@ -10752,7 +10732,7 @@
1354  @end table
1355
1356
1357 -@node expr invocation
1358 +@node expr
1359  @section @command{expr}: Evaluate expressions
1360
1361  @pindex expr
1362 @@ -11025,11 +11005,11 @@
1363  it's described here.
1364
1365  @menu
1366 -* tee invocation::              Redirect output to multiple files or processes.
1367 +* tee::                         Redirect output to multiple files or processes.
1368  @end menu
1369
1370
1371 -@node tee invocation
1372 +@node tee
1373  @section @command{tee}: Redirect output to multiple files or processes
1374
1375  @pindex tee
1376 @@ -11190,13 +11170,13 @@
1377  This section describes commands that manipulate file names.
1378
1379  @menu
1380 -* basename invocation::         Strip directory and suffix from a file name.
1381 -* dirname invocation::          Strip non-directory suffix from a file name.
1382 -* pathchk invocation::          Check file name portability.
1383 +* basename::                    Strip directory and suffix from a file name.
1384 +* dirname::                     Strip non-directory suffix from a file name.
1385 +* pathchk::                     Check file name portability.
1386  @end menu
1387
1388
1389 -@node basename invocation
1390 +@node basename
1391  @section @command{basename}: Strip directory and suffix from a file name
1392
1393  @pindex basename
1394 @@ -11250,7 +11230,7 @@
1395  @end smallexample
1396
1397
1398 -@node dirname invocation
1399 +@node dirname
1400  @section @command{dirname}: Strip non-directory suffix from a file name
1401
1402  @pindex dirname
1403 @@ -11291,7 +11271,7 @@
1404  @end smallexample
1405
1406
1407 -@node pathchk invocation
1408 +@node pathchk
1409  @section @command{pathchk}: Check file name portability
1410
1411  @pindex pathchk
1412 @@ -11379,14 +11359,14 @@
1413  so forth.  See also the user-related commands in the next section.
1414
1415  @menu
1416 -* pwd invocation::              Print working directory.
1417 -* stty invocation::             Print or change terminal characteristics.
1418 -* printenv invocation::         Print environment variables.
1419 -* tty invocation::              Print file name of terminal on standard input.
1420 +* pwd::                         Print working directory.
1421 +* stty::                        Print or change terminal characteristics.
1422 +* printenv::                    Print environment variables.
1423 +* tty::                         Print file name of terminal on standard input.
1424  @end menu
1425
1426
1427 -@node pwd invocation
1428 +@node pwd
1429  @section @command{pwd}: Print working directory
1430
1431  @pindex pwd
1432 @@ -11411,7 +11391,7 @@
1433  @exitstatus
1434
1435
1436 -@node stty invocation
1437 +@node stty
1438  @section @command{stty}: Print or change terminal characteristics
1439
1440  @pindex stty
1441 @@ -12070,7 +12050,7 @@
1442  @end table
1443
1444
1445 -@node printenv invocation
1446 +@node printenv
1447  @section @command{printenv}: Print all or some environment variables
1448
1449  @pindex printenv
1450 @@ -12100,7 +12080,7 @@
1451  @end display
1452
1453
1454 -@node tty invocation
1455 +@node tty
1456  @section @command{tty}: Print file name of terminal on standard input
1457
1458  @pindex tty
1459 @@ -12150,16 +12130,16 @@
1460  logins, groups, and so forth.
1461
1462  @menu
1463 -* id invocation::               Print user identity.
1464 -* logname invocation::          Print current login name.
1465 -* whoami invocation::           Print effective user ID.
1466 -* groups invocation::           Print group names a user is in.
1467 -* users invocation::            Print login names of users currently logged in.
1468 -* who invocation::              Print who is currently logged in.
1469 +* id::                          Print user identity.
1470 +* logname::                     Print current login name.
1471 +* whoami::                      Print effective user ID.
1472 +* groups::                      Print group names a user is in.
1473 +* users::                       Print login names of users currently logged in.
1474 +* who::                         Print who is currently logged in.
1475  @end menu
1476
1477
1478 -@node id invocation
1479 +@node id
1480  @section @command{id}: Print user identity
1481
1482  @pindex id
1483 @@ -12222,7 +12202,7 @@
1484  @exitstatus
1485
1486
1487 -@node logname invocation
1488 +@node logname
1489  @section @command{logname}: Print current login name
1490
1491  @pindex logname
1492 @@ -12243,7 +12223,7 @@
1493  @exitstatus
1494
1495
1496 -@node whoami invocation
1497 +@node whoami
1498  @section @command{whoami}: Print effective user ID
1499
1500  @pindex whoami
1501 @@ -12259,7 +12239,7 @@
1502  @exitstatus
1503
1504
1505 -@node groups invocation
1506 +@node groups
1507  @section @command{groups}: Print group names a user is in
1508
1509  @pindex groups
1510 @@ -12284,7 +12264,7 @@
1511  @exitstatus
1512
1513
1514 -@node users invocation
1515 +@node users
1516  @section @command{users}: Print login names of users currently logged in
1517
1518  @pindex users
1519 @@ -12315,7 +12295,7 @@
1520  @exitstatus
1521
1522
1523 -@node who invocation
1524 +@node who
1525  @section @command{who}: Print who is currently logged in
1526
1527  @pindex who
1528 @@ -12462,15 +12442,14 @@
1529  information.
1530
1531  @menu
1532 -* arch invocation::             Print machine hardware name.
1533 -* date invocation::             Print or set system date and time.
1534 -* uname invocation::            Print system information.
1535 -* hostname invocation::         Print or set system name.
1536 -* hostid invocation::           Print numeric host identifier.
1537 +* arch::                        Print machine hardware name.
1538 +* date::                        Print or set system date and time.
1539 +* uname::                       Print system information.
1540 +* hostid::                      Print numeric host identifier.
1541  @end menu
1542
1543
1544 -@node date invocation
1545 +@node date
1546  @section @command{date}: Print or set system date and time
1547
1548  @pindex date
1549 @@ -13098,7 +13077,7 @@
1550  @end itemize
1551
1552
1553 -@node arch invocation
1554 +@node arch
1555  @section @command{arch}: Print machine hardware name
1556
1557  @pindex arch
1558 @@ -13118,7 +13097,7 @@
1559  @exitstatus
1560
1561
1562 -@node uname invocation
1563 +@node uname
1564  @section @command{uname}: Print system information
1565
1566  @pindex uname
1567 @@ -13247,31 +13226,7 @@
1568  @exitstatus
1569
1570
1571 -@node hostname invocation
1572 -@section @command{hostname}: Print or set system name
1573 -
1574 -@pindex hostname
1575 -@cindex setting the hostname
1576 -@cindex printing the hostname
1577 -@cindex system name, printing
1578 -@cindex appropriate privileges
1579 -
1580 -With no arguments, @command{hostname} prints the name of the current host
1581 -system.  With one argument, it sets the current host name to the
1582 -specified string.  You must have appropriate privileges to set the host
1583 -name.  Synopsis:
1584 -
1585 -@example
1586 -hostname [@var{name}]
1587 -@end example
1588 -
1589 -The only options are @option{--help} and @option{--version}.  @xref{Common
1590 -options}.
1591 -
1592 -@exitstatus
1593 -
1594 -
1595 -@node hostid invocation
1596 +@node hostid
1597  @section @command{hostid}: Print numeric host identifier.
1598
1599  @pindex hostid
1600 @@ -13308,15 +13263,15 @@
1601  user, etc.
1602
1603  @menu
1604 -* chroot invocation::           Modify the root directory.
1605 -* env invocation::              Modify environment variables.
1606 -* nice invocation::             Modify niceness.
1607 -* nohup invocation::            Immunize to hangups.
1608 -* su invocation::               Modify user and group ID.
1609 +* chroot::                      Modify the root directory.
1610 +* env::                         Modify environment variables.
1611 +* nice::                        Modify niceness.
1612 +* nohup::                       Immunize to hangups.
1613 +* su::                          Modify user and group ID.
1614  @end menu
1615
1616
1617 -@node chroot invocation
1618 +@node chroot
1619  @section @command{chroot}: Run a command with a different root directory
1620
1621  @pindex chroot
1622 @@ -13387,7 +13342,7 @@
1623  @end display
1624
1625
1626 -@node env invocation
1627 +@node env
1628  @section @command{env}: Run a command in a modified environment
1629
1630  @pindex env
1631 @@ -13465,7 +13420,7 @@
1632  @end display
1633
1634
1635 -@node nice invocation
1636 +@node nice
1637  @section @command{nice}: Run a command with modified niceness
1638
1639  @pindex nice
1640 @@ -13590,7 +13545,7 @@
1641  @end example
1642
1643
1644 -@node nohup invocation
1645 +@node nohup
1646  @section @command{nohup}: Run a command immune to hangups
1647
1648  @pindex nohup
1649 @@ -13659,7 +13614,7 @@
1650  @end display
1651
1652
1653 -@node su invocation
1654 +@node su
1655  @section @command{su}: Run a command with substitute user and group ID
1656
1657  @pindex su
1658 @@ -13816,167 +13771,6 @@
1659  might find this idea strange at first.
1660
1661
1662 -@node Process control
1663 -@chapter Process control
1664 -
1665 -@cindex processes, commands for controlling
1666 -@cindex commands for controlling processes
1667 -
1668 -@menu
1669 -* kill invocation::             Sending a signal to processes.
1670 -@end menu
1671 -
1672 -
1673 -@node kill invocation
1674 -@section @command{kill}: Send a signal to processes
1675 -
1676 -@pindex kill
1677 -@cindex send a signal to processes
1678 -
1679 -The @command{kill} command sends a signal to processes, causing them
1680 -to terminate or otherwise act upon receiving the signal in some way.
1681 -Alternatively, it lists information about signals.  Synopses:
1682 -
1683 -@example
1684 -kill [-s @var{signal} | --signal @var{signal} | -@var{signal}] @var{pid}@dots{}
1685 -kill [-l | --list | -t | --table] [@var{signal}]@dots{}
1686 -@end example
1687 -
1688 -The first form of the @command{kill} command sends a signal to all
1689 -@var{pid} arguments.  The default signal to send if none is specified
1690 -is @samp{TERM}.  The special signal number @samp{0} does not denote a
1691 -valid signal, but can be used to test whether the @var{pid} arguments
1692 -specify processes to which a signal could be sent.
1693 -
1694 -If @var{pid} is positive, the signal is sent to the process with the
1695 -process ID @var{pid}.  If @var{pid} is zero, the signal is sent to all
1696 -processes in the process group of the current process.  If @var{pid}
1697 -is @minus{}1, the signal is sent to all processes for which the user has
1698 -permission to send a signal.  If @var{pid} is less than @minus{}1, the signal
1699 -is sent to all processes in the process group that equals the absolute
1700 -value of @var{pid}.
1701 -
1702 -If @var{pid} is not positive, a system-dependent set of system
1703 -processes is excluded from the list of processes to which the signal
1704 -is sent.
1705 -
1706 -If a negative @var{PID} argument is desired as the first one, it
1707 -should be preceded by @option{--}.  However, as a common extension to
1708 -@acronym{POSIX}, @option{--} is not required with @samp{kill
1709 --@var{signal} -@var{pid}}.  The following commands are equivalent:
1710 -
1711 -@example
1712 -kill -15 -1
1713 -kill -TERM -1
1714 -kill -s TERM -- -1
1715 -kill -- -1
1716 -@end example
1717 -
1718 -The first form of the @command{kill} command succeeds if every @var{pid}
1719 -argument specifies at least one process that the signal was sent to.
1720 -
1721 -The second form of the @command{kill} command lists signal information.
1722 -Either the @option{-l} or @option{--list} option, or the @option{-t}
1723 -or @option{--table} option must be specified.  Without any
1724 -@var{signal} argument, all supported signals are listed.  The output
1725 -of @option{-l} or @option{--list} is a list of the signal names, one
1726 -per line; if @var{signal} is already a name, the signal number is
1727 -printed instead.  The output of @option{-t} or @option{--table} is a
1728 -table of signal numbers, names, and descriptions.  This form of the
1729 -@command{kill} command succeeds if all @var{signal} arguments are valid
1730 -and if there is no output error.
1731 -
1732 -The @command{kill} command also supports the @option{--help} and
1733 -@option{--version} options.  @xref{Common options}.
1734 -
1735 -A @var{signal} may be a signal name like @samp{HUP}, or a signal
1736 -number like @samp{1}, or an exit status of a process terminated by the
1737 -signal.  A signal name can be given in canonical form or prefixed by
1738 -@samp{SIG}.  The case of the letters is ignored, except for the
1739 -@option{-@var{signal}} option which must use upper case to avoid
1740 -ambiguity with lower case option letters.  The following signal names
1741 -and numbers are supported on all @acronym{POSIX} compliant systems:
1742 -
1743 -@table @samp
1744 -@item HUP
1745 -1.  Hangup.
1746 -@item INT
1747 -2.  Terminal interrupt.
1748 -@item QUIT
1749 -3.  Terminal quit.
1750 -@item ABRT
1751 -6.  Process abort.
1752 -@item KILL
1753 -9.  Kill (cannot be caught or ignored).
1754 -@item ALRM
1755 -14.  Alarm Clock.
1756 -@item TERM
1757 -15.  Termination.
1758 -@end table
1759 -
1760 -@noindent
1761 -Other supported signal names have system-dependent corresponding
1762 -numbers.  All systems conforming to @acronym{POSIX} 1003.1-2001 also
1763 -support the following signals:
1764 -
1765 -@table @samp
1766 -@item BUS
1767 -Access to an undefined portion of a memory object.
1768 -@item CHLD
1769 -Child process terminated, stopped, or continued.
1770 -@item CONT
1771 -Continue executing, if stopped.
1772 -@item FPE
1773 -Erroneous arithmetic operation.
1774 -@item ILL
1775 -Illegal Instruction.
1776 -@item PIPE
1777 -Write on a pipe with no one to read it.
1778 -@item SEGV
1779 -Invalid memory reference.
1780 -@item STOP
1781 -Stop executing (cannot be caught or ignored).
1782 -@item TSTP
1783 -Terminal stop.
1784 -@item TTIN
1785 -Background process attempting read.
1786 -@item TTOU
1787 -Background process attempting write.
1788 -@item URG
1789 -High bandwidth data is available at a socket.
1790 -@item USR1
1791 -User-defined signal 1.
1792 -@item USR2
1793 -User-defined signal 2.
1794 -@end table
1795 -
1796 -@noindent
1797 -@acronym{POSIX} 1003.1-2001 systems that support the @acronym{XSI} extension
1798 -also support the following signals:
1799 -
1800 -@table @samp
1801 -@item POLL
1802 -Pollable event.
1803 -@item PROF
1804 -Profiling timer expired.
1805 -@item SYS
1806 -Bad system call.
1807 -@item TRAP
1808 -Trace/breakpoint trap.
1809 -@item VTALRM
1810 -Virtual timer expired.
1811 -@item XCPU
1812 -CPU time limit exceeded.
1813 -@item XFSZ
1814 -File size limit exceeded.
1815 -@end table
1816 -
1817 -@noindent
1818 -@acronym{POSIX} 1003.1-2001 systems that support the @acronym{XRT} extension
1819 -also support at least eight real-time signals called @samp{RTMIN},
1820 -@samp{RTMIN+1}, @dots{}, @samp{RTMAX-1}, @samp{RTMAX}.
1821 -
1822 -
1823  @node Delaying
1824  @chapter Delaying
1825
1826 @@ -13986,11 +13780,11 @@
1827  @c Perhaps @command{wait} or other commands should be described here also?
1828
1829  @menu
1830 -* sleep invocation::            Delay for a specified time.
1831 +* sleep::                       Delay for a specified time.
1832  @end menu
1833
1834
1835 -@node sleep invocation
1836 +@node sleep
1837  @section @command{sleep}: Delay for a specified time
1838
1839  @pindex sleep
1840 @@ -14038,12 +13832,12 @@
1841  These programs do numerically-related operations.
1842
1843  @menu
1844 -* factor invocation::              Show factors of numbers.
1845 -* seq invocation::                 Print sequences of numbers.
1846 +* factor::                         Show factors of numbers.
1847 +* seq::                            Print sequences of numbers.
1848  @end menu
1849
1850
1851 -@node factor invocation
1852 +@node factor
1853  @section @command{factor}: Print prime factors
1854
1855  @pindex factor
1856 @@ -14092,7 +13886,7 @@
1857  @exitstatus
1858
1859
1860 -@node seq invocation
1861 +@node seq
1862  @section @command{seq}: Print numeric sequences
1863
1864  @pindex seq