doc/ChangeLog

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