doc/ChangeLog

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