---- 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,92 @@
+diff -Nur coreutils-5.2.1.orig/doc/coreutils.texi coreutils-5.2.1/doc/coreutils.texi
+--- coreutils-5.2.1.orig/doc/coreutils.texi Wed Mar 10 18:50:52 2004
++++ coreutils-5.2.1/doc/coreutils.texi Thu Mar 18 16:40:26 2004
+@@ -20,102 +20,93 @@
@syncodeindex pg cp
@syncodeindex vr cp
-* 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.
-* yes: (coreutils)yes invocation. Print a string indefinitely.
++* Coreutils: (coreutils). Core GNU (file, text, shell) utilities
+* basename: (coreutils)basename. Strip directory and suffix
+* cat: (coreutils)cat. Concatenate and write files
+* chgrp: (coreutils)chgrp. Change file groups
+* 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
+* yes: (coreutils)yes. Print a string indefinitely
@end direntry
@copying
-@@ -179,10 +169,9 @@
+@@ -179,10 +170,9 @@
* Redirection:: tee
* File name manipulation:: dirname basename pathchk
* Working context:: pwd stty printenv tty
* Delaying:: sleep
* Numeric operations:: factor seq
* File permissions:: Access modes.
-@@ -205,38 +194,38 @@
+@@ -207,38 +197,38 @@
Output of entire files
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.
++* 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.
@command{ptx}: Produce permuted indexes
-@@ -248,15 +237,15 @@
+@@ -250,15 +240,15 @@
Operating on fields within a line
@command{tr}: Translate, squeeze, and/or delete characters
-@@ -267,10 +256,10 @@
+@@ -269,10 +259,10 @@
Directory listing
@command{ls}: List directory contents
-@@ -283,50 +272,50 @@
+@@ -285,50 +275,50 @@
Basic operations
@command{test}: Check file types and compare values
-@@ -345,20 +334,20 @@
+@@ -347,20 +337,20 @@
Redirection
@command{stty}: Print or change terminal characteristics
-@@ -372,19 +361,18 @@
+@@ -374,19 +364,18 @@
User information
@command{date}: Print or set system date and time
-@@ -398,24 +386,20 @@
+@@ -400,24 +389,20 @@
Modified command invocation
File permissions
-@@ -936,13 +920,13 @@
+@@ -1099,13 +1084,13 @@
in some way.
@menu
@section @command{cat}: Concatenate and write files
@pindex cat
-@@ -1048,7 +1032,7 @@
- @end table
+@@ -1213,7 +1198,7 @@
+ @exitstatus
-@node tac invocation
@section @command{tac}: Concatenate and write files in reverse
@pindex tac
-@@ -1095,7 +1079,7 @@
- @end table
+@@ -1262,7 +1247,7 @@
+ @exitstatus
-@node nl invocation
@section @command{nl}: Number lines and write files
@pindex nl
-@@ -1254,7 +1238,7 @@
- @end table
+@@ -1425,7 +1410,7 @@
+ @exitstatus
-@node od invocation
@section @command{od}: Write files in octal or other formats
@pindex od
-@@ -1509,13 +1493,13 @@
+@@ -1682,13 +1667,13 @@
These commands reformat the contents of files.
@menu
@section @command{fmt}: Reformat paragraph text
@pindex fmt
-@@ -1611,7 +1595,7 @@
- @end table
+@@ -1786,7 +1771,7 @@
+ @exitstatus
-@node pr invocation
@section @command{pr}: Paginate or columnate files for printing
@pindex pr
-@@ -1753,7 +1737,7 @@
+@@ -1928,7 +1913,7 @@
@cindex time formats
@cindex formatting times
Format header dates using @var{format}, using the same conventions as
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 +1964,7 @@
- @end table
+@@ -2157,7 +2142,7 @@
+ @exitstatus
-@node fold invocation
@section @command{fold}: Wrap input lines to fit in specified width
@pindex fold
-@@ -2046,13 +2030,13 @@
+@@ -2225,13 +2210,13 @@
These commands output pieces of the input.
@menu
@section @command{head}: Output the first part of files
@pindex head
-@@ -2117,7 +2101,7 @@
- @acronym{POSIX} 1003.1-2001 (@pxref{Standards conformance}) does not allow
- this; use @option{-c @var{count}} or @option{-n @var{count}} instead.
+@@ -2303,7 +2288,7 @@
+ @exitstatus
+
-@node tail invocation
+@node tail
@section @command{tail}: Output the last part of files
@pindex tail
-@@ -2292,7 +2276,7 @@
- conformance}) does not allow these options; use @option{-c
- @var{count}} or @option{-n @var{count}} instead.
+@@ -2483,7 +2468,7 @@
+ @exitstatus
+
-@node split invocation
+@node split
@section @command{split}: Split a file into fixed-size pieces
@pindex split
-@@ -2365,7 +2349,7 @@
- @end table
+@@ -2565,7 +2550,7 @@
+ @exitstatus
-@node csplit invocation
@section @command{csplit}: Split a file into context-determined pieces
@pindex csplit
-@@ -2503,14 +2487,14 @@
+@@ -2705,14 +2690,14 @@
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.
++* 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.
-@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 +2576,7 @@
- @end table
+@@ -2796,7 +2781,7 @@
+ @exitstatus
-@node sum invocation
@section @command{sum}: Print checksum and block counts
@pindex sum
-@@ -2641,7 +2625,7 @@
- next section) is preferable in new applications.
+@@ -2847,7 +2832,7 @@
+ @exitstatus
-@node cksum invocation
@section @command{cksum}: Print CRC checksum and byte counts
@pindex cksum
-@@ -2673,7 +2657,7 @@
- options}.
+@@ -2881,7 +2866,7 @@
+ @exitstatus
-@node md5sum invocation
@section @command{md5sum}: Print or check message-digests
@pindex md5sum
-@@ -2778,16 +2762,16 @@
+@@ -2988,16 +2973,16 @@
These commands work with (or produce) sorted files.
@menu
@section @command{sort}: Sort text files
@pindex sort
-@@ -3240,7 +3224,7 @@
+@@ -3481,7 +3466,7 @@
@end itemize
@section @command{uniq}: Uniquify files
@pindex uniq
-@@ -3369,7 +3353,7 @@
- @end table
+@@ -3618,7 +3603,7 @@
+ @exitstatus
-@node comm invocation
@section @command{comm}: Compare two sorted files line by line
@pindex comm
-@@ -3412,7 +3396,7 @@
+@@ -3661,7 +3646,7 @@
If there is an error it exits with nonzero status.
@section @command{tsort}: Topological sort
@pindex tsort
-@@ -3563,7 +3547,7 @@
- the way the linker handled archive files, which has since been solved
- in different ways.
+@@ -3815,7 +3800,7 @@
+ @exitstatus
+
-@node ptx invocation
+@node ptx
@section @command{ptx}: Produce permuted indexes
@pindex ptx
-@@ -4030,13 +4014,13 @@
+@@ -4284,13 +4269,13 @@
@chapter Operating on fields within a line
@menu
@section @command{cut}: Print selected parts of lines
@pindex cut
-@@ -4124,7 +4108,7 @@
- @end table
+@@ -4380,7 +4365,7 @@
+ @exitstatus
-@node paste invocation
@section @command{paste}: Merge lines of files
@pindex paste
-@@ -4192,7 +4176,7 @@
- @end table
+@@ -4450,7 +4435,7 @@
+ @exitstatus
-@node join invocation
@section @command{join}: Join lines on a common field
@pindex join
-@@ -4325,13 +4309,13 @@
+@@ -4580,13 +4565,13 @@
This commands operate on individual characters.
@menu
@section @command{tr}: Translate, squeeze, and/or delete characters
@pindex tr
-@@ -4715,7 +4699,7 @@
+@@ -4972,7 +4957,7 @@
Unix versions, which provide no way to preserve zero bytes.
@section @command{expand}: Convert tabs to spaces
@pindex expand
-@@ -4768,7 +4752,7 @@
- @end table
+@@ -5027,7 +5012,7 @@
+ @exitstatus
-@node unexpand invocation
@section @command{unexpand}: Convert spaces to tabs
@pindex unexpand
-@@ -4827,14 +4811,14 @@
+@@ -5088,14 +5073,14 @@
and @command{vdir}, which list information about files.
@menu
@section @command{ls}: List directory contents
@pindex ls
-@@ -5529,7 +5513,7 @@
+@@ -5784,7 +5769,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 +5688,7 @@
+@@ -5968,7 +5953,7 @@
@end table
@section @command{dir}: Briefly list directory contents
@pindex dir
-@@ -5714,10 +5698,10 @@
+@@ -5978,10 +5963,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 +5711,7 @@
+@@ -5991,7 +5976,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 +5787,16 @@
+@@ -6069,16 +6054,16 @@
copying, moving (renaming), and deleting (removing).
@menu
@section @command{cp}: Copy files and directories
@pindex cp
-@@ -6152,7 +6136,7 @@
- @end table
+@@ -6407,7 +6392,7 @@
+ @exitstatus
-@node dd invocation
@section @command{dd}: Convert and copy a file
@pindex dd
-@@ -6305,7 +6289,7 @@
- @end table
+@@ -6580,7 +6565,7 @@
+ @exitstatus
-@node install invocation
@section @command{install}: Copy files and set attributes
@pindex install
-@@ -6446,7 +6430,7 @@
- @end table
+@@ -6699,7 +6684,7 @@
+ @exitstatus
-@node mv invocation
@section @command{mv}: Move (rename) files
@pindex mv
-@@ -6574,7 +6558,7 @@
- @end table
+@@ -6801,7 +6786,7 @@
+ @exitstatus
-@node rm invocation
@section @command{rm}: Remove files or directories
@pindex rm
-@@ -6673,7 +6657,7 @@
- predates the development of the getopt standard syntax.
+@@ -6916,7 +6901,7 @@
+ @exitstatus
-@node shred invocation
@section @command{shred}: Remove files more securely
@pindex shred
-@@ -6683,7 +6667,7 @@
+@@ -6926,7 +6911,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 +6887,18 @@
+@@ -7149,18 +7134,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 +6921,7 @@
- @command{link} simply calls @code{link (@var{filename}, @var{linkname})}
- to create the link.
+@@ -7186,7 +7171,7 @@
+ @exitstatus
+
-@node ln invocation
+@node ln
@section @command{ln}: Make links between files
@pindex ln
-@@ -7098,7 +7082,7 @@
- @end smallexample
+@@ -7327,7 +7312,7 @@
+ @exitstatus
-@node mkdir invocation
@section @command{mkdir}: Make directories
@pindex mkdir
-@@ -7152,7 +7136,7 @@
- @end table
+@@ -7383,7 +7368,7 @@
+ @exitstatus
-@node mkfifo invocation
@section @command{mkfifo}: Make FIFOs (named pipes)
@pindex mkfifo
-@@ -7188,7 +7172,7 @@
- @end table
+@@ -7421,7 +7406,7 @@
+ @exitstatus
-@node mknod invocation
@section @command{mknod}: Make block or character special files
@pindex mknod
-@@ -7257,7 +7241,7 @@
- @end table
+@@ -7492,7 +7477,7 @@
+ @exitstatus
-@node readlink invocation
@section @command{readlink}: Print the referent of a symbolic link
@pindex readlink
-@@ -7325,7 +7309,7 @@
- The @command{readlink} utility first appeared in OpenBSD 2.1.
+@@ -7562,7 +7547,7 @@
+ @exitstatus
-@node rmdir invocation
@section @command{rmdir}: Remove empty directories
@pindex rmdir
-@@ -7373,9 +7357,9 @@
+@@ -7610,12 +7595,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 +7402,14 @@
+@@ -7660,14 +7645,14 @@
These commands change file attributes.
@menu
@section @command{chown}: Change file owner and group
@pindex chown
-@@ -7582,7 +7566,7 @@
- @end table
+@@ -7864,7 +7849,7 @@
+ @exitstatus
-@node chgrp invocation
@section @command{chgrp}: Change group ownership
@pindex chgrp
-@@ -7666,7 +7650,7 @@
- @end table
+@@ -7972,7 +7957,7 @@
+ @exitstatus
-@node chmod invocation
@section @command{chmod}: Change access permissions
@pindex chmod
-@@ -7736,7 +7720,7 @@
- @end table
+@@ -8057,7 +8042,7 @@
+ @exitstatus
-@node touch invocation
@section @command{touch}: Change file timestamps
@pindex touch
-@@ -7856,14 +7840,14 @@
+@@ -8184,14 +8169,14 @@
or some such command.)
@menu
@section @command{df}: Report filesystem disk space usage
@pindex df
-@@ -8068,7 +8052,7 @@
- @end table
+@@ -8387,7 +8372,7 @@
+ @exitstatus
-@node du invocation
@section @command{du}: Estimate file space usage
@pindex du
-@@ -8242,7 +8226,7 @@
- in HP-UX; it also affects the HP-UX @command{du} program.
+@@ -8578,7 +8563,7 @@
+ @exitstatus
-@node stat invocation
@section @command{stat}: Report file or filesystem status
@pindex stat
-@@ -8341,7 +8325,7 @@
- @end table
+@@ -8679,7 +8664,7 @@
+ @exitstatus
-@node sync invocation
@section @command{sync}: Synchronize data on disk with memory
@pindex sync
-@@ -8373,13 +8357,13 @@
+@@ -8714,13 +8699,13 @@
This section describes commands that display text strings.
@menu
@section @command{echo}: Print a line of text
@pindex echo
-@@ -8435,7 +8419,7 @@
- @end table
+@@ -8778,7 +8763,7 @@
+ @exitstatus
-@node printf invocation
@section @command{printf}: Format and print data
@pindex printf
-@@ -8521,7 +8505,7 @@
- @end smallexample
+@@ -8875,7 +8860,7 @@
+ @exitstatus
-@node yes invocation
@section @command{yes}: Print a string until interrupted
@pindex yes
-@@ -8548,14 +8532,14 @@
+@@ -8904,14 +8889,14 @@
pipeline.
@menu
@section @command{false}: Do nothing, unsuccessfully
@pindex false
-@@ -8577,7 +8561,7 @@
- be used as a dummy shell for the purpose of disabling accounts.
+@@ -8937,7 +8922,7 @@
+ @option{--help} or @option{--version}.
-@node true invocation
@section @command{true}: Do nothing, successfully
@pindex true
-@@ -8603,7 +8587,7 @@
+@@ -8976,7 +8961,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 +8877,7 @@
+@@ -9287,7 +9272,7 @@
@end table
@section @command{expr}: Evaluate expressions
@pindex expr
-@@ -9138,11 +9122,11 @@
+@@ -9553,11 +9538,11 @@
it's described here.
@menu
@section @command{tee}: Redirect output to multiple files
@pindex tee
-@@ -9191,13 +9175,13 @@
+@@ -9608,13 +9593,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 +9206,7 @@
- options}.
+@@ -9641,7 +9626,7 @@
+ @exitstatus
-@node dirname invocation
@section @command{dirname}: Strip non-directory suffix from a file name
@pindex dirname
-@@ -9244,7 +9228,7 @@
- options}.
+@@ -9665,7 +9650,7 @@
+ @exitstatus
-@node pathchk invocation
@section @command{pathchk}: Check file name portability
@pindex pathchk
-@@ -9308,14 +9292,14 @@
+@@ -9729,14 +9714,14 @@
so forth. See also the user-related commands in the next section.
@menu
@section @command{pwd}: Print working directory
@pindex pwd
-@@ -9338,7 +9322,7 @@
- @option{--version}. @xref{Common options}.
+@@ -9761,7 +9746,7 @@
+ @exitstatus
-@node stty invocation
@section @command{stty}: Print or change terminal characteristics
@pindex stty
-@@ -9984,7 +9968,7 @@
+@@ -10409,7 +10394,7 @@
@end table
@section @command{printenv}: Print all or some environment variables
@pindex printenv
-@@ -10014,7 +9998,7 @@
+@@ -10439,7 +10424,7 @@
@end display
@section @command{tty}: Print file name of terminal on standard input
@pindex tty
-@@ -10064,16 +10048,16 @@
+@@ -10489,16 +10474,16 @@
logins, groups, and so forth.
@menu
@section @command{id}: Print real and effective uid and gid
@pindex id
-@@ -10134,7 +10117,7 @@
- @end table
+@@ -10561,7 +10546,7 @@
+ @exitstatus
-@node logname invocation
@section @command{logname}: Print current login name
@pindex logname
-@@ -10154,7 +10137,7 @@
- options}.
+@@ -10583,7 +10568,7 @@
+ @exitstatus
-@node whoami invocation
@section @command{whoami}: Print effective user id
@pindex whoami
-@@ -10168,7 +10151,7 @@
- options}.
+@@ -10599,7 +10584,7 @@
+ @exitstatus
-@node groups invocation
@section @command{groups}: Print group names a user is in
@pindex groups
-@@ -10190,7 +10173,7 @@
- options}.
+@@ -10623,7 +10608,7 @@
+ @exitstatus
-@node users invocation
@section @command{users}: Print login names of users currently logged in
@pindex users
-@@ -10218,7 +10201,7 @@
- options}.
+@@ -10653,7 +10638,7 @@
+ @exitstatus
-@node who invocation
@section @command{who}: Print who is currently logged in
@pindex who
-@@ -10330,14 +10313,13 @@
+@@ -10804,14 +10789,13 @@
information.
@menu
@section @command{date}: Print or set system date and time
@pindex date
-@@ -10819,7 +10801,7 @@
+@@ -11323,7 +11307,7 @@
@end itemize
@section @command{uname}: Print system information
@pindex uname
-@@ -10930,29 +10912,7 @@
+@@ -11446,31 +11430,7 @@
+ @exitstatus
- @end table
-@node hostname invocation
-@section @command{hostname}: Print or set system 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 +10947,15 @@
+@@ -11507,15 +11467,15 @@
user, etc.
@menu
@section @command{chroot}: Run a command with a different root directory
@pindex chroot
-@@ -11050,7 +11010,7 @@
- device files), copy them into place, too.
+@@ -11580,7 +11540,7 @@
+ @end display
-@node env invocation
@section @command{env}: Run a command in a modified environment
@pindex env
-@@ -11104,7 +11064,7 @@
- @end table
+@@ -11645,7 +11605,7 @@
+ @end display
-@node nice invocation
@section @command{nice}: Run a command with modified scheduling priority
@pindex nice
-@@ -11151,7 +11111,7 @@
- @end table
+@@ -11750,7 +11710,7 @@
+ @end example
-@node nohup invocation
@section @command{nohup}: Run a command immune to hangups
@pindex nohup
-@@ -11201,7 +11161,7 @@
+@@ -11802,7 +11762,7 @@
@end display
@section @command{su}: Run a command with substitute user and group id
@pindex su
-@@ -11348,166 +11308,6 @@
+@@ -11959,166 +11919,6 @@
might find this idea strange at first.
@node Delaying
@chapter Delaying
-@@ -11517,11 +11317,11 @@
+@@ -12128,11 +11928,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 +11365,12 @@
+@@ -12179,12 +11979,12 @@
These programs do numerically-related operations.
@menu
@section @command{factor}: Print prime factors
@pindex factor
-@@ -11608,7 +11408,7 @@
- 18446744073709551615: 3 5 17 257 641 65537 6700417
- @end example
+@@ -12232,7 +12032,7 @@
+ @exitstatus
+
-@node seq invocation
+@node seq
projects / packages / coreutils.git / commitdiff