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