doc/ChangeLog

   1 2005-10-13  Jim Meyering  <jim@meyering.net>
   2
   3         * coreutils.texi: Avoid a few overfull/underfull hboxes.
   4
   5 2005-09-24  Paul Eggert  <eggert@cs.ucla.edu>
   6
   7         * coreutils.texi (touch invocation):
   8         "touch -" now touches standard output.
   9
  10 2005-09-17  Paul Eggert  <eggert@cs.ucla.edu>
  11
  12         * coreutils.texi (who invocation): Remove a stray '+'.
  13
  14 2005-09-15  Paul Eggert  <eggert@cs.ucla.edu>
  15
  16         * coreutils.texi (uname invocation): uname -a no longer generates
  17         the -p and -i outputs if they are unknown.
  18
  19 2005-09-13  Paul Eggert  <eggert@cs.ucla.edu>
  20
  21         * coreutils.texi (Time conversion specifiers, Options for date):
  22         Document date --rfc-3339 and new specifiers %:z, %::z, %:::z.  Use
  23         "date and time" consistently; the old version sometimes said "time
  24         and date".  Fix a minor bug in the documentation for --rfc-2822:
  25         it claimed day-of-month < 10 had leading space, not leading zero.
  26         Use a consistent format for terms like "RFC".
  27         (uname invocation): Mention that Linux outputs "unknown" for
  28         -i and -p.
  29
  30 2005-09-08  Paul Eggert  <eggert@cs.ucla.edu>
  31
  32         * coreutils.texi (nice invocation): Document "niceness" versus
  33         "nice value" versus "scheduling priority".
  34
  35 2005-09-07  Paul Eggert  <eggert@cs.ucla.edu>
  36
  37         * coreutils.texi (nice invocation): Use "niceness", not "nice value"
  38         to talk about nice values offset by -20.  Don't use the word
  39         "priority" when niceness is intended.
  40
  41 2005-08-15  Jim Meyering  <jim@meyering.net>
  42
  43         * coreutils.texi (join invocation): Itemize the defaults.
  44         From Karl Berry.
  45
  46 2005-08-12  Jim Meyering  <jim@meyering.net>
  47
  48         * coreutils.texi (cp invocation, mv invocation): Remove square
  49         brackets in --reply=[HOW].  Reported by Oscar Liljeblad.
  50
  51 2005-07-19  Paul Eggert  <eggert@cs.ucla.edu>
  52
  53         * coreutils.texi (md5sum invocation): --check now allows multiple
  54         FILE inputs.
  55
  56 2005-07-18  Paul Eggert  <eggert@cs.ucla.edu>
  57
  58         * coreutils.texi (false invocation):
  59         Mention that false is often built-in, and that it exits
  60         with status >1 on some hosts.
  61         (true invocation): Remove now-incorrect "non-POSIX mode" reference.
  62
  63 2005-07-15  Paul Eggert  <eggert@cs.ucla.edu>
  64
  65         * coreutils.texi (nohup invocation): POSIXLY_CORRECT no longer
  66         affects nohup's behavior.  Input is redirected from /dev/null.
  67
  68 2005-07-11  Paul Eggert  <eggert@cs.ucla.edu>
  69
  70         * coreutils.texi (cat invocation): Remove -B or --binary option
  71         (available on MS-DOS-like platforms only).  Explain when text and
  72         binary mode are used now.
  73         (md5sum invocation): -b actually does have an effect on Unix: it
  74         causes "*" to be output.  Explain when text and binary mode are
  75         used now.
  76
  77 2005-07-03  Jim Meyering  <jim@meyering.net>
  78
  79         * coreutils.texi (cp invocation): Mark --reply as deprecated.
  80         (mv invocation): Likewise.
  81
  82 2005-06-24  Jim Meyering  <jim@meyering.net>
  83
  84         * coreutils.texi (cp invocation): Clarify how --reply=no works.
  85
  86 2005-06-14  William Brendling  <wbrendling@gmail.com>
  87
  88         * coreutils.texi (du invocation): New options --last-time and
  89         --time-style.
  90
  91 2005-06-19  Jim Meyering  <jim@meyering.net>
  92
  93         * coreutils.texi (ln invocation): Change a few `paths' to `file names'.
  94         * Makefile.am (check-texinfo): Also catch uses of path, pathname.
  95
  96 2005-06-17  Jim Meyering  <jim@meyering.net>
  97
  98         * coreutils.texi (shred invocation): Clarify that shred
  99         works on ext3 as long as it's not in data=journal mode.
 100         Patch from Mark Melahn.
 101
 102 2005-06-16  Jim Meyering  <jim@meyering.net>
 103
 104         * coreutils.texi (Backup options): Undocument --version-control=S (-V).
 105
 106 2005-06-07  Jim Meyering  <jim@meyering.net>
 107
 108         * coreutils.texi (ln invocation): Examples, from Bob Proulx.
 109
 110 2005-06-01  Paul Eggert  <eggert@cs.ucla.edu>
 111
 112         Use "file name" when talking about file names, instead of "filename"
 113         or "path", as per the GNU coding standards.
 114         * coreutils.texi (readlink invocation): "path component" ->
 115         "component", since we don't use the POSIX "path" nomenclature.
 116
 117 2005-05-11  Paul Eggert  <eggert@cs.ucla.edu>
 118
 119         * getdate.texi (General date syntax): Don't say that date
 120         date --iso-8601=ns generates acceptable dates; it doesn't yet.
 121         Problem reported by Nic Ferrier.
 122
 123 2005-05-06  Paul Eggert  <eggert@cs.ucla.edu>
 124
 125         * coreutils.texi (dd invocation): New flags "binary" and "text".
 126
 127 2005-05-04  Paul Eggert  <eggert@cs.ucla.edu>
 128
 129         * coreutils.texi (chmod invocation): chmod -w complains if its
 130         behavior differs from what chmod a-w would do.
 131
 132 2005-05-02  Paul Eggert  <eggert@cs.ucla.edu>
 133
 134         * coreutils.texi (ls invocation): ls --indicator-style=directory
 135         renamed to ls --indicator-style=slash, to avoid confusion with ls
 136         --directory.
 137
 138 2005-04-28  Paul Eggert  <eggert@cs.ucla.edu>
 139
 140         * perm.texi (Mode Structure, Changing Special Permissions):
 141         (Conditional Executability, Numeric Modes):
 142         These days the sticky bit is more often uses as the restricted
 143         deletion flag, so modernize the discussion about this.
 144         (Mode Structure): Linux/GNU -> GNU/Linux.
 145         (Symbolic Modes): Don't imply that "+ur" or "u" is valid.
 146         (Setting Permissions): Don't imply that "+t" is invalid.
 147         Use "rwx" rather than the less-common "rxw" in an example.
 148         (Copying Permissions): Say that ugo is a replacement for
 149         a string of the other letters.  Add spaces around examples.
 150         Use "set-user-ID" rather than "set user ID" to avoid ambiguity.
 151         Use "+t" rather than "o+t", since POSIX doesn't specify the latter.
 152         Mention which combinations are portable and which are GNU.
 153         (Numeric Modes): Don't imply they aren't portable; they are
 154         nowadays.
 155
 156 2005-04-26  Paul Eggert  <eggert@cs.ucla.edu>
 157
 158         * coreutils.texi (Standards conformance): Do not mention head -10,
 159         since it now works the same regardless of POSIX version.
 160         (od invocation): -w N -> -w[N].
 161         (pr invocation): -S STRING -> -SSTRING.
 162         (fold invocation): -WIDTH works even when conforming to POSIX
 163         1003.1-2001.
 164         (head invocation, tail invocation): Likewise for -NUM.
 165         (split invocation): Likewise for -LINES.
 166         (uniq invocation): Likewise for -N.
 167         (expand invocation, unexpand invocation): Likewise for -TAB.
 168         (nice invocation): Likewise for -ADJUSTMENT.
 169         (sort invocation): Clarify explanation of +N option.
 170         (uniq invocation): Likewise.
 171         (join invocation): Remove special case for --help, --version.
 172         (touch invocation): Clarify explanation of date options.
 173         (Options for date): -I timespec -> -I[timespec].
 174
 175 2005-04-23  Paul Eggert  <eggert@cs.ucla.edu>
 176
 177         * coreutils.texi (install invocation): Use a= instead of 0 for
 178         the point of departure for -m, and explain what it meeams.
 179         (mkdir invocation, mkfifo invocation, mknod invocation):
 180         The umask does not affect the point of departure.
 181         Problem reported by Mike Stone.
 182
 183 2005-04-11  Paul Eggert  <eggert@cs.ucla.edu>
 184
 185         * coreutils.texi: For consistency, standardize on "user ID" rather
 186         than "uid" or "UID" or "user id".  Similarly for "group ID".
 187
 188 2005-04-09  Jim Meyering  <jim@meyering.net>
 189
 190         * coreutils.texi (rm invocation): Say that --recursive removes
 191         listed directories too, not just their contents.
 192
 193 2005-04-08  Paul Eggert  <eggert@cs.ucla.edu>
 194
 195         * coreutils.texi (dd invocation): Document the distinction between
 196         INFO and USR1 for dd, and the effect of POSIXLY_CORRECT here.
 197
 198 2005-04-05  Paul Eggert  <eggert@cs.ucla.edu>
 199
 200         * coreutils.texi (cat invocation, chown invocation)
 201         (chgrp invocation, basename invocation, dirname invocation):
 202         Add examples, which are copies of the examples newly added
 203         to the usage messages.
 204         (ln invocation): Use same format as other examples above,
 205         for consistency.
 206
 207 2005-03-26  Paul Eggert  <eggert@cs.ucla.edu>
 208
 209         * coreutils.texi: Clarify NUL vs null byte vs null character.
 210
 211 2005-03-18  Paul Eggert  <eggert@cs.ucla.edu>
 212
 213         * coreutils.texi (nohup invocation): Clarify nohup.out creation.
 214
 215 2005-03-11  Paul Eggert  <eggert@cs.ucla.edu>
 216
 217         * coreutils.texi (Formatting file timestamps): Very long timestamps
 218         may be treated as errors.
 219
 220 2005-03-08  Paul Eggert  <eggert@cs.ucla.edu>
 221
 222         * coreutils.texi (date invocation): Use an example that makes it
 223         clear tha the default date use space-padded day of month.
 224         Replace "directive" with "conversion specifier" to be consistent
 225         with POSIX.  All uses changed.
 226         Fix menu RHS to match actual directive lists.
 227         (Time conversion specifiers): Renamed from Time directives.
 228         Use @samp consistently, sometimes instead of @code.
 229         Consistently ention which specifiers are GNU extensions.
 230         Give more examples (in some cases, instead of ranges).
 231         Say why %F is preferred for dates.
 232         (Date conversion specifiers): Renamed from Date directives.
 233         Likewise for other changes.
 234         (Padding and other flags): Correct the description.
 235         Document #.  Give an example for %9B.
 236
 237 2005-02-23  Paul Eggert  <eggert@cs.ucla.edu>
 238
 239         * coreutils.texi: Adjust to match current strftime.c.
 240         (Time directives): Say that %k, %l, and %P are GNU extensions.
 241         For %p and %P, mention handling of noon and midnight.
 242         For %s, use ISO 8601, and mention handling of leap seconds.
 243         For %S, clarify mention of leap seconds.
 244         For %T, say that it's the same as %H:%M:%S.
 245         For %X, don't say that it must be the same as %H:%M:%S.
 246         For %z and %Z, clarify which time zones are used.  These options
 247         are now affected by --date, so don't claim that they're not.
 248         (Date directives): %C is now all but the last two chars of %Y.
 249         For %D, say that it's equivalent to %m/%d/%y.
 250         For %e, use blank in example.
 251         For %h, use @code for %b.
 252         For %Y, mention what happens with outlandish years.
 253         (Padding and other flags): Renamed from Padding.
 254         Mention that the flags are GNU extensions.
 255         Mention the 0 and ^ flags.
 256         Mention field widths an modifiers.
 257         (Examples of date): - is a flag, not a modifier.
 258
 259 2005-01-07  Jim Meyering  <jim@meyering.net>
 260
 261         * coreutils.texi (sort invocation): Specify that a string
 262         of zero digits is interpreted as 0.  Reported by Ulrich Hermisson.
 263
 264 2005-01-04  Jim Meyering  <jim@meyering.net>
 265
 266         * coreutils.texi (shred invocation): Clarify that shred works fine
 267         with journaled file systems that are configured not to journal
 268         file system data.  Also mention BFS and NTFS.
 269
 270 2004-12-15  Paul Eggert  <eggert@cs.ucla.edu>
 271
 272         * coreutils.texi (ls invocation): Change minor problem to be
 273         "subdirectory not found", since top-level trouble is now serious.
 274         (dircolors invocation): Quote argument to eval.  Problem reported
 275         by Stephane Chazelas.
 276
 277 2004-12-11  Paul Eggert  <eggert@cs.ucla.edu>
 278
 279         * coreutils.texi (join invocation): Mention that blank separators
 280         in the -o option need to be quoted.  Problem reported by Phil Clayton.
 281
 282 2004-12-10  Paul Eggert  <eggert@cs.ucla.edu>
 283
 284         * coreutils.texi (id invocation): -G also prints main group.
 285         Problem reported by Tim Waugh.
 286
 287 2004-12-09  Paul Eggert  <eggert@cs.ucla.edu>
 288
 289         * coreutils.texi (ls invocation): Document new "ls" exit status.
 290
 291 2004-12-08  Paul Eggert  <eggert@cs.ucla.edu>
 292
 293         * getdate.texi (Time of day items, Time zone items):
 294         Describe new formats +00:00, UTC+00:00.
 295
 296 2004-12-04  Jim Meyering  <jim@meyering.net>
 297
 298         * coreutils.texi (cut invocation): Say when --complement is useful.
 299
 300 2004-10-01  Paolo Bonzini  <bonzini@gnu.org>
 301
 302         * coreutils.texi (cut invocation): Document --complement and
 303         adjust the documentation of -b, -c, -f.
 304
 305 2004-11-27  Paul Eggert  <eggert@cs.ucla.edu>
 306
 307         * coreutils.texi (du invocation): Use if=/dev/null rather
 308         than :|.  Problem reported by Dan Jacobson.
 309         Use "seek=2GiB" rather than the wordier "seek=`echo '2^31'|bc`".
 310         Say "KiB" not the (inaccurate) "kilobytes".
 311         Similarly for "GiB" and "gigabytes".
 312
 313 2004-11-16  Paul Eggert  <eggert@cs.ucla.edu>
 314
 315         * coreutils.texi: Changes inspired by Debian coreutils 5.2.1-2.
 316         (General output formatting): -x doesn't have an operand.
 317         (Formatting the file names): Warn that even with -N unprintable
 318         chars are still printed as '?' some times.
 319         (rm invocation): Reword rm -d to note that it's sometimes useful
 320         on non-directories.
 321         (logname invocation, users invocation, who invocation):
 322         The utmp and wtmp file names vary from system to system.
 323
 324         * getdate.texi (General date syntax): "next" is 1, not 2.
 325         Document that "second" isn't allowed as an ordinal number.
 326
 327 2004-11-15  Paul Eggert  <eggert@cs.ucla.edu>
 328
 329         * coreutils.texi (dd invocation): Reword the new dd message.
 330
 331 2004-11-14  Paul Eggert  <eggert@cs.ucla.edu>
 332
 333         * coreutils.texi (dd invocation): dd now outputs total bytes,
 334         seconds, and bytes per second.
 335
 336 2004-11-03  Paul Eggert  <eggert@cs.ucla.edu>
 337
 338         * Makefile.am (_W, W_): New macros.
 339         (check-texinfo): Use them instead of assuming grep -w (which is not
 340         portable).
 341
 342 2004-10-29  Paul Eggert  <eggert@cs.ucla.edu>
 343
 344         * coreutils.texi: Document TZ better, and adjust to new getdate.texi.
 345         (Top): Update menu.
 346         (pr invocation, Formatting file timestamps, touch invocation,
 347         stat invocation, who invocation, date invocation, Options for date):
 348         Mention TZ.
 349         * getdate.texi: Sync from gnulib.
 350
 351 2004-10-28  Paul Eggert  <eggert@cs.ucla.edu>
 352
 353         * coreutils.texi (Standards conformance): Use "head -10" rather
 354         than "head -1" as example of obsolete usage, since the POSIX
 355         consensus is that "head -1" could be supported even if we don't
 356         yet have clear consensus on "head -10".  See today's revision to
 357         the SUS FAQ
 358         <http://www.opengroup.org/austin/papers/single_unix_faq.html>.
 359
 360 2004-10-24  Paul Eggert  <eggert@cs.ucla.edu>
 361
 362         * coreutils.texi (pathchk invocation): Options must precede operands.
 363
 364 2004-10-17  Paul Eggert  <eggert@cs.ucla.edu>
 365
 366         * coreutils.texi (pathchk invocation): Overall lengths are
 367         OS limits, not file system limits.  Component length checks
 368         apply to all components, not merely to existing ones.  Say
 369         that nonexistent names are not errors.  For -p, omit all
 370         checks based on the underlying file system, not merely length
 371         checks.  Explain what the portable file name character set is.
 372
 373 2004-10-15  Paul Eggert  <eggert@cs.ucla.edu>
 374
 375         * coreutils.texi (printf invocation): Mention ISO/IEC 10646 as
 376         well as Unicode.  Various minor formatting cleanups.
 377
 378 2004-10-13  Paul Eggert  <eggert@cs.ucla.edu>
 379
 380         * coreutils.texi (sort invocation): Move LC_ALL, LC_COLLATE
 381         index entries to proper paragraph.
 382
 383 2004-10-12  Jim Meyering  <jim@meyering.net>
 384
 385         * Makefile.am (check-texinfo): Add `builtin' and `builtins' to
 386         the list of words to avoid.
 387
 388 2004-10-11  Paul Eggert  <eggert@cs.ucla.edu>
 389
 390         * coreutils.texi (Special built-in utilities): New node.
 391         (printf invocation): builtin -> built-in, for consistency
 392         with POSIX terminology.
 393         (test invocation, pwd invocation):
 394         Use specific rather than generic language to warn about
 395         built-in commands.
 396         (chroot invocation, env invocation, nice invocation, nohup invocation):
 397         Warn that command must not be a special built-in.
 398         (env invocation): Warn about environment variables with unusual
 399         spellings, or duplicates.
 400
 401 2004-09-26  Paul Eggert  <eggert@cs.ucla.edu>
 402
 403         * coreutils.texi (ls invocation): Document "ls --hide".
 404
 405 2004-09-24  Paul Eggert  <eggert@cs.ucla.edu>
 406
 407         * coreutils.texi (chmod invocation): Warn about "chmod -w file".
 408
 409 2004-09-23  Paul Eggert  <eggert@cs.ucla.edu>
 410
 411         * coreutils.texi (tail invocation): Fix bugs in the description of
 412         the obsolete syntax (e.g., it does not support -k or -m).  Warn
 413         about usages like "tail -" and "tail -c 4" that are ambigous on
 414         older systems.
 415
 416 2004-09-20  Paul Eggert  <eggert@cs.ucla.edu>
 417
 418         * coreutils.texi (mv invocation, rm invocation): Say "the response
 419         is affirmative" rather than "the response begins with y or Y",
 420         so that the documentation is accurate in non-English locales.
 421         Problem reported by Munzir Taha.
 422
 423 2004-09-18  Paul Eggert  <eggert@cs.ucla.edu>
 424
 425         * coreutils.texi (dd invocation): Distinguish between options
 426         (e.g., --help) and operands (e.g., if=file).  Move miscellaneous
 427         stuff after the operand descriptions, for clarity.
 428
 429 2004-09-09  Paul Eggert  <eggert@cs.ucla.edu>
 430
 431         * coreutils.texi (sort invocation): -u disables the last-resort
 432         comparison, too.  Revamp its description.
 433         (test invocation): Document -r, -w, -x more carefully.
 434
 435 2004-09-08  Paul Eggert  <eggert@cs.ucla.edu>
 436
 437         * coreutils.texi (Common options): Some programs don't reorder
 438         options.
 439         (tr invocation, echo invocation, printf invocation, test invocation,
 440         expr invocation, basename invocation, chroot invocation,
 441         nice invocation, nohup invocation, seq invocation):
 442         This program doesn't reorder options.
 443         (tr invocation): Mention --help, --version, --.
 444         (echo invocation): Mention that -- isn't special.
 445         (test invocation): Mention that the expression is optional,
 446         and that test ! EXPR is like ! test EXPR.
 447         Mention that -h and -L don't dereference symlinks.
 448         (expr invocation): Mention --help, --version.
 449
 450         * coreutils.texi (sort invocation): Add remarks about sort -u
 451         versus sort | uniq.  Prompted by a question from Andrew Noymer.
 452
 453 2004-09-06  Paul Eggert  <eggert@cs.ucla.edu>
 454
 455         * coreutils.texi (od invocation): Several changes for POSIX
 456         and FreeBSD compatibility.  Add support for XSI syntax
 457         (POSIX 1003.1-2004).  Rename -s[N] to -S N.  Remove documentation
 458         for -h.  -i is now -t dI (not d2) and -l is now -t dL (not d4).
 459
 460 2004-09-05  Paul Eggert  <eggert@cs.ucla.edu>
 461
 462         * coreutils.texi (String tests): Improve quality of warning about
 463         quoting strings for the shell.
 464
 465 2004-09-03  Paul Eggert  <eggert@cs.ucla.edu>
 466
 467         * coreutils.texi (dd invocation): Specify which conversion options
 468         are mutually exclusive.  Give a bit more detail about ascii,
 469         ebcdic, and ibm conversions.
 470
 471 2004-08-24  Paul Eggert  <eggert@cs.ucla.edu>
 472
 473         POSIX-conformance fixes for "expand" and "unexpand".
 474         * coreutils.texi: Standardize on "tab stop" (the POSIX usage)
 475         rather than "tabstop".
 476         (unexpand invocation): Use "blank" rather than "space" when
 477         POSIX requires "blank".  Define "blank".  Initial blanks are
 478         converted even if there's just one.  For -a, convert two or
 479         more blanks only if they occur just before a tab stop.
 480
 481 2004-08-19  Paul Eggert  <eggert@cs.ucla.edu>
 482
 483         * coreutils.texi (chown invocation): Fix synopsis:
 484         group must always be preceded by separator.
 485         "chown : file" and "chown '' file" don't change the owner or group.
 486         Update the explanation of what happens to the set-user-ID or
 487         set-group-ID bits, e.g., they sometimes are not cleared if they
 488         denote mandatory locking.  Change "find"-oriented examples to use
 489         chown -h.
 490
 491 2004-08-18  Paul Eggert  <eggert@cs.ucla.edu>
 492
 493         * coreutils.texi (printf invocation): Clarify how "printf" is
 494         supposed to work with extra arguments, missing arguments, etc.
 495
 496 2004-08-10  Paul Eggert  <eggert@cs.ucla.edu>
 497
 498         POSIX-conformance fixes for "-" used as an operand.
 499         * coreutils.texi (Common options): Clarify that "-" means
 500         stdin/stdout only when it is an operand, not when it is an
 501         option-argument.
 502         (shred invocation): "shred -- -" is equivalent to "shred -",
 503         not to "shred ./-".
 504         (tee invocation): "tee -" means to copy (again) to stdout.
 505
 506 2004-07-25  Paul Eggert  <eggert@cs.ucla.edu>
 507
 508         * coreutils.texi (nice invocation): Document the "nice value", and
 509         how it affects the scheduling priority.  (The old documentation
 510         implied that the nice value equaled the scheduling priority, which
 511         isn't accurate.)  Document that the range of nice values might
 512         exceed -20..19.  Specify what happens when you give a nice value
 513         that is out of range, or when you don't have permissions to lower
 514         the nice value.  Bash doesn't have a builtin 'nice', so don't say
 515         "most shells" have one.
 516
 517 2004-04-03  Dmitry V. Levin  <ldv@altlinux.org>
 518
 519         * coreutils.texi (readlink invocation): Document new
 520         "readlink -f" behaviour and new canonicalize options, -e and -m.
 521
 522 2004-07-02  Jim Meyering  <jim@meyering.net>
 523
 524         * Makefile.am (check-texinfo): Disallow `filename' in .texi files.
 525         Spell it like `file name' instead, to be consistent.
 526         Fail if a @footnote directive follows non-punctuation.
 527         Fail upon use of @url.  Use @uref instead.
 528
 529 2004-07-01  Paul Eggert  <eggert@cs.ucla.edu>
 530
 531         * coreutils.texi (Common options, Target directory, cp invocation,
 532         install invocation, mv invocation, ln invocation): Add -t as a
 533         short option for --target-directory, and -T as a short option for
 534         --no-target-directory.  Clean up relevant synopses a bit, so that
 535         the language is similar for all.
 536
 537 2004-06-30  Paul Eggert  <eggert@cs.ucla.edu>
 538
 539         * coreutils.texi: Put the right amount of space at sentence ends.
 540         Make sure "i.e." and "e.g." are followed by commas (the GNU style).
 541         Put blank lines before and after every @example, prefer the
 542         previous line to end in ":" (when not a sentence end, for consistency),
 543         and prepend @noindent to the following line when appropriate.
 544         In examples, use "--" arguments when needed to prevent undesired
 545         interpretation of operands as options.
 546         Use "file name" rather than "filename", as per the GNU coding standards.
 547         Remove unwanted spaces before @footnote.
 548         Use "---" when appropriate, instead of " -- ".
 549         Use "name" (or something like that) rather than "path" or "pathname",
 550         since the GNU coding standards don't allow "path".
 551         Use @acronym, @command, @minus{}, @samp in a few places,
 552         where appropriate.
 553         (Target directory): Clarify description of example.
 554         (fmt invocation): Give issue number for reference, and reword
 555         for clarity.
 556         (sort invocation): Note that xargs without -0 also mishandles
 557         file names containing some special characters other than newline.
 558         (Translating): Mention that \012 is not universally portable.
 559         Use '\0' rather than '\000'.
 560         (Squeezing): bourne -> Bourne.
 561         Fix unportable usage of '\n' by replacing it with '[\n*]'.
 562         (More details about version sort): Remove unnecessary indent
 563         in examples.
 564         (dd invocation): Use 'kill -s USR1', not 'kill -USR1', as POSIX
 565         indicates that the former is more portable (the latter is an XSI
 566         extension).
 567         (shred invocation): Use @uref rather than @url, and use a more-typical
 568         style for the date.
 569         (kill invocation): Clarify usage; for example, "kill -s TERM -1"
 570         isn't allowed.
 571         (seq invocation): Reword to avoid implying that printf necessarily
 572         fails for numbers outside the 32-bit range.  Prefer separating
 573         options from their operands.
 574         (Opening the software toolbox): Give an online reference to
 575         Robbins's article, and give a date.  Don't imply that the
 576         current documentation is unchanged from his article.
 577         (Putting the tools together): Rework examples so that they don't
 578         assume the C locale; nowadays many users now operate outside the C
 579         locale by default.  While we're at it, don't assume ASCII either.
 580         Indent example to match actual output from GNU uniq.  Remove some
 581         unnecessary and confusing brackets from 'tr' operands.  "Software
 582         Tools in Pascal" is back in print, according to Amazon anyway.
 583         Add references to Kernighan's online copies of examples.
 584
 585 2004-06-30  Paul Eggert  <eggert@cs.ucla.edu>
 586
 587         * coreutils.texi, perm.texi: Standardize on "file system" rather
 588         than "filesystem", as POSIX prefers it with a space.
 589
 590 2004-06-29  Paul Eggert  <eggert@cs.ucla.edu>
 591
 592         * coreutils.texi (Common options, Target directory, cp
 593         invocation, install invocation, mv invocation, ln invocation):
 594         Likewise.
 595         (link invocation): Explain how to rewrite link using ln now
 596         that we have --no-target-directory.
 597         (ln invocation): Explain that --no-target-directory subsumes
 598         --no-dereference.
 599         (unlink invocation): Modify wording to match new wording in
 600         link invocation.
 601
 602 2004-06-25  Paul Eggert  <eggert@cs.ucla.edu>
 603
 604         * coreutils.texi (install invocation): Document
 605         --target-directory in synopsis, too.
 606
 607 2004-06-15  Paul Eggert  <eggert@cs.ucla.edu>
 608
 609         * coreutils.texi (yes invocation): "--" is now supported.
 610         (false invocation, true invocation): --help and --version now
 611         work unconditionally.
 612
 613 2004-06-07  Jim Meyering  <jim@meyering.net>
 614
 615         * coreutils.texi: Remove menu references to just-removed subsection.
 616
 617 2004-06-06  Jim Meyering  <jim@meyering.net>
 618
 619         * coreutils.texi (tr invocation): Remove the section describing
 620         how POSIXLY_CORRECT changes tr's behavior.
 621
 622 2004-06-02  Jim Meyering  <jim@meyering.net>
 623
 624         * coreutils.texi (cut invocation): Clarify what --output-delimiter=STR
 625         does with byte/character ranges.
 626
 627 2004-06-01  Paul Eggert  <eggert@cs.ucla.edu>
 628
 629         * coreutils.texi (tr invocation): Mention -C.
 630
 631 2004-05-13  Paul Eggert  <eggert@cs.ucla.edu>
 632
 633         * coreutils.texi (echo invocation): Document today's changes.
 634
 635 2004-05-17  Jim Meyering  <jim@meyering.net>
 636
 637         chgrp and chown now dereference symlinks by default, per POSIX.
 638         * coreutils.texi (chgrp invocation, chown invocation): Document it.
 639
 640 2004-05-13  Paul Eggert  <eggert@cs.ucla.edu>
 641
 642         * coreutils.texi (sort invocation): Document that "sort -m -o F"
 643         might write F before reading all the input.
 644
 645 2004-05-09  Jim Meyering  <jim@meyering.net>
 646
 647         * coreutils.texi (stat invocation): Change IO to I/O.
 648         * Makefile.am (check-texinfo): Check for the above.
 649
 650 2004-04-25  Paul Eggert  <eggert@twinsun.com>
 651
 652         * coreutils.texi (sort invocation): Mention -k earlier, so
 653         that the options are in alphabetical order.  Describe how -b works
 654         more-accurately; this involves fixing some examples, too.  Mention
 655         what happens if the start field falls after an end field or after
 656         a line end.  Warn about using -k without -b, -g, -M, -n, or -t.
 657         Add an example of how to sort IPv4 addresses and Apache Common
 658         Log Format dates.  Remove a duplicate example.
 659         (Putting the tools together): Use separate options rather
 660         than agglomerating them.
 661
 662 2004-03-27  Paul Eggert  <eggert@twinsun.com>
 663
 664         cp -pu and mv -u (when copying) now take the destination
 665         file system time stamp resolution into account.
 666
 667         * coreutils.texi (mv invocation): Document this.
 668         (cp invocation): Document -u (it was missing!) with new behavior.
 669
 670 2004-04-08  Paul Eggert  <eggert@cs.ucla.edu>
 671
 672         * coreutils.texi (dd invocation): Remove noctty flag from dd.
 673
 674 2004-04-07  Paul Eggert  <eggert@twinsun.com>
 675
 676         New dd conv= symbols nocreat, excl, fdatasync, fsync,
 677         and new dd options iflag= and oflag=.
 678
 679         * coreutils.texi (dd invocation): Document them.
 680
 681 2004-04-07  Jim Meyering  <jim@meyering.net>
 682
 683         * coreutils.texi (stty invocation - Input): Document new iutf8 option.
 684
 685 2004-04-04  Jim Meyering  <jim@meyering.net>
 686
 687         * coreutils.texi (stat invocation): Correct --format description.
 688
 689 2004-02-25  Paul Eggert  <eggert@twinsun.com>
 690
 691         * coreutils.texi (Block size): Document new envvar BLOCKSIZE.
 692
 693 2004-03-24  Jim Meyering  <jim@meyering.net>
 694
 695         * Makefile.am (check-texinfo): Add a check to ensure future
 696         consistency in using @sc{nul}, not `NUL'.
 697
 698 2004-03-23  Paul Eggert  <eggert@twinsun.com>
 699
 700         * coreutils.texi: Use @sc{nul} consistently for NUL.
 701         (du invocation): FILE0 -> FILE.
 702
 703 2004-03-23  Jim Meyering  <jim@meyering.net>
 704
 705         * coreutils.texi (du invocation): --files0-from is useful with
 706         --total (-c), not with --summarize.
 707
 708 2004-03-22  Jim Meyering  <jim@meyering.net>
 709
 710         * coreutils.texi: Tweak a few lines that resulted in
 711         `overfull hbox' warnings.
 712
 713 2004-03-03  Jim Meyering  <jim@meyering.net>
 714
 715         * coreutils.texi (du invocation): Document new option: --file0-from=F.
 716
 717 2004-02-29  Paul Eggert  <eggert@twinsun.com>
 718
 719         * coreutils.texi (touch invocation):
 720         Describe use of fractional seconds.
 721         (date invocation, Options for date): Likewise.
 722         * getdate.texi (General date syntax, Time of day items): Likewise.
 723         * coreutils.texi (date invocation): Mention effect of LC_TIME.
 724         (Options for date): Describe new --iso-8601=ns option.
 725
 726         * getdate.texi: Add copyright notice.  Change getdate to
 727         get_date when talking about the function name.
 728         (Seconds since the Epoch): New section, containing the time_t
 729         info moved from Date input formats section, along with new
 730         info about the @ syntax.  Mention negative time stamps,
 731         fractional time stamps, and leap seconds.
 732         (General date syntax): Modernize examples a bit to reflect new
 733         features.
 734         (General date syntax, Relative items in date strings):
 735         Use ' rather than " to quote formats.
 736         (Time of day items): Add an example with fractional seconds.
 737         Describe fractional-second syntax.
 738
 739 2004-03-15  Jim Meyering  <jim@meyering.net>
 740
 741         * coreutils.texi (date invocation): Add missing `C' to %[...] range
 742         in the `Date directives:: ...' menu entry.  From Bob Proulx.
 743
 744         * coreutils.texi: Add FIXME comment:
 745         The following don't have `invocation' nodes: [, pinky, shasum, uptime.
 746
 747 2004-03-10  Jim Meyering  <jim@meyering.net>
 748
 749         * coreutils.texi (Sorting the output): Remove description of
 750         ls's --sort=directory option.  ls doesn't accept that option, yet.
 751         Reported by Arvind Autar.
 752
 753         * coreutils.texi (cp invocation): Improve description of
 754         cp's --sparse=WHEN option.
 755
 756         * coreutils.texi (nl invocation): Specify that these are _basic_
 757         regular expressions (BRE), and add a link to grep's documentation.
 758         Suggestion from Dan Jacobson.
 759
 760 2004-02-23  Paul Eggert  <eggert@twinsun.com>
 761
 762         * coreutils.texi (chown invocation): Document that chown now falls
 763         back on USER.GROUP parsing regardless of POSIX version, as POSIX
 764         1003.1-2001 allows that behavior as a compatible extension.
 765
 766 2004-02-22  Jim Meyering  <jim@meyering.net>
 767
 768         * coreutils.texi (du invocation): Mention that using du's -H option
 769         currently evokes a warning.
 770
 771 2004-02-15  Paul Eggert  <eggert@twinsun.com>
 772
 773         * coreutils.texi (expr invocation):
 774         Document what forms integers may take, and say "integer"
 775         consistently instead of "number".  Warn about operands
 776         that "expr" can misinterpret, and how to work around the
 777         problem.
 778
 779 2004-02-17  Jim Meyering  <jim@meyering.net>
 780
 781         * coreutils.texi (csplit invocation): Correct typo (s/LINE/N/)
 782         in description of `N' pattern.  From Reuben Thomas <rrt@sc3d.org>
 783
 784 2004-02-11  Jim Meyering  <jim@meyering.net>
 785
 786         * coreutils.texi (Time directives): The %s value *is* changed by the
 787         --date=DATE option; don't say otherwise.  Patch from Padraig Brady.
 788
 789 2004-02-10  Paul Eggert  <eggert@twinsun.com>
 790
 791         * coreutils.texi (Formatting the file names):
 792         Improve wording for --quoting-style documentation.
 793         Suggestions by Bruno Haible.
 794
 795 2004-02-02  Jim Meyering  <jim@meyering.net>
 796
 797         * coreutils.texi (nice invocation): Add examples.
 798         Prompted by a suggestion from Dan Jacobson.
 799         (factor invocation): Add an example.
 800         Update timing numbers for a more modern CPU.
 801
 802 2004-01-27  Jim Meyering  <jim@meyering.net>
 803
 804         * coreutils.texi (seq invocation): Remove `@dots{}' at end of synopsis.
 805         Separate `Synopses' section into three examples.
 806         Clarify first paragraph.  @w{}-protect an expression.1
 807         Use @option{--option}, rather than @code{--option}.
 808
 809 2004-01-19  Paul Eggert  <eggert@twinsun.com>
 810
 811         * coreutils.texi (Exit status): Document that ordinary failure
 812         might not exit with status 1 on unusual platforms.
 813         Mention chroot, env, nice, and su as having unusual exit
 814         status patterns.  Don't bother to mention true and false
 815         since their exit status patterns are actually normal.
 816         (sort invocation, su invocation): Mention its unusual exit
 817         status pattern.
 818         (chroot invocation): Simplify description of exit status 1.
 819         Remove duplicate description of status 127.
 820         (env invocation): Use consistent tenses; simplifiy description
 821         of status 1.
 822         (nice invocation): Likewise.
 823
 824 2003-12-15  Paul Eggert  <eggert@twinsun.com>
 825
 826         * coreutils.texi (touch invocation): touch -r and -d can now
 827         both be specified, with -r specifying the origin for -d.
 828
 829 2004-01-15  Alfred M. Szmidt  <ams@kemisten.nu>
 830
 831         Factor out some common options.
 832         * coreutils.texi (Common options): Define macros here.
 833         (What information is listed, cp invocation): Use the macro(s).
 834         (install invocation, mv invocation, ln invocation): Likewise.
 835         (df invocation, du invocation): Likewise.
 836
 837 2004-01-09  Jim Meyering  <jim@meyering.net>
 838
 839         Document the exit status of each and every program.
 840         * coreutils.texi (yes invocation): Document that a write error
 841         makes `yes' exit unsuccessfully.
 842         (chroot invocation): Enumerate the meaning of exit status values.
 843         (nice invocation): Likewise.
 844         (Exit status) [@macro exitstatus]: New macro.
 845         Use @exitstatus to describe the exit status of most programs.
 846
 847 2004-01-02  Jim Meyering  <jim@meyering.net>
 848
 849         * coreutils.texi (du invocation): Mention that -H will eventually
 850         mean not --si, but --dereference-args (-D).
 851
 852 2003-12-20  Jim Meyering  <jim@meyering.net>
 853
 854         * coreutils.texi (du invocation): Describe new option: -0, --null.
 855
 856 2003-12-03  Paul Eggert  <eggert@twinsun.com>
 857
 858         * coreutils.texi (What information is listed, chroot invocation):
 859         Adjust example 'ls' output to match new behavior with narrower
 860         output columns.
 861         (The cut command): Remove example that cut the output of
 862         'ls -l'.  The output was incorrect even with the old 'ls', and
 863         the whole idea of using 'cut' on 'ls -l' output is bogus anyway.
 864
 865 2003-11-24  Paul Eggert  <eggert@twinsun.com>
 866
 867         Parse floating-point operands and options in the C locale.
 868         POSIX requires this for printf, and we might as well be
 869         consistent elsewhere (tail, sleep, seq).
 870
 871         * coreutils.texi (tail invocation, printf invocation,
 872         sleep invocation, seq invocation): Document this.
 873
 874 2003-11-24  Jim Meyering  <jim@meyering.net>
 875
 876         * coreutils.texi (Traversing symlinks, Treating / specially):
 877         New sections.
 878         (rm invocation, chown invocation, chmod invocation, chgrp invocation):
 879         Describe new options, --preserve-root and --no-preserve-root.
 880
 881 2003-11-11  Jim Meyering  <jim@meyering.net>
 882
 883         * coreutils.texi (chown invocation) [chownchgrpoptions]: New macro
 884         describing -H, -L, -P options.  Use it here.
 885         (chgrp invocation): And here.
 886
 887 2003-11-09  Jim Meyering  <jim@meyering.net>
 888
 889         * coreutils.texi (dd invocation): Fix typo in example.
 890
 891 2003-10-15  Jim Meyering  <jim@meyering.net>
 892
 893         * coreutils.texi (ln invocation): Note that --directory, -d, -F
 894         probably won't work even for superuser.  Suggestion from Dan Jacobson.
 895
 896 2003-09-29  Paul Eggert  <eggert@twinsun.com>
 897
 898         * coreutils.texi (csplit invocation):
 899         The regexp offset need not have a sign; POSIX requires support
 900         for signless offets.
 901
 902 2003-10-03  Jim Meyering  <jim@meyering.net>
 903
 904         * coreutils.texi (du invocation): Describe -P, --no-dereference.
 905
 906 2003-09-28  Jim Meyering  <jim@meyering.net>
 907
 908         * coreutils.texi (Translating): Correct typo in menu description.
 909         From A Costa.
 910
 911 2003-09-02  Paul Eggert  <eggert@twinsun.com>
 912
 913         * coreutils.texi (sort invocation): -d now overrides -i.
 914         "whitespace" -> "blanks"; "whitespace" isn't correct.
 915         -t '\0' now specifies a NUL tab.
 916
 917 2003-08-17  Jim Meyering  <jim@meyering.net>
 918
 919         * coreutils.texi (who invocation): Add an entry for -l, --login.
 920         Remove `-l' from the entry for --lookup.
 921         (who invocation): Begin adding missing option documentation.
 922
 923 2003-08-07  Paul Eggert  <eggert@twinsun.com>
 924
 925         * coreutils.texi (split invocation):
 926         Add -d or --numeric-suffixes option to 'split'.
 927
 928 2003-07-31  Paul Eggert  <eggert@twinsun.com>
 929
 930         * getdate.texi (General date syntax): Add --rfc-2822 option to GNU date.
 931         * coreutils.texi (Options for date): Fix a typo in format:
 932         it's now %d not %_d.  Add URLs.
 933
 934 2003-07-31  Paul Eggert  <eggert@twinsun.com>
 935
 936         * getdate.texi (Relative items in date strings): Warn about
 937         fuzz in relative units.
 938
 939 2003-07-29  Jim Meyering  <jim@meyering.net>
 940
 941         * coreutils.texi (tail invocation): Restore two end-of-sentence words
 942         that were mistakenly removed on 2002-09-13.  Reported by Paul Worrall.
 943
 944 2003-07-28  Jim Meyering  <jim@meyering.net>
 945
 946         * coreutils.texi (dd invocation): Explain that a SIGUSR1 signal
 947         makes dd give a progress report to stderr.
 948
 949 2003-07-24  Paul Eggert  <eggert@twinsun.com>
 950
 951         * coreutils.texi: Document changes of 2003-07-24.
 952
 953 2003-07-24  Jim Meyering  <jim@meyering.net>
 954
 955         * coreutils.texi (su invocation): Use `@subsection', not invalid
 956         `@heading'.
 957
 958 2003-07-17  Paul Eggert  <eggert@twinsun.com>
 959
 960         * coreutils.texi (expr invocation): Exit status is 2 if the
 961         expression is syntactically invalid, 3 if there is some other error.
 962         This change is for conformance to POSIX.
 963
 964 2003-07-14  Paul Eggert  <eggert@twinsun.com>
 965
 966         * coreutils.texi (uname invocation): Explain the POSIX
 967         terminology behind uname -m and uname -s.
 968
 969 2003-07-13  Jim Meyering  <jim@meyering.net>
 970
 971         * coreutils.texi (chown invocation): Warn that chown
 972         now clears set-user-ID and set-group-ID bits on some systems.
 973         From Bob Proulx.
 974         (nohup invocation): Tell what happens when stdout is not a terminal.
 975         Based on a suggestion from Steven Mocking.
 976
 977 2003-07-10  Jim Meyering  <jim@meyering.net>
 978
 979         * coreutils.texi (Standards conformance): Mention that uses like
 980         `tail -1' and `head -1', like `sort +1', are non conforming.
 981         (chown invocation): Say that using `.' as a separator may not work.
 982
 983 2003-06-25  Jim Meyering  <jim@meyering.net>
 984
 985         * coreutils.texi (Time directives) [%s]: Add a cross reference
 986         to the related examples.
 987         (Examples of date): Add an @anchor here, along with a few more examples.
 988         Suggestion from Dan Jacobson.
 989
 990 2003-06-12  Jim Meyering  <jim@meyering.net>
 991
 992         * coreutils.texi (wc invocation): Tweak wording: wc prints counts in
 993         the order `newline, word, byte'.  Suggestion from Keith M. Briggs.
 994         Also change `lines' to `newlines'.
 995
 996 2003-05-14  Jim Meyering  <jim@meyering.net>
 997
 998         * coreutils.texi (head invocation): Document --bytes=-N and --lines=-N.
 999
1000 2003-05-13  Paul Eggert  <eggert@twinsun.com>
1001
1002         * coreutils.texi (uniq invocation, squeezing, The uniq command):
1003         Use "repeated" rather than "duplicate" to describe adjacent
1004         duplicates; this simplifies the description and makes it more
1005         consistent with POSIX.
1006         (uniq invocation): Make it clear that -d and -u suppress the
1007         output of lines, rather than cause some lines to be output.
1008         Mention what happens if a line lacks enough fields or characters.
1009
1010 2003-05-13  Jim Meyering  <jim@meyering.net>
1011
1012         * coreutils.texi (true invocation): Mention that it is possible to
1013         make true --help or true --version (in non-POSIX mode) exit nonzero.
1014         Suggestion from Paul Eggert.
1015
1016 2003-05-10  Jim Meyering  <jim@meyering.net>
1017
1018         * coreutils.texi (Exit status): Remove `uniq' from the list.
1019         It uses standard exit codes.
1020         (More details about version sort): Note that strverscmp, and hence
1021         `ls -v', does not use LC_COLLATE.  Reported by From: Andrey Borzenkov.
1022
1023 2003-04-21  Jim Meyering  <jim@meyering.net>
1024
1025         Fix printf POSIX compatibility bug reported by Ben Harris in
1026         <http://mail.gnu.org/archive/html/bug-coreutils/2003-04/msg00070.html>.
1027         * coreutils.texi (printf invocation): It's \NNN in the format,
1028         \0NNN in the %b operand.
1029
1030 2003-04-10  Jim Meyering  <jim@meyering.net>
1031
1032         * Makefile.am (check-texinfo): Check for uses of non-zero.
1033         I prefer to spell it `nonzero'.
1034
1035         * coreutils.texi (readlink invocation): Tweak description a little.
1036
1037 2003-04-04  Jim Meyering  <jim@meyering.net>
1038
1039         * Makefile.am (constants.texi): Rename target (thus enabling it),
1040         now that fileutils, textutils, and sh-utils have been merged.
1041         (MAINTAINERCLEANFILES): Define.
1042
1043 2003-04-02  Jim Meyering  <jim@meyering.net>
1044
1045         * coreutils.texi (false invocation): Note that false exits
1046         unsuccessfully even with --help and --version.
1047
1048         * Makefile.am (check-texinfo): Don't fail if perl is missing.
1049         Reported by Nelson Beebe.
1050
1051 2003-03-27  Jim Meyering  <jim@meyering.net>
1052
1053         * coreutils.texi (printf invocation): Fix formatting bugs.
1054         From Paul Eggert.
1055         (sort invocation): Describe sort's --stable (-s) option.
1056
1057 2003-03-13  Jim Meyering  <jim@meyering.net>
1058
1059         * coreutils.texi (shred invocation): Mention that --exact
1060         is now the default for non-regular files.
1061
1062 2003-03-02  Jim Meyering  <jim@meyering.net>
1063
1064         * coreutils.texi (Exit status): New section.
1065         Suggestion from Michael Stone.
1066
1067 2003-02-21  Jim Meyering  <jim@meyering.net>
1068
1069         * coreutils.texi (du invocation): Document --apparent-size.
1070         Adjust documentation of --bytes (-b).
1071         (stat invocation): Describe %B.
1072
1073 2003-02-07  Richard Dawe  <rich@phekda.freeserve.co.uk>
1074
1075         * coreutils.texi: Use @command instead of @code for program names.
1076
1077         * perm.texi (Mode Structure): Mention filesystem-specific
1078         permissions and that mounting a filesystem as read-only may
1079         override actual file permissions.  Use @command instead
1080         of @code for program names.
1081
1082 2003-02-06  Jim Meyering  <jim@meyering.net>
1083
1084         * coreutils.texi: Adjust alignment and mention `file, text, shell'
1085         on the `* Coreutils:...' dirently line.  From Karl Berry.
1086
1087 2003-02-05  Jim Meyering  <jim@meyering.net>
1088
1089         * Makefile.am (check-texinfo): Allow bare `POSIX' to be used on
1090         direntry lines.
1091
1092         * coreutils.texi: Use new form of @direntry.
1093         Put unlink in its proper place.  Adjust wording in some
1094         dir entry descriptions, mainly so they fit in 80 columns.
1095         Don't use mark-up like @acronym{POSIX} in direntries.
1096         Mostly from Karl Berry.
1097
1098 2003-01-25  Jim Meyering  <jim@meyering.net>
1099
1100         * coreutils.texi (cut invocation): Describe new functionality of
1101         --output-delimiter=STR.
1102
1103 2003-01-24  Jim Meyering  <jim@meyering.net>
1104
1105         * coreutils.texi (The cut command): Give an example of using cut -c
1106         with an output delimiter.  From Jan Nieuwenhuizen.
1107
1108         * coreutils.texi (The cut command): Extend the new example a little.
1109         (Formatting file timestamps): Fix typo: s/%M:S/%M:%S/.
1110
1111         * coreutils.texi: Change each use of `Core-utils' to `Coreutils'.
1112         From Karl Berry.
1113
1114 2003-01-19  Jim Meyering  <jim@meyering.net>
1115
1116         * coreutils.texi (Which files are listed): Document new option:
1117         --dereference-command-line-symlink-to-dir.
1118
1119 2003-01-15  Paul Eggert  <eggert@twinsun.com>
1120
1121         Change ls -H back to the way it was yesterday, since this is
1122         compatible with FreeBSD and the POSIX spec is confusing
1123         and somewhat contradictory.
1124
1125         * coreutils.texi (Which files are listed, General output
1126         formatting): Undo last change.
1127
1128 2003-01-15  Jim Meyering  <jim@meyering.net>
1129
1130         * coreutils.texi (General output formatting): Reflect option name change:
1131         s/--dereference-command-line/--dereference-command-line-symlink-to-dir/.
1132         Say that this option changes how ls treats only symlinks to directories
1133         specified on the command line.
1134
1135 2002-08-27  Dmitry V. Levin  <ldv@altlinux.org>
1136
1137         * coreutils.texi: Document readlink.
1138
1139 2002-12-14  Jim Meyering  <jim@meyering.net>
1140
1141         * coreutils.texi (mknod invocation): Specify how major and minor mode
1142         numbers are interpreted.  Report forwarded by Kristin E Thomas.
1143
1144 2002-11-13  Jim Meyering  <jim@meyering.net>
1145
1146         * coreutils.texi (Examples of expr): Remove bogus `^'s.
1147         Reported by Thomas Goerlich.
1148
1149 2002-11-09  Jim Meyering  <jim@meyering.net>
1150
1151         * coreutils.texi (What information is listed) [--dired]:
1152         Correct parts of --dired description.  Reported by Andre Spiegel.
1153         Include a lot more description, with examples.
1154
1155 2002-11-06  Jim Meyering  <jim@meyering.net>
1156
1157         * coreutils.texi (printf invocation): Fix typo in index:
1158         change \0x prefix to \x.
1159         Change \xhhh to \xhh.
1160
1161 2002-10-07  Paul Eggert  <eggert@twinsun.com>
1162
1163         Add support for locale-specific size indications (e.g.,
1164         thousands-separators) and for explicit size suffixes on output.
1165
1166         * coreutils.texi (Block size): Say that:
1167         This affects display format as well as block size.
1168         Fractional block counts are rounded up.
1169         ls file size blocksize defaults to 1.
1170         A block size spec preceded by ' generates thousands separators.
1171         A suffix without a preceding integer generates suffixes.
1172         (tail invocation): 32k -> 32 KiB.
1173         (What information is listed): ls -h is now equivalent to
1174         ls --block-size=human, and ls -H is now equivalent to
1175         ls --block-size=si.  Displayed file size is now always affected by
1176         --block-size.
1177
1178 2002-09-13  Jim Meyering  <jim@meyering.net>
1179
1180         * coreutils.texi (tail invocation): In --sleep-interval=NUMBER,
1181         NUMBER may now be a floating point number.
1182         (stat invocation): Remove references to now-removed %S and %C.
1183         (Time directives) [%S]: Explain why the range is [0..60].
1184
1185 2002-08-30  Jim Meyering  <jim@meyering.net>
1186
1187         * coreutils.texi [START-INFO-DIR-ENTRY]: Don't use sc{} on LHS.
1188         Fix typo: s/permission/permissions/.  From Michail Litvak.
1189
1190 2002-08-02  Paul Eggert  <eggert@twinsun.com>
1191
1192         * coreutils.texi (uniq invocation): uniq now obeys LC_COLLATE.
1193
1194 2002-07-29  Paul Eggert  <eggert@twinsun.com>
1195
1196         * coreutils.texi (nohup invocation): Change behavior to conform to
1197         POSIX 1003.1-2001:
1198           - Do not adjust scheduling priority.
1199           - Redirects stderr to stdout, if stderr is not a terminal.
1200           - Exit status is now 126 if command was found but not invoked,
1201             127 if nohup failed or if command was not found.
1202
1203 2002-07-24  Jim Meyering  <jim@meyering.net>
1204
1205         * coreutils.texi (Time directives): Document %P, %R, %e, %F,
1206         %g, %G, and %V
1207
1208 2002-07-22  Martin Michlmayr  <tbm@cyrius.com>
1209
1210         * coreutils.texi (Formatting the file names): Document
1211         that -N/--literal are equivalent to --quoting-style=literal.
1212         Reported by Oskar Liljeblad as Debian bug#103612.
1213
1214 2002-07-10  Jim Meyering  <jim@meyering.net>
1215
1216         * coreutils.texi (du invocation): s/PAT/PATTERN/.
1217         From Martin Michlmayr.
1218
1219 2002-07-08  Jim Meyering  <jim@meyering.net>
1220
1221         * coreutils.texi (cp invocation): Remove unnecessary "$@" in example;
1222         Texinfo would render the @" as an umlaut over the following character.
1223         From Paul Eggert.
1224         * Makefile.am (check-texinfo): Check for the above.
1225
1226 2002-07-06  Jim Meyering  <jim@meyering.net>
1227
1228         * coreutils.texi (stat invocation): Remove description of --secure.
1229
1230 2002-07-03  Jim Meyering  <jim@meyering.net>
1231
1232         * coreutils.texi (stat invocation): Rename --link/-l
1233         to --dereference/-L.  Rewrite description of --dereference.
1234
1235 2002-06-26  Paul Eggert  <eggert@twinsun.com>
1236
1237         * coreutils.texi (Putting the tools together): Don't mention egrep,
1238         since it's not part of POSIX 1003.1-2001.
1239
1240 2002-06-21  Jim Meyering  <jim@meyering.net>
1241
1242         * coreutils.texi (stat invocation): New section.  From Michael Meskes.
1243
1244 2002-05-19  Paul Eggert  <eggert@twinsun.com>
1245
1246         * coreutils.texi (ls invocation): Document new option: --author.
1247
1248 2002-06-03  Jim Meyering  <jim@meyering.net>
1249
1250         * coreutils.texi (rm invocation): Add the warning (also in the --help
1251         output) that the contents of a removed file are often recoverable.
1252
1253 2002-05-27  Jim Meyering  <jim@meyering.net>
1254
1255         * Makefile.am (check-texinfo): Adapt to reflect that now we use
1256         @acronym{POSIX}.
1257
1258 2002-05-26  Jim Meyering  <jim@meyering.net>
1259
1260         * coreutils.texi: Use @acronym in place of most uses of @sc.
1261         * getdate.texi (Date input formats): Likewise.
1262
1263 2002-04-28  Jim Meyering  <jim@meyering.net>
1264
1265         * coreutils.texi: Change `@code{PROG}' to `@command{PROG}'.
1266
1267 2002-04-28  Paul Eggert  <eggert@twinsun.com>
1268
1269         * coreutils.texi (kill invocation): Document the above.
1270         Document POSIX signals better.
1271
1272 2002-04-15  Jim Meyering  <jim@meyering.net>
1273
1274         * coreutils.texi: Document kill.
1275         Written by Marcus Brinkmann.
1276
1277 2002-04-13  Jim Meyering  <jim@meyering.net>
1278
1279         * coreutils.texi: Document link and unlink.
1280
1281 2002-04-08  Jim Meyering  <jim@meyering.net>
1282
1283         * coreutils.texi: Use new directives, @copying and @insertcopying,
1284         thus now requiring texinfo-4.2 to create the .info file.
1285
1286 2002-02-26  Paul Eggert  <eggert@twinsun.com>
1287
1288         * coreutils.texi (File characteristic tests): Document the
1289         behavior of test -nt and -ot when one of the files does not exist,
1290         using the same behavior that is documented in ksh93.
1291
1292 2002-03-05  Paul Eggert  <eggert@twinsun.com>
1293
1294         * coreutils.texi (cut invocation): Say that selected input is
1295         written in the same order that it is read, and is written
1296         exactly once.
1297
1298 2002-03-03  Paul Eggert  <eggert@twinsun.com>
1299
1300         Make cp -r equivalent to cp -R.  Add a new cp option --copy-contents
1301         for people who want to emulate the traditional (and rarely desirable)
1302         cp -r behavior.
1303
1304         * coreutils.texi (cp invocation): Document this.
1305         Fix some related minor bugs: --no-dereference is no longer
1306         equivalent to -d, and --archive (-a) can override the other
1307         symlink options.  Warn that cp -R is not portable on symbolic
1308         links unless you also specify -P.
1309
1310 2002-03-02  Jim Meyering  <jim@meyering.net>
1311
1312         * coreutils.texi (cp invocation): Document that cp -r
1313         preserves symlinks.  Emphasize non-portability of cp -r.
1314
1315 2002-02-27  Paul Eggert  <eggert@twinsun.com>
1316
1317         * coreutils.texi (Time directives): Add %N for nanoseconds.
1318         This documents the recent change to 'ls'.
1319
1320 2002-02-28  Jim Meyering  <jim@meyering.net>
1321
1322         * coreutils.texi (pr invocation): Reword to avoid using `:'
1323         in an @opindex entry -- info doesn't permit it.
1324
1325 2002-02-27  Paul Eggert  <eggert@twinsun.com>
1326
1327         * coreutils.texi (Formatting file timestamps): Document new
1328         time-formatting method: --time-style=+FORMAT.
1329
1330 2002-02-18  Paul Eggert  <eggert@twinsun.com>
1331
1332         * coreutils.texi (seq invocation): In the example, use "tail
1333         -n 3", not "tail -3", to conform to POSIX 1003.1-2001.
1334
1335 2002-02-17  Jim Meyering  <jim@meyering.net>
1336
1337         * coreutils.texi (tsort background): New section.
1338         From Ian Lance Taylor.
1339         (tsort invocation): Add a more realistic example.
1340
1341 2002-02-15  Paul Eggert  <eggert@twinsun.com>
1342
1343         * coreutils.texi: Document _POSIX2_VERSION.
1344         (Standards Conformance): New section.
1345
1346 2002-01-24  Jim Meyering  <jim@meyering.net>
1347
1348         * coreutils.texi (START-INFO-DIR-ENTRY): Remove a few entries
1349         and clean up a few others based on suggestions from Bob Proulx.
1350
1351 2002-02-14  Paul Eggert  <eggert@twinsun.com>
1352
1353         Add support for POSIX 1003.1-2001, which requires removal for
1354         support of obsolete "+" option syntax in sort, tail, and uniq.
1355         * coreutils.texi: Document this.  (Also, document a similar
1356         change to "touch", for fileutils).
1357
1358 2002-01-12  Jim Meyering  <jim@meyering.net>
1359
1360         * coreutils.texi (shred invocation): List some journaled filesystems.
1361
1362 2001-11-10  Jim Meyering  <jim@meyering.net>
1363
1364         * coreutils.texi (Date directives): Document %u.
1365
1366 2001-11-07  Paul Eggert  <eggert@twinsun.com>
1367
1368         * coreutils.texi (paste invocation): Give examples.
1369         Thanks to Dan Jacobson for suggesting the examples.
1370
1371 2001-11-05  Jim Meyering  <jim@meyering.net>
1372
1373         * coreutils.texi (sort invocation): Recommend setting LC_ALL=C,
1374         not LC_COLLATE=C.  Explain how the latter can cause problems.
1375         Based on a message from Paul Eggert.
1376         (ls invocation): Recommend setting LC_ALL=C, not LC_COLLATE=C.
1377
1378 2001-10-21  Jim Meyering  <jim@meyering.net>
1379
1380         * coreutils.texi (cp invocation): Describe --reply=...
1381
1382 2001-10-17  Jim Meyering  <jim@meyering.net>
1383
1384         * coreutils.texi (cp invocation): `cp --no-dereference' is
1385         no longer equivalent to `cp -d'.
1386         `cp -d' is equivalent to `--no-dereference --preserve=links'.
1387         cp's -P option means --no-dereference, not --parents.
1388         Describe new optional argument to --preserve.
1389         Describe new option: --no-preserve=ATTRIBUTE_LIST.
1390
1391 2001-09-23  Jim Meyering  <jim@meyering.net>
1392
1393         * Makefile.am (check-texinfo): Redirect stderr of `grep -w' to
1394         /dev/null, so people with old versions of grep don't see the failure.
1395
1396 2001-09-16  Jim Meyering  <jim@meyering.net>
1397
1398         * coreutils.texi (mv invocation): Describe new option:
1399         --reply={yes,no,query}.  Fix a few typos.
1400
1401 2001-09-15  Paul Eggert  <eggert@twinsun.com>
1402
1403         * coreutils.texi (uniq invocation): The input need not
1404         be sorted.  Try to clarify -d versus -D versus -u.
1405
1406 2001-09-12  Jim Meyering  <jim@meyering.net>
1407
1408         * coreutils.texi (tail invocation): Document new option: -F.
1409         From Herbert Xu.
1410
1411 2001-09-04  Paul Eggert  <eggert@twinsun.com>
1412
1413         * coreutils.texi (join invocation): Describe the GNU
1414         extension to join, which does not require sorted input when
1415         the input contains no unpairable lines.
1416
1417 2001-09-03  Paul Eggert  <eggert@twinsun.com>
1418
1419         * coreutils.texi:
1420         New 'uname' options -i or --hardware-platform,
1421         and -o or --operating-system.
1422         'uname -a' now outputs -i and -o information at the end.
1423         New uname option --kernel-version is an alias for -v.
1424         Uname option --release has been renamed to --kernel-release,
1425         and --sysname has been renamed to --kernel-name;
1426         the old options will work for a while, but are no longer documented.
1427
1428 2001-08-24  Herbert Xu  <herbert@gondor.apana.org.au>
1429
1430         * coreutils.texi (cut invocation): Document how cut treats lines
1431         with no separators.
1432
1433 2001-06-19  Paul Eggert  <eggert@twinsun.com>
1434
1435         * coreutils.texi: expr now uses LC_COLLATE for string comparison,
1436         as per POSIX.
1437
1438 2001-08-25  Jim Meyering  <jim@meyering.net>
1439
1440         * coreutils.texi: Use @option, rather than @samp everywhere.
1441
1442 2001-06-21  Paul Eggert  <eggert@twinsun.com>
1443
1444         * coreutils.texi: 'expr' now requires '+' rather than 'quote'
1445         to quote tokens.
1446
1447 2001-07-14  Jim Meyering  <jim@meyering.net>
1448
1449         * coreutils.texi (cp invocation): Reflect 2001-07-08 change to
1450         cp (via copy.c).
1451
1452 2001-06-16  Jim Meyering  <jim@meyering.net>
1453
1454         * Makefile.am (info_TEXINFOS): Reflect renaming: s/omni-/core/.
1455         * coreutils.texi: Likewise.
1456
1457         * coreutils.texi: New, renamed from omni-utils.texi.
1458         * omni-utils.texi: Removed, renamed to coreutils.texi.
1459
1460         * omni-utils.texi (ls invocation): Mention the effect of locale.
1461         Reported by Keith Thompson.
1462
1463 2001-05-24  Jim Meyering  <jim@meyering.net>
1464
1465         * texinfo.tex: Update from master source.
1466
1467         * omni-utils.texi (ls invocation): Document more clearly what ls
1468         does when given no arguments.
1469
1470 2001-05-21  Jim Meyering  <jim@meyering.net>
1471
1472         * textutils.texi: Remove file.
1473
1474         * Makefile.am ($(DVIS), $(INFO_DEPS)): Depend on $(EXTRA_DIST).
1475         (DISABLED_constants.texi): New rule -- disabled for now.
1476
1477         This directory is now shared by fileutils, textutils, and sh-utils.