---- coreutils-4.5.9/doc/coreutils.texi.orig Sun Mar 2 19:09:14 2003
-+++ coreutils-4.5.9/doc/coreutils.texi Thu Mar 6 23:36:08 2003
-@@ -20,102 +20,91 @@
+--- coreutils-6.3/doc/coreutils.texi.orig 2006-09-26 21:17:33.000000000 +0200
++++ coreutils-6.3/doc/coreutils.texi 2006-10-10 20:11:23.333708500 +0200
+@@ -20,111 +20,97 @@
@syncodeindex pg cp
@syncodeindex vr cp
-* Date input formats: (coreutils)Date input formats.
-@end direntry
-
+-@c FIXME: the following need documentation
+-@c * [: (coreutils)[ invocation. File/string tests.
+-@c * pinky: (coreutils)pinky invocation. FIXME.
+-@c * uptime: (coreutils)uptime invocation. FIXME.
+-
-@dircategory Individual utilities
-@direntry
+-* base64: (coreutils)base64 invocation. Base64 encode/decode data.
-* basename: (coreutils)basename invocation. Strip directory and suffix.
-* cat: (coreutils)cat invocation. Concatenate and write files.
-* chgrp: (coreutils)chgrp invocation. Change file groups.
-* cut: (coreutils)cut invocation. Print selected parts of lines.
-* date: (coreutils)date invocation. Print/set system date and time.
-* dd: (coreutils)dd invocation. Copy and convert a file.
--* df: (coreutils)df invocation. Report filesystem disk usage.
+-* df: (coreutils)df invocation. Report file system disk usage.
-* dir: (coreutils)dir invocation. List directories briefly.
-* dircolors: (coreutils)dircolors invocation. Color setup for ls.
-* dirname: (coreutils)dirname invocation. Strip non-directory suffix.
-* head: (coreutils)head invocation. Output the first part of files.
-* hostid: (coreutils)hostid invocation. Print numeric host identifier.
-* hostname: (coreutils)hostname invocation. Print or set system name.
--* id: (coreutils)id invocation. Print real/effective uid/gid.
+-* id: (coreutils)id invocation. Print user identity.
-* install: (coreutils)install invocation. Copy and change attributes.
-* join: (coreutils)join invocation. Join lines on a common field.
-* kill: (coreutils)kill invocation. Send a signal to processes.
-* ln: (coreutils)ln invocation. Make links between files.
-* logname: (coreutils)logname invocation. Print current login name.
-* ls: (coreutils)ls invocation. List directory contents.
--* md5sum: (coreutils)md5sum invocation. Print or check message-digests.
+-* md5sum: (coreutils)md5sum invocation. Print or check MD5 digests.
-* mkdir: (coreutils)mkdir invocation. Create directories.
-* mkfifo: (coreutils)mkfifo invocation. Create FIFOs (named pipes).
-* mknod: (coreutils)mknod invocation. Create special files.
-* mv: (coreutils)mv invocation. Rename files.
--* nice: (coreutils)nice invocation. Modify scheduling priority.
+-* nice: (coreutils)nice invocation. Modify niceness.
-* nl: (coreutils)nl invocation. Number lines and write files.
-* nohup: (coreutils)nohup invocation. Immunize to hangups.
-* od: (coreutils)od invocation. Dump files in octal, etc.
-* rm: (coreutils)rm invocation. Remove files.
-* rmdir: (coreutils)rmdir invocation. Remove empty directories.
-* seq: (coreutils)seq invocation. Print numeric sequences
+-* sha1sum: (coreutils)sha1sum invocation. Print or check SHA-1 digests.
+-* sha2: (coreutils)sha2 utilities. Print or check SHA-2 digests.
-* shred: (coreutils)shred invocation. Remove files more securely.
+-* shuf: (coreutils)shuf invocation. Shuffling text files.
-* sleep: (coreutils)sleep invocation. Delay for a specified time.
-* sort: (coreutils)sort invocation. Sort text files.
-* split: (coreutils)split invocation. Split into fixed-size pieces.
-* stat: (coreutils)stat invocation. Report file(system) status.
-* stty: (coreutils)stty invocation. Print/change terminal settings.
--* su: (coreutils)su invocation. Modify user and group id.
+-* su: (coreutils)su invocation. Modify user and group ID.
-* sum: (coreutils)sum invocation. Print traditional checksum.
-* sync: (coreutils)sync invocation. Synchronize memory and disk.
-* tac: (coreutils)tac invocation. Reverse files.
-* unlink: (coreutils)unlink invocation. Removal via unlink(2).
-* users: (coreutils)users invocation. Print current user names.
-* vdir: (coreutils)vdir invocation. List directories verbosely.
--* wc: (coreutils)wc invocation. Byte, word, and line counts.
+-* wc: (coreutils)wc invocation. Line, word, and byte counts.
-* who: (coreutils)who invocation. Print who is logged in.
--* whoami: (coreutils)whoami invocation. Print effective user id.
+-* whoami: (coreutils)whoami invocation. Print effective user ID.
-* yes: (coreutils)yes invocation. Print a string indefinitely.
++* Coreutils: (coreutils). Core GNU (file, text, shell) utilities
++* base64: (coreutils)base64. Base64 encode/decode data
+* basename: (coreutils)basename. Strip directory and suffix
+* cat: (coreutils)cat. Concatenate and write files
+* chgrp: (coreutils)chgrp. Change file groups
+* cut: (coreutils)cut. Print selected parts of lines
+* date: (coreutils)date. Print/set system date and time
+* dd: (coreutils)dd. Copy and convert a file
-+* df: (coreutils)df. Report filesystem disk usage
++* df: (coreutils)df. Report file system disk usage
+* dir: (coreutils)dir. List directories briefly
+* dircolors: (coreutils)dircolors. Color setup for ls
+* dirname: (coreutils)dirname. Strip non-directory suffix
+* false: (coreutils)false. Do nothing, unsuccessfully
+* fmt: (coreutils)fmt. Reformat paragraph text
+* fold: (coreutils)fold. Wrap long input lines
++* groups: (coreutils)groups. Print group names a user is in
+* head: (coreutils)head. Output the first part of files
+* hostid: (coreutils)hostid. Print numeric host identifier
-+* id: (coreutils)id. Print real/effective uid/gid
++* id: (coreutils)id. Print user identity
+* install: (coreutils)install. Copy and change attributes
+* join: (coreutils)join. Join lines on a common field
+* link: (coreutils)link. Make hard links between files
+* ln: (coreutils)ln. Make links between files
+* logname: (coreutils)logname. Print current login name
+* ls: (coreutils)ls. List directory contents
-+* md5sum: (coreutils)md5sum. Print or check message-digests
++* md5sum: (coreutils)md5sum. Print or check MD5 digests
+* mkdir: (coreutils)mkdir. Create directories
+* mkfifo: (coreutils)mkfifo. Create FIFOs (named pipes)
+* mknod: (coreutils)mknod. Create special files
+* mv: (coreutils)mv. Rename files
-+* nice: (coreutils)nice. Modify scheduling priority
++* nice: (coreutils)nice. Modify niceness
+* nl: (coreutils)nl. Number lines and write files
+* nohup: (coreutils)nohup. Immunize to hangups
-+* od: (coreutils)od. Dump files in octal, etc.
++* 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
+* rm: (coreutils)rm. Remove files
+* rmdir: (coreutils)rmdir. Remove empty directories
+* seq: (coreutils)seq. Print numeric sequences
++* sha1sum: (coreutils)sha1sum. Print or check SHA-1 digests
++* sha2: (coreutils)sha2. Print or check SHA-2 digests
+* shred: (coreutils)shred. Remove files more securely
++* shuf: (coreutils)shuf. Shuffling text files
+* sleep: (coreutils)sleep. Delay for a specified time
+* sort: (coreutils)sort. Sort text files
+* split: (coreutils)split. Split into fixed-size pieces
+* stat: (coreutils)stat. Report file(system) status
+* stty: (coreutils)stty. Print/change terminal settings
-+* su: (coreutils)su. Modify user and group id
++* su: (coreutils)su. Modify user and group ID
+* sum: (coreutils)sum. Print traditional checksum
+* sync: (coreutils)sync. Synchronize memory and disk
+* tac: (coreutils)tac. Reverse files
+* unlink: (coreutils)unlink. Removal via unlink(2)
+* users: (coreutils)users. Print current user names
+* vdir: (coreutils)vdir. List directories verbosely
-+* wc: (coreutils)wc. Byte, word, and line counts
++* wc: (coreutils)wc. Line, word, and byte counts
+* who: (coreutils)who. Print who is logged in
-+* whoami: (coreutils)whoami. Print effective user id
++* whoami: (coreutils)whoami. Print effective user ID
+* yes: (coreutils)yes. Print a string indefinitely
@end direntry
@copying
-@@ -179,10 +168,9 @@
- * Redirection:: tee
+@@ -189,9 +175,8 @@
* File name manipulation:: dirname basename pathchk
* Working context:: pwd stty printenv tty
--* User information:: id logname whoami groups users who
--* System context:: date uname hostname
-+* User information:: id logname whoami users who
-+* System context:: date uname
+ * User information:: id logname whoami groups users who
+-* System context:: date uname hostname hostid
++* System context:: date uname hostid
* Modified command invocation:: chroot env nice nohup su
-* Process control:: kill
* Delaying:: sleep
* Numeric operations:: factor seq
* File permissions:: Access modes.
-@@ -205,38 +193,38 @@
+@@ -217,42 +202,42 @@
Output of entire files
-* tac invocation:: Concatenate and write files in reverse.
-* nl invocation:: Number lines and write files.
-* od invocation:: 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.
++* base64:: Transform data into printable data.
Formatting file contents
Summarizing files
--* wc invocation:: Print byte, word, and line counts.
+-* wc invocation:: Print newline, word, and byte counts.
-* sum invocation:: Print checksum and block counts.
-* cksum invocation:: Print CRC checksum and byte counts.
--* md5sum invocation:: Print or check message-digests.
-+* wc:: Print byte, word, and line counts.
+-* md5sum invocation:: Print or check MD5 digests.
+-* sha1sum invocation:: Print or check SHA-1 digests.
+-* sha2 utilities:: Print or check SHA-2 digests.
++* wc:: Print newline, word, and byte counts.
+* sum:: Print checksum and block counts.
+* cksum:: Print CRC checksum and byte counts.
-+* md5sum:: Print or check message-digests.
++* md5sum:: Print or check MD5 digests.
++* sha1sum:: Print or check SHA-1 digests.
++* sha2:: Print or check SHA-2 digests.
Operating on sorted files
-* sort invocation:: Sort text files.
+-* shuf invocation:: Shuffle text files.
-* uniq invocation:: Uniquify files.
-* comm invocation:: Compare two sorted files line by line.
-* ptx invocation:: Produce a permuted index of file contents.
-* tsort invocation:: Topological sort.
+* sort:: Sort text files.
++* shuf:: Shuffle text files.
+* uniq:: Uniquify files.
+* comm:: Compare two sorted files line by line.
+* ptx:: Produce a permuted index of file contents.
@command{ptx}: Produce permuted indexes
-@@ -248,15 +236,15 @@
+@@ -264,15 +249,15 @@
Operating on fields within a line
@command{tr}: Translate, squeeze, and/or delete characters
-@@ -267,10 +255,10 @@
+@@ -282,10 +267,10 @@
Directory listing
@command{ls}: List directory contents
-@@ -283,50 +271,50 @@
+@@ -298,50 +283,50 @@
Basic operations
Disk usage
--* df invocation:: Report filesystem disk space usage
+-* df invocation:: Report file system disk space usage
-* du invocation:: Estimate file space usage
--* stat invocation:: Report file or filesystem status
+-* stat invocation:: Report file or file system status
-* sync invocation:: Synchronize data on disk with memory
-+* df:: Report filesystem disk space usage
++* df:: Report file system disk space usage
+* du:: Estimate file space usage
-+* stat:: Report file or filesystem status
++* stat:: Report file or file system status
+* sync:: Synchronize data on disk with memory
Printing text
@command{test}: Check file types and compare values
-@@ -345,20 +333,20 @@
+@@ -360,20 +345,20 @@
Redirection
@command{stty}: Print or change terminal characteristics
-@@ -372,19 +360,17 @@
+@@ -387,19 +372,18 @@
User information
--* id invocation:: Print real and effective uid and gid
+-* id invocation:: Print user identity
-* logname invocation:: Print current login name
--* whoami invocation:: Print effective user id
+-* whoami invocation:: Print effective user ID
-* groups invocation:: Print group names a user is in
-* users invocation:: Print login names of users currently logged in
-* who invocation:: Print who is currently logged in
-+* id:: Print real and effective uid and gid
++* id:: Print user identity
+* logname:: Print current login name
-+* whoami:: Print effective user id
++* whoami:: Print effective user ID
++* groups:: Print group names a user is in
+* users:: Print login names of users currently logged in
+* who:: Print who is currently logged in
-* hostid invocation:: Print numeric host identifier.
+* date:: Print or set system date and time
+* uname:: Print system information
-+* hostid:: Print numeric host identifier
++* hostid:: Print numeric host identifier.
@command{date}: Print or set system date and time
-@@ -398,24 +384,20 @@
+@@ -413,24 +397,20 @@
Modified command invocation
-* chroot invocation:: Run a command with a different root directory
-* env invocation:: Run a command in a modified environment
--* nice invocation:: Run a command with modified scheduling priority
+-* nice invocation:: Run a command with modified niceness
-* nohup invocation:: Run a command immune to hangups
--* su invocation:: Run a command with substitute user and group id
+-* su invocation:: Run a command with substitute user and group ID
-
-Process control
-
-* kill invocation:: Sending a signal to processes.
+* chroot:: Run a command with a different root directory
+* env:: Run a command in a modified environment
-+* nice:: Run a command with modified scheduling priority
++* nice:: Run a command with modified niceness
+* nohup:: Run a command immune to hangups
-+* su:: Run a command with substitute user and group id
++* su:: Run a command with substitute user and group ID
Delaying
File permissions
-@@ -936,13 +918,13 @@
+@@ -1227,14 +1207,14 @@
in some way.
@menu
-* tac invocation:: Concatenate and write files in reverse.
-* nl invocation:: Number lines and write files.
-* od invocation:: 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.
++* base64:: Transform data into printable data.
@end menu
-@node cat invocation
@section @command{cat}: Concatenate and write files
@pindex cat
-@@ -1048,7 +1030,7 @@
- @end table
+@@ -1332,7 +1312,7 @@
+ @end smallexample
-@node tac invocation
@section @command{tac}: Concatenate and write files in reverse
@pindex tac
-@@ -1095,7 +1077,7 @@
- @end table
+@@ -1381,7 +1361,7 @@
+ @exitstatus
-@node nl invocation
@section @command{nl}: Number lines and write files
@pindex nl
-@@ -1254,7 +1236,7 @@
- @end table
+@@ -1544,7 +1524,7 @@
+ @exitstatus
-@node od invocation
@section @command{od}: Write files in octal or other formats
@pindex od
-@@ -1509,13 +1491,13 @@
+@@ -1795,7 +1775,7 @@
+
+ @exitstatus
+
+-@node base64 invocation
++@node base64
+ @section @command{base64}: Transform data into printable data.
+
+ @pindex base64
+@@ -1861,13 +1841,13 @@
These commands reformat the contents of files.
@menu
@section @command{fmt}: Reformat paragraph text
@pindex fmt
-@@ -1611,7 +1593,7 @@
- @end table
+@@ -1966,7 +1946,7 @@
+ @exitstatus
-@node pr invocation
@section @command{pr}: Paginate or columnate files for printing
@pindex pr
-@@ -1753,7 +1735,7 @@
+@@ -2108,7 +2088,7 @@
@cindex time formats
@cindex formatting times
Format header dates using @var{format}, using the same conventions as
--for the the command @samp{date +@var{format}}; @xref{date invocation}.
-+for the 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,
-@@ -1980,7 +1962,7 @@
- @end table
+@@ -2337,7 +2317,7 @@
+ @exitstatus
-@node fold invocation
@section @command{fold}: Wrap input lines to fit in specified width
@pindex fold
-@@ -2046,13 +2028,13 @@
+@@ -2404,13 +2384,13 @@
These commands output pieces of the input.
@menu
@section @command{head}: Output the first part of files
@pindex head
-@@ -2117,7 +2099,7 @@
- @acronym{POSIX} 1003.1-2001 (@pxref{Standards conformance}) does not allow
- this; use @option{-c @var{count}} or @option{-n @var{count}} instead.
+@@ -2487,7 +2467,7 @@
+ @exitstatus
+
-@node tail invocation
+@node tail
@section @command{tail}: Output the last part of files
@pindex tail
-@@ -2292,7 +2274,7 @@
- conformance}) does not allow these options; use @option{-c
- @var{count}} or @option{-n @var{count}} instead.
+@@ -2698,7 +2678,7 @@
+ @exitstatus
+
-@node split invocation
+@node split
@section @command{split}: Split a file into fixed-size pieces
@pindex split
-@@ -2365,7 +2347,7 @@
- @end table
+@@ -2779,7 +2759,7 @@
+ @exitstatus
-@node csplit invocation
@section @command{csplit}: Split a file into context-determined pieces
@pindex csplit
-@@ -2503,14 +2485,14 @@
+@@ -2919,16 +2899,16 @@
contents of files.
@menu
--* wc invocation:: Print byte, word, and line counts.
+-* wc invocation:: Print newline, word, and byte counts.
-* sum invocation:: Print checksum and block counts.
-* cksum invocation:: Print CRC checksum and byte counts.
--* md5sum invocation:: Print or check message-digests.
-+* wc:: Print byte, word, and line counts.
+-* md5sum invocation:: Print or check MD5 digests.
+-* sha1sum invocation:: Print or check SHA-1 digests.
+-* sha2 utilities:: Print or check SHA-2 digests.
++* wc:: Print newline, word, and byte counts.
+* sum:: Print checksum and block counts.
+* cksum:: Print CRC checksum and byte counts.
-+* md5sum:: Print or check message-digests.
++* md5sum:: Print or check MD5 digests.
++* sha1sum:: Print or check SHA-1 digests.
++* sha2:: Print or check SHA-2 digests.
@end menu
-@node wc invocation
+@node wc
- @section @command{wc}: Print byte, word, and line counts
+ @section @command{wc}: Print newline, word, and byte counts
@pindex wc
-@@ -2592,7 +2574,7 @@
- @end table
+@@ -3034,7 +3014,7 @@
+ @exitstatus
-@node sum invocation
@section @command{sum}: Print checksum and block counts
@pindex sum
-@@ -2641,7 +2623,7 @@
- next section) is preferable in new applications.
+@@ -3085,7 +3065,7 @@
+ @exitstatus
-@node cksum invocation
@section @command{cksum}: Print CRC checksum and byte counts
@pindex cksum
-@@ -2673,7 +2655,7 @@
- options}.
+@@ -3119,7 +3099,7 @@
+ @exitstatus
-@node md5sum invocation
+@node md5sum
- @section @command{md5sum}: Print or check message-digests
+ @section @command{md5sum}: Print or check MD5 digests
@pindex md5sum
-@@ -2778,16 +2760,16 @@
+@@ -3141,8 +3121,8 @@
+ considered infeasible at the moment, it is known how to produce
+ different files with identical MD5 (a ``collision''), something which
+ can be a security issue in certain contexts. For more secure hashes,
+-consider using SHA-1 or SHA-2. @xref{sha1sum invocation}, and
+-@ref{sha2 utilities}.
++consider using SHA-1 or SHA-2. @xref{sha1sum}, and
++@ref{sha2}.
+
+ If a @var{file} is specified as @samp{-} or if no files are given
+ @command{md5sum} computes the checksum for the standard input.
+@@ -3236,7 +3216,7 @@
+ @exitstatus
+
+
+-@node sha1sum invocation
++@node sha1sum
+ @section @command{sha1sum}: Print or check SHA-1 digests
+
+ @pindex sha1sum
+@@ -3248,17 +3228,17 @@
+
+ @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,
+ it is known that they can be produced with considerable, but not
+ unreasonable, resources. For this reason, it is generally considered
+ that SHA-1 should be gradually phased out in favor of the more secure
+-SHA-2 hash algorithms. @xref{sha2 utilities}.
++SHA-2 hash algorithms. @xref{sha2}.
+
+
+-@node sha2 utilities
++@node sha2
+ @section sha2 utilities: Print or check SHA-2 digests
+
+ @pindex sha224sum
+@@ -3288,7 +3268,7 @@
+ various lengths (respectively 224, 256, 384 and 512 bits),
+ collectively known as the SHA-2 hashes. The usage and options of
+ these commands are precisely the same as for @command{md5sum}.
+-@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.
+@@ -3303,17 +3283,17 @@
These commands work with (or produce) sorted files.
@menu
-* sort invocation:: Sort text files.
+-* shuf invocation:: Shuffle text files.
-* uniq invocation:: Uniquify files.
-* comm invocation:: Compare two sorted files line by line.
-* ptx invocation:: Produce a permuted index of file contents.
-* tsort invocation:: Topological sort.
+* sort:: Sort text files.
++* shuf:: Shuffle text files.
+* uniq:: Uniquify files.
+* comm:: Compare two sorted files line by line.
+* ptx:: Produce a permuted index of file contents.
@section @command{sort}: Sort text files
@pindex sort
-@@ -3240,7 +3222,7 @@
+@@ -3555,7 +3535,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
+-like a random permutation of the inputs (@pxref{shuf invocation}),
++like a random permutation of the inputs (@pxref{shuf}),
+ except that keys with the same value sort together.
+
+ If multiple random sort fields are specified, the same random hash
+@@ -3694,7 +3674,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}.
+
+ @item -z
+ @itemx --zero-terminated
+@@ -3895,7 +3875,7 @@
@end itemize
+-@node shuf invocation
++@node shuf
+ @section @command{shuf}: Shuffling text
+
+ @pindex shuf
+@@ -4036,7 +4016,7 @@
+ @exitstatus
+
+
-@node uniq invocation
+@node uniq
@section @command{uniq}: Uniquify files
@pindex uniq
-@@ -3369,7 +3351,7 @@
- @end table
+@@ -4058,7 +4038,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}.
+-@xref{sort invocation}.
++@xref{sort}.
+
+ @vindex LC_COLLATE
+ Comparisons use the character collating sequence specified by the
+@@ -4179,7 +4159,7 @@
+ @exitstatus
-@node comm invocation
@section @command{comm}: Compare two sorted files line by line
@pindex comm
-@@ -3412,7 +3394,7 @@
+@@ -4222,7 +4202,7 @@
If there is an error it exits with nonzero status.
@section @command{tsort}: Topological sort
@pindex tsort
-@@ -3563,7 +3545,7 @@
- the way the linker handled archive files, which has since been solved
- in different ways.
+@@ -4376,7 +4356,7 @@
+ @exitstatus
+
-@node ptx invocation
+@node ptx
@section @command{ptx}: Produce permuted indexes
@pindex ptx
-@@ -4030,13 +4012,13 @@
+@@ -4835,13 +4815,13 @@
@chapter Operating on fields within a line
@menu
@section @command{cut}: Print selected parts of lines
@pindex cut
-@@ -4124,7 +4106,7 @@
- @end table
+@@ -4940,7 +4920,7 @@
+ @exitstatus
-@node paste invocation
@section @command{paste}: Merge lines of files
@pindex paste
-@@ -4192,7 +4174,7 @@
- @end table
+@@ -5010,7 +4990,7 @@
+ @exitstatus
-@node join invocation
@section @command{join}: Join lines on a common field
@pindex join
-@@ -4325,13 +4307,13 @@
+@@ -5153,13 +5133,13 @@
This commands operate on individual characters.
@menu
@section @command{tr}: Translate, squeeze, and/or delete characters
@pindex tr
-@@ -4715,7 +4697,7 @@
- Unix versions, which provide no way to preserve zero bytes.
+@@ -5537,7 +5517,7 @@
+ @end itemize
-@node expand invocation
@section @command{expand}: Convert tabs to spaces
@pindex expand
-@@ -4768,7 +4750,7 @@
- @end table
+@@ -5590,7 +5570,7 @@
+ @exitstatus
-@node unexpand invocation
@section @command{unexpand}: Convert spaces to tabs
@pindex unexpand
-@@ -4827,14 +4809,14 @@
+@@ -5651,14 +5631,14 @@
and @command{vdir}, which list information about files.
@menu
@section @command{ls}: List directory contents
@pindex ls
-@@ -5529,7 +5511,7 @@
+@@ -6456,7 +6436,7 @@
@item +@var{format}
@vindex LC_TIME
List timestamps using @var{format}, where @var{format} is interpreted
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
-@@ -5704,7 +5686,7 @@
+@@ -6648,7 +6628,7 @@
@end table
@section @command{dir}: Briefly list directory contents
@pindex dir
-@@ -5714,10 +5696,10 @@
+@@ -6658,10 +6638,10 @@
-b}; that is, by default files are listed in columns, sorted vertically,
and special characters are represented by backslash escape sequences.
@section @command{vdir}: Verbosely list directory contents
@pindex vdir
-@@ -5727,7 +5709,7 @@
+@@ -6671,7 +6651,7 @@
-b}; that is, by default files are listed in long format and special
characters are represented by backslash escape sequences.
@section @command{dircolors}: Color setup for @command{ls}
@pindex dircolors
-@@ -5803,16 +5785,16 @@
+@@ -6749,16 +6729,16 @@
copying, moving (renaming), and deleting (removing).
@menu
@section @command{cp}: Copy files and directories
@pindex cp
-@@ -6152,7 +6134,7 @@
- @end table
+@@ -7116,7 +7096,7 @@
+ @exitstatus
-@node dd invocation
@section @command{dd}: Convert and copy a file
@pindex dd
-@@ -6305,7 +6287,7 @@
- @end table
+@@ -7435,7 +7415,7 @@
+ @exitstatus
-@node install invocation
@section @command{install}: Copy files and set attributes
@pindex install
-@@ -6446,7 +6428,7 @@
- @end table
+@@ -7574,7 +7554,7 @@
+ @exitstatus
-@node mv invocation
@section @command{mv}: Move (rename) files
@pindex mv
-@@ -6574,7 +6556,7 @@
- @end table
+@@ -7695,7 +7675,7 @@
+ @exitstatus
-@node rm invocation
@section @command{rm}: Remove files or directories
@pindex rm
-@@ -6673,7 +6655,7 @@
- predates the development of the getopt standard syntax.
+@@ -7831,7 +7811,7 @@
+ @exitstatus
-@node shred invocation
@section @command{shred}: Remove files more securely
@pindex shred
-@@ -6683,7 +6665,7 @@
+@@ -7841,7 +7821,7 @@
@command{shred} overwrites devices or files, to help prevent even
very expensive hardware from recovering the data.
not actually destroyed. Only the index listing where the file is
stored is destroyed, and the storage is made available for reuse.
There are undelete utilities that will attempt to reconstruct the index
-@@ -6903,18 +6885,18 @@
+@@ -8073,18 +8053,18 @@
(FIFOs), symbolic links, sockets, and so-called @dfn{special files}.
@menu
@section @command{link}: Make a hard link via the link syscall
@pindex link
-@@ -6937,7 +6919,7 @@
- @command{link} simply calls @code{link (@var{filename}, @var{linkname})}
- to create the link.
+@@ -8097,7 +8077,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
+-@command{ln} command (@pxref{ln invocation}).
++@command{ln} command (@pxref{ln}).
+ Synopsis:
+
+ @example
+@@ -8118,7 +8098,7 @@
+ @exitstatus
+
-@node ln invocation
+@node ln
@section @command{ln}: Make links between files
@pindex ln
-@@ -7098,7 +7080,7 @@
+@@ -8290,7 +8270,7 @@
@end smallexample
@section @command{mkdir}: Make directories
@pindex mkdir
-@@ -7152,7 +7134,7 @@
- @end table
+@@ -8352,7 +8332,7 @@
+ @exitstatus
-@node mkfifo invocation
@section @command{mkfifo}: Make FIFOs (named pipes)
@pindex mkfifo
-@@ -7188,7 +7170,7 @@
- @end table
+@@ -8391,7 +8371,7 @@
+ @exitstatus
-@node mknod invocation
@section @command{mknod}: Make block or character special files
@pindex mknod
-@@ -7257,7 +7239,7 @@
- @end table
+@@ -8463,7 +8443,7 @@
+ @exitstatus
-@node readlink invocation
@section @command{readlink}: Print the referent of a symbolic link
@pindex readlink
-@@ -7325,7 +7307,7 @@
- The @command{readlink} utility first appeared in OpenBSD 2.1.
+@@ -8550,7 +8530,7 @@
+ @exitstatus
-@node rmdir invocation
@section @command{rmdir}: Remove empty directories
@pindex rmdir
-@@ -7373,9 +7355,9 @@
+@@ -8598,12 +8578,12 @@
@end table
-@xref{rm invocation}, for how to remove non-empty directories (recursively).
+@xref{rm}, for how to remove non-empty directories (recursively).
+ @exitstatus
+
+
-@node unlink invocation
+@node unlink
@section @command{unlink}: Remove files via the unlink syscall
@pindex unlink
-@@ -7418,14 +7400,14 @@
+@@ -8614,7 +8594,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
+-@command{rm} command (@pxref{rm invocation}).
++@command{rm} command (@pxref{rm}).
+
+ @example
+ unlink @var{filename}
+@@ -8648,14 +8628,14 @@
These commands change file attributes.
@menu
@section @command{chown}: Change file owner and group
@pindex chown
-@@ -7582,7 +7564,7 @@
- @end table
+@@ -8868,7 +8848,7 @@
+ @end smallexample
-@node chgrp invocation
@section @command{chgrp}: Change group ownership
@pindex chgrp
-@@ -7666,7 +7648,7 @@
- @end table
+@@ -8986,7 +8966,7 @@
+ @end smallexample
-@node chmod invocation
@section @command{chmod}: Change access permissions
@pindex chmod
-@@ -7736,7 +7718,7 @@
- @end table
+@@ -9085,7 +9065,7 @@
+ @exitstatus
-@node touch invocation
@section @command{touch}: Change file timestamps
@pindex touch
-@@ -7856,14 +7838,14 @@
- or some such command.)
+@@ -9234,14 +9214,14 @@
+ file status information, and write buffers to disk.
@menu
--* df invocation:: Report filesystem disk space usage.
+-* df invocation:: Report file system disk space usage.
-* du invocation:: Estimate file space usage.
--* stat invocation:: Report file or filesystem status.
+-* stat invocation:: Report file or file system status.
-* sync invocation:: Synchronize memory and disk.
-+* df:: Report filesystem disk space usage.
++* df:: Report file system disk space usage.
+* du:: Estimate file space usage.
-+* stat:: Report file or filesystem status.
++* stat:: Report file or file system status.
+* sync:: Synchronize memory and disk.
@end menu
-@node df invocation
+@node df
- @section @command{df}: Report filesystem disk space usage
+ @section @command{df}: Report file system disk space usage
@pindex df
-@@ -8068,7 +8050,7 @@
- @end table
+@@ -9439,7 +9419,7 @@
+ @samp{ext3} or @samp{reiserfs}.
-@node du invocation
@section @command{du}: Estimate file space usage
@pindex du
-@@ -8242,7 +8224,7 @@
- in HP-UX; it also affects the HP-UX @command{du} program.
+@@ -9654,7 +9634,7 @@
+ @item +@var{format}
+ @vindex LC_TIME
+ List timestamps using @var{format}, where @var{format} is interpreted
+-like the format argument of @command{date} (@pxref{date invocation}).
++like the format argument of @command{date} (@pxref{date}).
+ 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
+@@ -9722,7 +9702,7 @@
+ @exitstatus
-@node stat invocation
+@node stat
- @section @command{stat}: Report file or filesystem status
+ @section @command{stat}: Report file or file system status
@pindex stat
-@@ -8341,7 +8323,7 @@
- @end table
+@@ -9856,7 +9836,7 @@
+ @exitstatus
-@node sync invocation
@section @command{sync}: Synchronize data on disk with memory
@pindex sync
-@@ -8373,13 +8355,13 @@
+@@ -9892,13 +9872,13 @@
This section describes commands that display text strings.
@menu
@section @command{echo}: Print a line of text
@pindex echo
-@@ -8435,7 +8417,7 @@
- @end table
+@@ -9981,12 +9961,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
+-backslashes. @xref{printf invocation}.
++backslashes. @xref{printf}.
+
+ @exitstatus
-@node printf invocation
@section @command{printf}: Format and print data
@pindex printf
-@@ -8521,7 +8503,7 @@
- @end smallexample
+@@ -10129,7 +10109,7 @@
+ @exitstatus
-@node yes invocation
@section @command{yes}: Print a string until interrupted
@pindex yes
-@@ -8548,14 +8530,14 @@
+@@ -10160,14 +10140,14 @@
pipeline.
@menu
@section @command{false}: Do nothing, unsuccessfully
@pindex false
-@@ -8577,7 +8559,7 @@
- be used as a dummy shell for the purpose of disabling accounts.
+@@ -10197,7 +10177,7 @@
+ non-@acronym{GNU} hosts.
-@node true invocation
@section @command{true}: Do nothing, successfully
@pindex true
-@@ -8603,7 +8585,7 @@
+@@ -10233,7 +10213,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.
@section @command{test}: Check file types and compare values
@pindex test
-@@ -8893,7 +8875,7 @@
+@@ -10564,7 +10544,7 @@
@end table
@section @command{expr}: Evaluate expressions
@pindex expr
-@@ -9138,11 +9120,11 @@
+@@ -10836,11 +10816,11 @@
it's described here.
@menu
@section @command{tee}: Redirect output to multiple files
@pindex tee
-@@ -9191,13 +9173,13 @@
+@@ -10895,13 +10875,13 @@
This section describes commands that manipulate file names.
@menu
@section @command{basename}: Strip directory and suffix from a file name
@pindex basename
-@@ -9222,7 +9204,7 @@
- options}.
+@@ -10955,7 +10935,7 @@
+ @end smallexample
-@node dirname invocation
@section @command{dirname}: Strip non-directory suffix from a file name
@pindex dirname
-@@ -9244,7 +9226,7 @@
- options}.
+@@ -10996,7 +10976,7 @@
+ @end smallexample
-@node pathchk invocation
@section @command{pathchk}: Check file name portability
@pindex pathchk
-@@ -9308,14 +9290,14 @@
+@@ -11084,14 +11064,14 @@
so forth. See also the user-related commands in the next section.
@menu
@section @command{pwd}: Print working directory
@pindex pwd
-@@ -9338,7 +9320,7 @@
- @option{--version}. @xref{Common options}.
+@@ -11116,7 +11096,7 @@
+ @exitstatus
-@node stty invocation
@section @command{stty}: Print or change terminal characteristics
@pindex stty
-@@ -9984,7 +9966,7 @@
+@@ -11775,7 +11755,7 @@
@end table
@section @command{printenv}: Print all or some environment variables
@pindex printenv
-@@ -10014,7 +9996,7 @@
+@@ -11805,7 +11785,7 @@
@end display
@section @command{tty}: Print file name of terminal on standard input
@pindex tty
-@@ -10064,16 +10046,15 @@
+@@ -11855,16 +11835,16 @@
logins, groups, and so forth.
@menu
--* id invocation:: Print real and effective uid and gid.
+-* id invocation:: Print user identity.
-* logname invocation:: Print current login name.
--* whoami invocation:: Print effective user id.
+-* whoami invocation:: Print effective user ID.
-* groups invocation:: Print group names a user is in.
-* users invocation:: Print login names of users currently logged in.
-* who invocation:: Print who is currently logged in.
-+* id:: Print real and effective uid and gid.
++* id:: Print user identity.
+* logname:: Print current login name.
-+* whoami:: Print effective user id.
++* whoami:: Print effective user ID.
++* groups:: Print group names a user is in.
+* users:: Print login names of users currently logged in.
+* who:: Print who is currently logged in.
@end menu
-@node id invocation
+@node id
- @section @command{id}: Print real and effective uid and gid
+ @section @command{id}: Print user identity
@pindex id
-@@ -10134,7 +10115,7 @@
- @end table
+@@ -11927,7 +11907,7 @@
+ @exitstatus
-@node logname invocation
@section @command{logname}: Print current login name
@pindex logname
-@@ -10154,7 +10135,7 @@
- options}.
+@@ -11948,7 +11928,7 @@
+ @exitstatus
-@node whoami invocation
+@node whoami
- @section @command{whoami}: Print effective user id
+ @section @command{whoami}: Print effective user ID
@pindex whoami
-@@ -10168,29 +10149,7 @@
- options}.
+@@ -11964,7 +11944,7 @@
+ @exitstatus
-@node groups invocation
--@section @command{groups}: Print group names a user is in
--
--@pindex groups
--@cindex printing groups a user is in
--@cindex supplementary groups, printing
--
--@command{groups} prints the names of the primary and any supplementary
--groups for each given @var{username}, or the current process if no names
--are given. If names are given, the name of each user is printed before
--the list of that user's groups. Synopsis:
--
--@example
--groups [@var{username}]@dots{}
--@end example
--
--The group lists are equivalent to the output of the command @samp{id -Gn}.
--
--The only options are @option{--help} and @option{--version}. @xref{Common
--options}.
--
--
++@node groups
+ @section @command{groups}: Print group names a user is in
+
+ @pindex groups
+@@ -11989,7 +11969,7 @@
+ @exitstatus
+
+
-@node users invocation
+@node users
@section @command{users}: Print login names of users currently logged in
@pindex users
-@@ -10218,7 +10177,7 @@
- options}.
+@@ -12020,7 +12000,7 @@
+ @exitstatus
-@node who invocation
@section @command{who}: Print who is currently logged in
@pindex who
-@@ -10330,14 +10289,13 @@
+@@ -12167,14 +12147,13 @@
information.
@menu
@section @command{date}: Print or set system date and time
@pindex date
-@@ -10819,7 +10777,7 @@
+@@ -12799,7 +12778,7 @@
@end itemize
@section @command{uname}: Print system information
@pindex uname
-@@ -10930,29 +10888,7 @@
+@@ -12928,31 +12907,7 @@
+ @exitstatus
- @end table
-@node hostname invocation
-@section @command{hostname}: Print or set system name
-With no arguments, @command{hostname} prints the name of the current host
-system. With one argument, it sets the current host name to the
-specified string. You must have appropriate privileges to set the host
--name. Synopsis:
+-name. Synopsis:
-
-@example
-hostname [@var{name}]
-The only options are @option{--help} and @option{--version}. @xref{Common
-options}.
-
+-@exitstatus
+-
-
-@node hostid invocation
+@node hostid
@section @command{hostid}: Print numeric host identifier.
@pindex hostid
-@@ -10987,15 +10923,15 @@
+@@ -12989,15 +12944,15 @@
user, etc.
@menu
-* chroot invocation:: Modify the root directory.
-* env invocation:: Modify environment variables.
--* nice invocation:: Modify scheduling priority.
+-* nice invocation:: Modify niceness.
-* nohup invocation:: Immunize to hangups.
--* su invocation:: Modify user and group id.
+-* su invocation:: Modify user and group ID.
+* chroot:: Modify the root directory.
+* env:: Modify environment variables.
-+* nice:: Modify scheduling priority.
++* nice:: Modify niceness.
+* nohup:: Immunize to hangups.
-+* su:: Modify user and group id.
++* su:: Modify user and group ID.
@end menu
@section @command{chroot}: Run a command with a different root directory
@pindex chroot
-@@ -11050,7 +10986,7 @@
- device files), copy them into place, too.
+@@ -13064,7 +13019,7 @@
+ @end display
-@node env invocation
@section @command{env}: Run a command in a modified environment
@pindex env
-@@ -11104,7 +11040,7 @@
- @end table
+@@ -13142,7 +13097,7 @@
+ @end display
-@node nice invocation
+@node nice
- @section @command{nice}: Run a command with modified scheduling priority
+ @section @command{nice}: Run a command with modified niceness
@pindex nice
-@@ -11151,7 +11087,7 @@
- @end table
+@@ -13267,7 +13222,7 @@
+ @end example
-@node nohup invocation
@section @command{nohup}: Run a command immune to hangups
@pindex nohup
-@@ -11201,7 +11137,7 @@
+@@ -13328,7 +13283,7 @@
@end display
-@node su invocation
+@node su
- @section @command{su}: Run a command with substitute user and group id
+ @section @command{su}: Run a command with substitute user and group ID
@pindex su
-@@ -11348,166 +11284,6 @@
+@@ -13485,167 +13440,6 @@
might find this idea strange at first.
-specify processes to which a signal could be sent.
-
-If @var{pid} is positive, the signal is sent to the process with the
--process id @var{pid}. If @var{pid} is zero, the signal is sent to all
+-process ID @var{pid}. If @var{pid} is zero, the signal is sent to all
-processes in the process group of the current process. If @var{pid}
--is -1, the signal is sent to all processes for which the user has
--permission to send a signal. If @var{pid} is less than -1, the signal
+-is @minus{}1, the signal is sent to all processes for which the user has
+-permission to send a signal. If @var{pid} is less than @minus{}1, the signal
-is sent to all processes in the process group that equals the absolute
-value of @var{pid}.
-
-processes is excluded from the list of processes to which the signal
-is sent.
-
--If a negative @var{PID} argument is desired as the first one, either a
--signal must be specified as well, or the option parsing
--must be interrupted with `--' before the first @var{pid} argument.
--The following three commands are equivalent:
+-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
+--@var{signal} -@var{pid}}. The following commands are equivalent:
-
-@example
-kill -15 -1
-kill -TERM -1
+-kill -s TERM -- -1
-kill -- -1
-@end example
-
@node Delaying
@chapter Delaying
-@@ -11517,11 +11293,11 @@
+@@ -13655,11 +13449,11 @@
@c Perhaps @command{wait} or other commands should be described here also?
@menu
@section @command{sleep}: Delay for a specified time
@pindex sleep
-@@ -11565,12 +11341,12 @@
+@@ -13707,12 +13501,12 @@
These programs do numerically-related operations.
@menu
@section @command{factor}: Print prime factors
@pindex factor
-@@ -11608,7 +11384,7 @@
- 18446744073709551615: 3 5 17 257 641 65537 6700417
- @end example
+@@ -13761,7 +13555,7 @@
+ @exitstatus
+
-@node seq invocation
+@node seq
projects / packages / coreutils.git / blobdiff