doc/ChangeLog

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