--- 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 @@
+@@ -20,102 +20,92 @@
@syncodeindex pg cp
@syncodeindex vr cp
+* 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
@end direntry
@copying
-@@ -179,10 +168,9 @@
+@@ -179,10 +169,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 +193,38 @@
+@@ -205,38 +194,38 @@
Output of entire files
@command{ptx}: Produce permuted indexes
-@@ -248,15 +236,15 @@
+@@ -248,15 +237,15 @@
Operating on fields within a line
@command{tr}: Translate, squeeze, and/or delete characters
-@@ -267,10 +255,10 @@
+@@ -267,10 +256,10 @@
Directory listing
@command{ls}: List directory contents
-@@ -283,50 +271,50 @@
+@@ -283,50 +272,50 @@
Basic operations
@command{test}: Check file types and compare values
-@@ -345,20 +333,20 @@
+@@ -345,20 +334,20 @@
Redirection
@command{stty}: Print or change terminal characteristics
-@@ -372,19 +360,17 @@
+@@ -372,19 +361,18 @@
User information
+* id:: Print real and effective uid and gid
+* logname:: Print current login name
+* 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
@command{date}: Print or set system date and time
-@@ -398,24 +384,20 @@
+@@ -398,24 +386,20 @@
Modified command invocation
File permissions
-@@ -936,13 +918,13 @@
+@@ -936,13 +920,13 @@
in some way.
@menu
@section @command{cat}: Concatenate and write files
@pindex cat
-@@ -1048,7 +1030,7 @@
+@@ -1048,7 +1032,7 @@
@end table
@section @command{tac}: Concatenate and write files in reverse
@pindex tac
-@@ -1095,7 +1077,7 @@
+@@ -1095,7 +1079,7 @@
@end table
@section @command{nl}: Number lines and write files
@pindex nl
-@@ -1254,7 +1236,7 @@
+@@ -1254,7 +1238,7 @@
@end table
@section @command{od}: Write files in octal or other formats
@pindex od
-@@ -1509,13 +1491,13 @@
+@@ -1509,13 +1493,13 @@
These commands reformat the contents of files.
@menu
@section @command{fmt}: Reformat paragraph text
@pindex fmt
-@@ -1611,7 +1593,7 @@
+@@ -1611,7 +1595,7 @@
@end table
@section @command{pr}: Paginate or columnate files for printing
@pindex pr
-@@ -1753,7 +1735,7 @@
+@@ -1753,7 +1737,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 +1962,7 @@
+@@ -1980,7 +1964,7 @@
@end table
@section @command{fold}: Wrap input lines to fit in specified width
@pindex fold
-@@ -2046,13 +2028,13 @@
+@@ -2046,13 +2030,13 @@
These commands output pieces of the input.
@menu
@section @command{head}: Output the first part of files
@pindex head
-@@ -2117,7 +2099,7 @@
+@@ -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.
@section @command{tail}: Output the last part of files
@pindex tail
-@@ -2292,7 +2274,7 @@
+@@ -2292,7 +2276,7 @@
conformance}) does not allow these options; use @option{-c
@var{count}} or @option{-n @var{count}} instead.
@section @command{split}: Split a file into fixed-size pieces
@pindex split
-@@ -2365,7 +2347,7 @@
+@@ -2365,7 +2349,7 @@
@end table
@section @command{csplit}: Split a file into context-determined pieces
@pindex csplit
-@@ -2503,14 +2485,14 @@
+@@ -2503,14 +2487,14 @@
contents of files.
@menu
@section @command{wc}: Print byte, word, and line counts
@pindex wc
-@@ -2592,7 +2574,7 @@
+@@ -2592,7 +2576,7 @@
@end table
@section @command{sum}: Print checksum and block counts
@pindex sum
-@@ -2641,7 +2623,7 @@
+@@ -2641,7 +2625,7 @@
next section) is preferable in new applications.
@section @command{cksum}: Print CRC checksum and byte counts
@pindex cksum
-@@ -2673,7 +2655,7 @@
+@@ -2673,7 +2657,7 @@
options}.
@section @command{md5sum}: Print or check message-digests
@pindex md5sum
-@@ -2778,16 +2760,16 @@
+@@ -2778,16 +2762,16 @@
These commands work with (or produce) sorted files.
@menu
@section @command{sort}: Sort text files
@pindex sort
-@@ -3240,7 +3222,7 @@
+@@ -3240,7 +3224,7 @@
@end itemize
@section @command{uniq}: Uniquify files
@pindex uniq
-@@ -3369,7 +3351,7 @@
+@@ -3369,7 +3353,7 @@
@end table
@section @command{comm}: Compare two sorted files line by line
@pindex comm
-@@ -3412,7 +3394,7 @@
+@@ -3412,7 +3396,7 @@
If there is an error it exits with nonzero status.
@section @command{tsort}: Topological sort
@pindex tsort
-@@ -3563,7 +3545,7 @@
+@@ -3563,7 +3547,7 @@
the way the linker handled archive files, which has since been solved
in different ways.
@section @command{ptx}: Produce permuted indexes
@pindex ptx
-@@ -4030,13 +4012,13 @@
+@@ -4030,13 +4014,13 @@
@chapter Operating on fields within a line
@menu
@section @command{cut}: Print selected parts of lines
@pindex cut
-@@ -4124,7 +4106,7 @@
+@@ -4124,7 +4108,7 @@
@end table
@section @command{paste}: Merge lines of files
@pindex paste
-@@ -4192,7 +4174,7 @@
+@@ -4192,7 +4176,7 @@
@end table
@section @command{join}: Join lines on a common field
@pindex join
-@@ -4325,13 +4307,13 @@
+@@ -4325,13 +4309,13 @@
This commands operate on individual characters.
@menu
@section @command{tr}: Translate, squeeze, and/or delete characters
@pindex tr
-@@ -4715,7 +4697,7 @@
+@@ -4715,7 +4699,7 @@
Unix versions, which provide no way to preserve zero bytes.
@section @command{expand}: Convert tabs to spaces
@pindex expand
-@@ -4768,7 +4750,7 @@
+@@ -4768,7 +4752,7 @@
@end table
@section @command{unexpand}: Convert spaces to tabs
@pindex unexpand
-@@ -4827,14 +4809,14 @@
+@@ -4827,14 +4811,14 @@
and @command{vdir}, which list information about files.
@menu
@section @command{ls}: List directory contents
@pindex ls
-@@ -5529,7 +5511,7 @@
+@@ -5529,7 +5513,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 @@
+@@ -5704,7 +5688,7 @@
@end table
@section @command{dir}: Briefly list directory contents
@pindex dir
-@@ -5714,10 +5696,10 @@
+@@ -5714,10 +5698,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 @@
+@@ -5727,7 +5711,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 @@
+@@ -5803,16 +5787,16 @@
copying, moving (renaming), and deleting (removing).
@menu
@section @command{cp}: Copy files and directories
@pindex cp
-@@ -6152,7 +6134,7 @@
+@@ -6152,7 +6136,7 @@
@end table
@section @command{dd}: Convert and copy a file
@pindex dd
-@@ -6305,7 +6287,7 @@
+@@ -6305,7 +6289,7 @@
@end table
@section @command{install}: Copy files and set attributes
@pindex install
-@@ -6446,7 +6428,7 @@
+@@ -6446,7 +6430,7 @@
@end table
@section @command{mv}: Move (rename) files
@pindex mv
-@@ -6574,7 +6556,7 @@
+@@ -6574,7 +6558,7 @@
@end table
@section @command{rm}: Remove files or directories
@pindex rm
-@@ -6673,7 +6655,7 @@
+@@ -6673,7 +6657,7 @@
predates the development of the getopt standard syntax.
@section @command{shred}: Remove files more securely
@pindex shred
-@@ -6683,7 +6665,7 @@
+@@ -6683,7 +6667,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 @@
+@@ -6903,18 +6887,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 @@
+@@ -6937,7 +6921,7 @@
@command{link} simply calls @code{link (@var{filename}, @var{linkname})}
to create the link.
@section @command{ln}: Make links between files
@pindex ln
-@@ -7098,7 +7080,7 @@
+@@ -7098,7 +7082,7 @@
@end smallexample
@section @command{mkdir}: Make directories
@pindex mkdir
-@@ -7152,7 +7134,7 @@
+@@ -7152,7 +7136,7 @@
@end table
@section @command{mkfifo}: Make FIFOs (named pipes)
@pindex mkfifo
-@@ -7188,7 +7170,7 @@
+@@ -7188,7 +7172,7 @@
@end table
@section @command{mknod}: Make block or character special files
@pindex mknod
-@@ -7257,7 +7239,7 @@
+@@ -7257,7 +7241,7 @@
@end table
@section @command{readlink}: Print the referent of a symbolic link
@pindex readlink
-@@ -7325,7 +7307,7 @@
+@@ -7325,7 +7309,7 @@
The @command{readlink} utility first appeared in OpenBSD 2.1.
@section @command{rmdir}: Remove empty directories
@pindex rmdir
-@@ -7373,9 +7355,9 @@
+@@ -7373,9 +7357,9 @@
@end table
@section @command{unlink}: Remove files via the unlink syscall
@pindex unlink
-@@ -7418,14 +7400,14 @@
+@@ -7418,14 +7402,14 @@
These commands change file attributes.
@menu
@section @command{chown}: Change file owner and group
@pindex chown
-@@ -7582,7 +7564,7 @@
+@@ -7582,7 +7566,7 @@
@end table
@section @command{chgrp}: Change group ownership
@pindex chgrp
-@@ -7666,7 +7648,7 @@
+@@ -7666,7 +7650,7 @@
@end table
@section @command{chmod}: Change access permissions
@pindex chmod
-@@ -7736,7 +7718,7 @@
+@@ -7736,7 +7720,7 @@
@end table
@section @command{touch}: Change file timestamps
@pindex touch
-@@ -7856,14 +7838,14 @@
+@@ -7856,14 +7840,14 @@
or some such command.)
@menu
@section @command{df}: Report filesystem disk space usage
@pindex df
-@@ -8068,7 +8050,7 @@
+@@ -8068,7 +8052,7 @@
@end table
@section @command{du}: Estimate file space usage
@pindex du
-@@ -8242,7 +8224,7 @@
+@@ -8242,7 +8226,7 @@
in HP-UX; it also affects the HP-UX @command{du} program.
@section @command{stat}: Report file or filesystem status
@pindex stat
-@@ -8341,7 +8323,7 @@
+@@ -8341,7 +8325,7 @@
@end table
@section @command{sync}: Synchronize data on disk with memory
@pindex sync
-@@ -8373,13 +8355,13 @@
+@@ -8373,13 +8357,13 @@
This section describes commands that display text strings.
@menu
@section @command{echo}: Print a line of text
@pindex echo
-@@ -8435,7 +8417,7 @@
+@@ -8435,7 +8419,7 @@
@end table
@section @command{printf}: Format and print data
@pindex printf
-@@ -8521,7 +8503,7 @@
+@@ -8521,7 +8505,7 @@
@end smallexample
@section @command{yes}: Print a string until interrupted
@pindex yes
-@@ -8548,14 +8530,14 @@
+@@ -8548,14 +8532,14 @@
pipeline.
@menu
@section @command{false}: Do nothing, unsuccessfully
@pindex false
-@@ -8577,7 +8559,7 @@
+@@ -8577,7 +8561,7 @@
be used as a dummy shell for the purpose of disabling accounts.
@section @command{true}: Do nothing, successfully
@pindex true
-@@ -8603,7 +8585,7 @@
+@@ -8603,7 +8587,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 @@
+@@ -8893,7 +8877,7 @@
@end table
@section @command{expr}: Evaluate expressions
@pindex expr
-@@ -9138,11 +9120,11 @@
+@@ -9138,11 +9122,11 @@
it's described here.
@menu
@section @command{tee}: Redirect output to multiple files
@pindex tee
-@@ -9191,13 +9173,13 @@
+@@ -9191,13 +9175,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 @@
+@@ -9222,7 +9206,7 @@
options}.
@section @command{dirname}: Strip non-directory suffix from a file name
@pindex dirname
-@@ -9244,7 +9226,7 @@
+@@ -9244,7 +9228,7 @@
options}.
@section @command{pathchk}: Check file name portability
@pindex pathchk
-@@ -9308,14 +9290,14 @@
+@@ -9308,14 +9292,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 @@
+@@ -9338,7 +9322,7 @@
@option{--version}. @xref{Common options}.
@section @command{stty}: Print or change terminal characteristics
@pindex stty
-@@ -9984,7 +9966,7 @@
+@@ -9984,7 +9968,7 @@
@end table
@section @command{printenv}: Print all or some environment variables
@pindex printenv
-@@ -10014,7 +9996,7 @@
+@@ -10014,7 +9998,7 @@
@end display
@section @command{tty}: Print file name of terminal on standard input
@pindex tty
-@@ -10064,16 +10046,15 @@
+@@ -10064,16 +10048,16 @@
logins, groups, and so forth.
@menu
+* id:: Print real and effective uid and gid.
+* logname:: Print current login name.
+* 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
@section @command{id}: Print real and effective uid and gid
@pindex id
-@@ -10134,7 +10115,7 @@
+@@ -10134,7 +10117,7 @@
@end table
@section @command{logname}: Print current login name
@pindex logname
-@@ -10154,7 +10135,7 @@
+@@ -10154,7 +10137,7 @@
options}.
@section @command{whoami}: Print effective user id
@pindex whoami
-@@ -10168,29 +10149,7 @@
+@@ -10168,7 +10151,7 @@
options}.
-@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
+@@ -10190,7 +10173,7 @@
+ options}.
+
+
-@node users invocation
+@node users
@section @command{users}: Print login names of users currently logged in
@pindex users
-@@ -10218,7 +10177,7 @@
+@@ -10218,7 +10201,7 @@
options}.
@section @command{who}: Print who is currently logged in
@pindex who
-@@ -10330,14 +10289,13 @@
+@@ -10330,14 +10313,13 @@
information.
@menu
@section @command{date}: Print or set system date and time
@pindex date
-@@ -10819,7 +10777,7 @@
+@@ -10819,7 +10801,7 @@
@end itemize
@section @command{uname}: Print system information
@pindex uname
-@@ -10930,29 +10888,7 @@
+@@ -10930,29 +10912,7 @@
@end table
@section @command{hostid}: Print numeric host identifier.
@pindex hostid
-@@ -10987,15 +10923,15 @@
+@@ -10987,15 +10947,15 @@
user, etc.
@menu
@section @command{chroot}: Run a command with a different root directory
@pindex chroot
-@@ -11050,7 +10986,7 @@
+@@ -11050,7 +11010,7 @@
device files), copy them into place, too.
@section @command{env}: Run a command in a modified environment
@pindex env
-@@ -11104,7 +11040,7 @@
+@@ -11104,7 +11064,7 @@
@end table
@section @command{nice}: Run a command with modified scheduling priority
@pindex nice
-@@ -11151,7 +11087,7 @@
+@@ -11151,7 +11111,7 @@
@end table
@section @command{nohup}: Run a command immune to hangups
@pindex nohup
-@@ -11201,7 +11137,7 @@
+@@ -11201,7 +11161,7 @@
@end display
@section @command{su}: Run a command with substitute user and group id
@pindex su
-@@ -11348,166 +11284,6 @@
+@@ -11348,166 +11308,6 @@
might find this idea strange at first.
@node Delaying
@chapter Delaying
-@@ -11517,11 +11293,11 @@
+@@ -11517,11 +11317,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 @@
+@@ -11565,12 +11365,12 @@
These programs do numerically-related operations.
@menu
@section @command{factor}: Print prime factors
@pindex factor
-@@ -11608,7 +11384,7 @@
+@@ -11608,7 +11408,7 @@
18446744073709551615: 3 5 17 257 641 65537 6700417
@end example
projects / packages / coreutils.git / commitdiff