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