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