doc/ChangeLog

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