1 2006-08-15 Paul Eggert <eggert@cs.ucla.edu>
3 * coreutils.texi (df invocation): df exits nonzero if it outputs
6 2006-08-09 Paul Eggert <eggert@cs.ucla.edu>
8 * coreutils.texi (dd invocation): Warn about oflag=append without
9 conv=notrunc. See Debian bug 373736.
11 2006-08-08 Paul Eggert <eggert@cs.ucla.edu>
13 * coreutils.texi (shuf invocation, Random sources): New sections.
14 (Operating on sorted files): Add shuf.
15 (sort invocation, shred invocation): New option --random-source.
16 (sort invocation): Fix typo: -R -> -r.
18 2006-07-28 Paul Eggert <eggert@cs.ucla.edu>
20 * coreutils.texi (install invocation, mkdir invocation):
21 Add cross-references to Directory Setuid and Setgid.
22 (install-invocation): The default mode is no longer equivalent to 755.
23 * perm.texi (Changing Special Mode Bits): Clarify u+s versus
24 a+s versus +s, and likewise for g+s.
25 (Numeric Modes): Bring back example of 0055 == 55. 4755 no
26 longer clears setgid bit on directories.
27 (Directory Setuid and Setgid): Numeric modes now affect setuid
28 and setgid on directories only if they set these bits. This
29 is so that leading 0 has no effect on numeric modes.
31 2006-07-26 Jim Meyering <jim@meyering.net>
33 * coreutils.texi (What information is listed): Mention that missing
34 pieces of information are marked with "?". From Paul Eggert.
36 2006-07-25 Paul Eggert <eggert@cs.ucla.edu>
38 * perm.texi (Directory Setuid and Setgid): Explain that this is a
39 GNU extension, and that other systems behave differently here.
41 2006-07-22 Paul Eggert <eggert@cs.ucla.edu>
43 * coreutils.texi (What information is listed): Clarify that the
44 restricted deletion flag is another name for the sticky bit.
45 * perm.texi (Mode Structure): The restricted deletion flag
46 restricts only unprivileged users.
47 (Mode Structure, Symbolic Modes, Numeric Modes): Be more careful
48 about distinguishing file mode bits from permissions bits,
49 and about execute versus search permission. The FreeBSD command
50 is chflags, not chrflags.
52 2006-07-16 Paul Eggert <eggert@cs.ucla.edu>
54 * coreutils.texi: Change GNU to @acronym{GNU} in a few places.
55 Use "set-user-ID" and "set-group-ID" a bit more consistently.
56 Use "appropriate privileges" rather than "super-user" a bit
58 (install invocation): Parent directories are now 755 without uid
59 or gid changing. The default mode is now 0755, not 755.
60 (mkdir invocation): Rewrite the top-level usage description, since
61 I couldn't easily follow the old one. It's now 3 lines not 8.
62 For -m, describe file permission bits versus other bits, and note
63 that mkdir is atomic if you don't mention special bits.
64 (chmod invocation): Mention what chmod does to setgid and setuid bits.
65 * perm.texi (Mode Structure): Modernize the explanation of the
66 setuid and setgid bits on directories.
67 (Changing Special Mode Bits): Mention that a implies both u and g
68 for s. Cross reference to new node.
69 (Numeric Modes): Don't claim that 0055 is the same as 55; this isn't
70 true any more. Mention new node.
71 4755 is now like u=rwxs,go=rx,g-s, not like u=rwxs,go=rx.
72 (Directory Setuid and Setgid): New node.
74 2006-07-08 Jim Meyering <jim@meyering.net>
76 * coreutils.texi (Squeezing): Separate doubled "the", so typo-checkers
79 * Makefile.am (check-texinfo): Enforce the zeros vs. zeroes consistency.
81 2006-07-08 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
83 * coreutils.texi: Fix some typos. Use `zeros' consistently (both
84 `zeros' and `zeroes' are correct).
86 2006-07-01 Paul Eggert <eggert@cs.ucla.edu>
88 * coreutils.texi (tail invocation): With no operand, 'tail -f' now
89 silently ignores the '-f' only if standard input is a FIFO or pipe
90 and POSIXLY_CORRECT is set.
92 2006-06-30 Paul Eggert <eggert@cs.ucla.edu>
94 * coreutils.texi (seq invocation): seq now uses long double
95 internally rather than double. It now defaults to a minimal fixed
96 point format if possible. It lets you use %a, %A, %E, %F, %G.
97 Don't assume printf doesn't work for numbers that fit in 64 but
98 not 32 bits; typically they work these days. Improve discussion
99 of large integers and update the rounding-error numbers.
101 2006-06-28 Paul Eggert <eggert@cs.ucla.edu>
103 * coreutils.texi (sort invocation): 'sort +1 -2' is now supported
104 even when conforming to POSIX 1003.1-2001, since this is a pure
107 2006-06-27 Jim Meyering <jim@meyering.net>
109 * coreutils.texi (wc invocation): Remove ./ prefix from example.
112 2006-06-26 Jim Meyering <jim@meyering.net>
114 * coreutils.texi (wc invocation): Spell out `--files0-from' in
115 the example. Suggestion from Bob Proulx.
117 * coreutils.texi (wc invocation): Document new --files0-from option.
119 2006-06-20 Eric Blake <ebb9@byu.net>
121 * coreutils.texi (sleep invocation): Document that accepting
122 multiple arguments and suffixes are extensions.
123 Reported by Dan Jacobson.
125 2006-06-12 Paul Eggert <eggert@cs.ucla.edu>
127 * Makefile.am (check-texinfo): Use $(_W) and $(W_) instead of
128 assuming grep -w (which is not portable).
130 2006-05-27 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
132 * Makefile.am: Use `AM_MAKEINFOFLAGS' rather than
133 overwriting `MAKEINFO', so that `missing' can do its job.
135 * Makefile.am (check-texinfo): Use `$(EGREP)' instead of `grep -E'.
136 (check-texinfo): Use literal `{' only in brackets, i.e., [{] or [}],
137 to avoid triggering an error from Solaris 2.6's grep.
139 2006-05-25 Paul Eggert <eggert@cs.ucla.edu>
141 * coreutils.texi (sort invocation): Remove mention of --seed, since
144 2006-05-04 Eric Blake <ebb9@byu.net>
146 * coreutils.texi (Examples of date): Give example of @seconds.
148 2006-05-03 Paul Eggert <eggert@cs.ucla.edu>
150 * coreutils.texi (head invocation, tail invocation, sort invocation):
151 Give advice about porting to hosts that support only obsolete syntax.
152 Problem reported by Zack Weinberg.
154 2006-04-23 Francesco Montorsi <fr_m@hotmail.com>
156 * coreutils.texi (Which files are listed): Describe new option:
157 --group-directories-first.
159 2006-04-17 Paul Eggert <eggert@cs.ucla.edu>
161 * coreutils.texi (What information is listed): Add P for Solaris
162 10 ports. Add commented-out entries for other types that POSIX
163 says are possible, or that I observed in FreeBSD documentation.
165 2006-04-18 Jim Meyering <jim@meyering.net>
167 * coreutils.texi (Input processing in ptx): Remove mention of the
168 default --ignore file, /usr/local/lib/eign. That file has never
169 been used. Reported by Eric Blake.
171 2006-04-12 Paul Eggert <eggert@cs.ucla.edu>
173 * coreutils.texi (expr invocation): expr exit status is 3 only for
174 internal errors now; 2 is also for invalid values in expressions.
176 (What information is listed): Document 'ls' type letters.
177 Problem reported by Lincoln Martin.
179 2006-04-09 Ori Avtalion <oavtal@bezeqint.net>
181 * coreutils.texi (Top): Add 'hostid' to System context menu line.
184 2006-03-22 Eric Blake <ebb9@byu.net>
186 * coreutils.texi (General options in ptx): Undocument --copyright.
188 2006-03-27 Eric Blake <ebb9@byu.net>
190 * coreutils.texi (dirname invocation): Macro in previous patch
193 2006-03-11 Eric Blake <ebb9@byu.net>
195 * coreutils.texi (basename invocation, dirname invocation):
196 Improve documentation to match recent // patches.
198 2006-03-23 Paul Eggert <eggert@cs.ucla.edu>
200 * coreutils.texi (nohup invocation): nohup now redirects stderr to
201 nohup.out if stdout is closed and stderr is a tty.
203 2006-03-05 Paul Eggert <eggert@cs.ucla.edu>
205 * coreutils.texi (dd invocation): New flags directory, nolinks.
206 Alphabetize nofollow.
208 2006-02-17 Simon Josefsson <jas@extundo.com>
210 * coreutils.texi: Add base64 section.
212 2006-02-20 Eric Blake <ebb9@byu.net>
214 * coreutils.texi (rm invocation): Fix typo in last patch.
215 (paste invocation): Fix whitespace.
217 2006-02-18 Eric Blake <ebb9@byu.net>
219 * coreutils.texi (rm invocation): Document new -I option, and new
220 --interactive behavior.
222 2006-02-12 Jim Meyering <jim@meyering.net>
224 * coreutils.texi (Character sets): Don't say that an unknown
225 backslash-escape causes an error message -- it doesn't.
226 Mention that `\' also removes any special significance, so
227 is useful for [, ], *, -. Prompted by Richard Neill in
228 http://savannah.gnu.org/bugs/index.php?func=detailitem&item_id=14937
230 2006-02-01 Paul Eggert <eggert@cs.ucla.edu>
232 * coreutils.texi (od invocation): Warn that -t a ignores the high
235 2006-01-30 Paul Eggert <eggert@cs.ucla.edu>
237 * coreutils.texi (tail invocation): In the obsolete usage, the
238 count is optional, so put square brackets around it.
240 2006-01-02 Paul Eggert <eggert@cs.ucla.edu>
242 * getdate.texi (General date syntax): Invalid dates are rejected.
243 (Time of day items): Mention the possibility of leap seconds.
244 Problem reported by Dr. David Alan Gilbert.
246 * coreutils.texi: Use @acronym around "ISO" uniformly.
247 (Date conversion specifiers): Explain %g, %G, and %V a bit better.
249 2006-01-02 Jim Meyering <jim@meyering.net>
251 * coreutils.texi (tail invocation): Say that --retry
252 is useful `mainly' (not `only') when following by name.
254 2006-01-01 Paul Eggert <eggert@cs.ucla.edu>
256 * coreutils.texi, perm.texi: Clarify file mode bits versus
257 file permission bits.
258 * coreutils.texi (mkfifo invocation, mknod invocation): -m
259 affects only file permission bits.
261 2005-12-29 Paul Eggert <eggert@cs.ucla.edu>
263 * coreutils.texi (sort invocation): Clarify that a blank is a space
266 2005-12-15 Jim Meyering <jim@meyering.net>
268 * coreutils.texi (stat invocation) [--printf]: Describe new option.
269 [--format]: Add example. Distinguish from --printf.
270 Sort option descriptions.
272 2005-12-05 Andreas Gruenbacher <agruen@suse.de>
274 * coreutils.texi (ls): Clarify the Alternate Access Method description.
275 (cp): Clarify that --preserve=mode also preserves acls.
277 2005-12-12 Paul Eggert <eggert@cs.ucla.edu>
279 * coreutils.texi (sort invocation): Clarify explanation of
280 --random-sort, and use a simpler example.
282 2005-12-10 Frederik Eaton <frederik@ofb.net>
284 * coreutils.texi (sort invocation): Add --random-sort (-R) and --seed.
286 2005-12-07 Paul Eggert <eggert@cs.ucla.edu>
288 * coreutils.texi (dd invocation): New noatime flag.
290 2005-11-25 Paul Eggert <eggert@cs.ucla.edu>
292 * coreutils.texi (df invocation): Document treatment of dummy file
295 2005-11-16 Paul Eggert <eggert@cs.ucla.edu>
297 * coreutils.texi (ln invocation): ln -v now outputs lines only for
299 (tail invocation): Say that the obsolete form uses exactly one
300 option and at most one file.
302 2005-11-13 Jim Meyering <jim@meyering.net>
304 * perm.texi (Mode Structure): Capitalize two sentences in an
305 enumerated list and fix a typo. From Aaron Hawley.
307 2005-11-08 Paul Eggert <eggert@cs.ucla.edu>
309 * coreutils.texi (Formatting file timestamps): ls now defaults to
310 --time-style='locale', which in turn acts like
311 --time-style='posix-long-iso' if the locale settings are messed up.
313 2005-11-02 Paul Eggert <eggert@cs.ucla.edu>
315 * coreutils.texi (rm invocation): Don't mention --directory (-d).
317 2005-11-01 Paul Eggert <eggert@cs.ucla.edu>
319 * coreutils.texi (tail invocation): Describe obsolete usages
320 like "tail -2" more precisely.
321 (touch invocation): The old usage works only for 1969-1999 now.
323 2005-08-28 David Madore <david.madore@ens.fr>
325 * coreutils.texi: Document SHA-1 and SHA-2 utilities.
327 2005-10-15 Paul Eggert <eggert@cs.ucla.edu>
329 * doc/coreutils.texi (Top, General output formatting, dir invocation):
330 (vdir invocation): Don't document the old v and d commands.
332 2005-10-15 Jim Meyering <jim@meyering.net>
334 * coreutils.texi (du invocation): Document du's -m option,
335 now that we've decided to keep it.
336 (who invocation): Remove documentation for deprecated --idle (-i).
338 2005-10-13 Jim Meyering <jim@meyering.net>
340 * coreutils.texi: Avoid a few overfull/underfull hboxes.
342 2005-09-24 Paul Eggert <eggert@cs.ucla.edu>
344 * coreutils.texi (touch invocation):
345 "touch -" now touches standard output.
347 2005-09-17 Paul Eggert <eggert@cs.ucla.edu>
349 * coreutils.texi (who invocation): Remove a stray '+'.
351 2005-09-15 Paul Eggert <eggert@cs.ucla.edu>
353 * coreutils.texi (uname invocation): uname -a no longer generates
354 the -p and -i outputs if they are unknown.
356 2005-09-13 Paul Eggert <eggert@cs.ucla.edu>
358 * coreutils.texi (Time conversion specifiers, Options for date):
359 Document date --rfc-3339 and new specifiers %:z, %::z, %:::z. Use
360 "date and time" consistently; the old version sometimes said "time
361 and date". Fix a minor bug in the documentation for --rfc-2822:
362 it claimed day-of-month < 10 had leading space, not leading zero.
363 Use a consistent format for terms like "RFC".
364 (uname invocation): Mention that Linux outputs "unknown" for
367 2005-09-08 Paul Eggert <eggert@cs.ucla.edu>
369 * coreutils.texi (nice invocation): Document "niceness" versus
370 "nice value" versus "scheduling priority".
372 2005-09-07 Paul Eggert <eggert@cs.ucla.edu>
374 * coreutils.texi (nice invocation): Use "niceness", not "nice value"
375 to talk about nice values offset by -20. Don't use the word
376 "priority" when niceness is intended.
378 2005-08-15 Jim Meyering <jim@meyering.net>
380 * coreutils.texi (join invocation): Itemize the defaults.
383 2005-08-12 Jim Meyering <jim@meyering.net>
385 * coreutils.texi (cp invocation, mv invocation): Remove square
386 brackets in --reply=[HOW]. Reported by Oscar Liljeblad.
388 2005-07-19 Paul Eggert <eggert@cs.ucla.edu>
390 * coreutils.texi (md5sum invocation): --check now allows multiple
393 2005-07-18 Paul Eggert <eggert@cs.ucla.edu>
395 * coreutils.texi (false invocation):
396 Mention that false is often built-in, and that it exits
397 with status >1 on some hosts.
398 (true invocation): Remove now-incorrect "non-POSIX mode" reference.
400 2005-07-15 Paul Eggert <eggert@cs.ucla.edu>
402 * coreutils.texi (nohup invocation): POSIXLY_CORRECT no longer
403 affects nohup's behavior. Input is redirected from /dev/null.
405 2005-07-11 Paul Eggert <eggert@cs.ucla.edu>
407 * coreutils.texi (cat invocation): Remove -B or --binary option
408 (available on MS-DOS-like platforms only). Explain when text and
409 binary mode are used now.
410 (md5sum invocation): -b actually does have an effect on Unix: it
411 causes "*" to be output. Explain when text and binary mode are
414 2005-07-03 Jim Meyering <jim@meyering.net>
416 * coreutils.texi (cp invocation): Mark --reply as deprecated.
417 (mv invocation): Likewise.
419 2005-06-24 Jim Meyering <jim@meyering.net>
421 * coreutils.texi (cp invocation): Clarify how --reply=no works.
423 2005-06-14 William Brendling <wbrendling@gmail.com>
425 * coreutils.texi (du invocation): New options --last-time and
428 2005-06-19 Jim Meyering <jim@meyering.net>
430 * coreutils.texi (ln invocation): Change a few `paths' to `file names'.
431 * Makefile.am (check-texinfo): Also catch uses of path, pathname.
433 2005-06-17 Jim Meyering <jim@meyering.net>
435 * coreutils.texi (shred invocation): Clarify that shred
436 works on ext3 as long as it's not in data=journal mode.
437 Patch from Mark Melahn.
439 2005-06-16 Jim Meyering <jim@meyering.net>
441 * coreutils.texi (Backup options): Undocument --version-control=S (-V).
443 2005-06-07 Jim Meyering <jim@meyering.net>
445 * coreutils.texi (ln invocation): Examples, from Bob Proulx.
447 2005-06-01 Paul Eggert <eggert@cs.ucla.edu>
449 Use "file name" when talking about file names, instead of "filename"
450 or "path", as per the GNU coding standards.
451 * coreutils.texi (readlink invocation): "path component" ->
452 "component", since we don't use the POSIX "path" nomenclature.
454 2005-05-11 Paul Eggert <eggert@cs.ucla.edu>
456 * getdate.texi (General date syntax): Don't say that date
457 date --iso-8601=ns generates acceptable dates; it doesn't yet.
458 Problem reported by Nic Ferrier.
460 2005-05-06 Paul Eggert <eggert@cs.ucla.edu>
462 * coreutils.texi (dd invocation): New flags "binary" and "text".
464 2005-05-04 Paul Eggert <eggert@cs.ucla.edu>
466 * coreutils.texi (chmod invocation): chmod -w complains if its
467 behavior differs from what chmod a-w would do.
469 2005-05-02 Paul Eggert <eggert@cs.ucla.edu>
471 * coreutils.texi (ls invocation): ls --indicator-style=directory
472 renamed to ls --indicator-style=slash, to avoid confusion with ls
475 2005-04-28 Paul Eggert <eggert@cs.ucla.edu>
477 * perm.texi (Mode Structure, Changing Special Permissions):
478 (Conditional Executability, Numeric Modes):
479 These days the sticky bit is more often uses as the restricted
480 deletion flag, so modernize the discussion about this.
481 (Mode Structure): Linux/GNU -> GNU/Linux.
482 (Symbolic Modes): Don't imply that "+ur" or "u" is valid.
483 (Setting Permissions): Don't imply that "+t" is invalid.
484 Use "rwx" rather than the less-common "rxw" in an example.
485 (Copying Permissions): Say that ugo is a replacement for
486 a string of the other letters. Add spaces around examples.
487 Use "set-user-ID" rather than "set user ID" to avoid ambiguity.
488 Use "+t" rather than "o+t", since POSIX doesn't specify the latter.
489 Mention which combinations are portable and which are GNU.
490 (Numeric Modes): Don't imply they aren't portable; they are
493 2005-04-26 Paul Eggert <eggert@cs.ucla.edu>
495 * coreutils.texi (Standards conformance): Do not mention head -10,
496 since it now works the same regardless of POSIX version.
497 (od invocation): -w N -> -w[N].
498 (pr invocation): -S STRING -> -SSTRING.
499 (fold invocation): -WIDTH works even when conforming to POSIX
501 (head invocation, tail invocation): Likewise for -NUM.
502 (split invocation): Likewise for -LINES.
503 (uniq invocation): Likewise for -N.
504 (expand invocation, unexpand invocation): Likewise for -TAB.
505 (nice invocation): Likewise for -ADJUSTMENT.
506 (sort invocation): Clarify explanation of +N option.
507 (uniq invocation): Likewise.
508 (join invocation): Remove special case for --help, --version.
509 (touch invocation): Clarify explanation of date options.
510 (Options for date): -I timespec -> -I[timespec].
512 2005-04-23 Paul Eggert <eggert@cs.ucla.edu>
514 * coreutils.texi (install invocation): Use a= instead of 0 for
515 the point of departure for -m, and explain what it meeams.
516 (mkdir invocation, mkfifo invocation, mknod invocation):
517 The umask does not affect the point of departure.
518 Problem reported by Mike Stone.
520 2005-04-11 Paul Eggert <eggert@cs.ucla.edu>
522 * coreutils.texi: For consistency, standardize on "user ID" rather
523 than "uid" or "UID" or "user id". Similarly for "group ID".
525 2005-04-09 Jim Meyering <jim@meyering.net>
527 * coreutils.texi (rm invocation): Say that --recursive removes
528 listed directories too, not just their contents.
530 2005-04-08 Paul Eggert <eggert@cs.ucla.edu>
532 * coreutils.texi (dd invocation): Document the distinction between
533 INFO and USR1 for dd, and the effect of POSIXLY_CORRECT here.
535 2005-04-05 Paul Eggert <eggert@cs.ucla.edu>
537 * coreutils.texi (cat invocation, chown invocation)
538 (chgrp invocation, basename invocation, dirname invocation):
539 Add examples, which are copies of the examples newly added
540 to the usage messages.
541 (ln invocation): Use same format as other examples above,
544 2005-03-26 Paul Eggert <eggert@cs.ucla.edu>
546 * coreutils.texi: Clarify NUL vs null byte vs null character.
548 2005-03-18 Paul Eggert <eggert@cs.ucla.edu>
550 * coreutils.texi (nohup invocation): Clarify nohup.out creation.
552 2005-03-11 Paul Eggert <eggert@cs.ucla.edu>
554 * coreutils.texi (Formatting file timestamps): Very long timestamps
555 may be treated as errors.
557 2005-03-08 Paul Eggert <eggert@cs.ucla.edu>
559 * coreutils.texi (date invocation): Use an example that makes it
560 clear tha the default date use space-padded day of month.
561 Replace "directive" with "conversion specifier" to be consistent
562 with POSIX. All uses changed.
563 Fix menu RHS to match actual directive lists.
564 (Time conversion specifiers): Renamed from Time directives.
565 Use @samp consistently, sometimes instead of @code.
566 Consistently ention which specifiers are GNU extensions.
567 Give more examples (in some cases, instead of ranges).
568 Say why %F is preferred for dates.
569 (Date conversion specifiers): Renamed from Date directives.
570 Likewise for other changes.
571 (Padding and other flags): Correct the description.
572 Document #. Give an example for %9B.
574 2005-02-23 Paul Eggert <eggert@cs.ucla.edu>
576 * coreutils.texi: Adjust to match current strftime.c.
577 (Time directives): Say that %k, %l, and %P are GNU extensions.
578 For %p and %P, mention handling of noon and midnight.
579 For %s, use ISO 8601, and mention handling of leap seconds.
580 For %S, clarify mention of leap seconds.
581 For %T, say that it's the same as %H:%M:%S.
582 For %X, don't say that it must be the same as %H:%M:%S.
583 For %z and %Z, clarify which time zones are used. These options
584 are now affected by --date, so don't claim that they're not.
585 (Date directives): %C is now all but the last two chars of %Y.
586 For %D, say that it's equivalent to %m/%d/%y.
587 For %e, use blank in example.
588 For %h, use @code for %b.
589 For %Y, mention what happens with outlandish years.
590 (Padding and other flags): Renamed from Padding.
591 Mention that the flags are GNU extensions.
592 Mention the 0 and ^ flags.
593 Mention field widths an modifiers.
594 (Examples of date): - is a flag, not a modifier.
596 2005-01-07 Jim Meyering <jim@meyering.net>
598 * coreutils.texi (sort invocation): Specify that a string
599 of zero digits is interpreted as 0. Reported by Ulrich Hermisson.
601 2005-01-04 Jim Meyering <jim@meyering.net>
603 * coreutils.texi (shred invocation): Clarify that shred works fine
604 with journaled file systems that are configured not to journal
605 file system data. Also mention BFS and NTFS.
607 2004-12-15 Paul Eggert <eggert@cs.ucla.edu>
609 * coreutils.texi (ls invocation): Change minor problem to be
610 "subdirectory not found", since top-level trouble is now serious.
611 (dircolors invocation): Quote argument to eval. Problem reported
612 by Stephane Chazelas.
614 2004-12-11 Paul Eggert <eggert@cs.ucla.edu>
616 * coreutils.texi (join invocation): Mention that blank separators
617 in the -o option need to be quoted. Problem reported by Phil Clayton.
619 2004-12-10 Paul Eggert <eggert@cs.ucla.edu>
621 * coreutils.texi (id invocation): -G also prints main group.
622 Problem reported by Tim Waugh.
624 2004-12-09 Paul Eggert <eggert@cs.ucla.edu>
626 * coreutils.texi (ls invocation): Document new "ls" exit status.
628 2004-12-08 Paul Eggert <eggert@cs.ucla.edu>
630 * getdate.texi (Time of day items, Time zone items):
631 Describe new formats +00:00, UTC+00:00.
633 2004-12-04 Jim Meyering <jim@meyering.net>
635 * coreutils.texi (cut invocation): Say when --complement is useful.
637 2004-10-01 Paolo Bonzini <bonzini@gnu.org>
639 * coreutils.texi (cut invocation): Document --complement and
640 adjust the documentation of -b, -c, -f.
642 2004-11-27 Paul Eggert <eggert@cs.ucla.edu>
644 * coreutils.texi (du invocation): Use if=/dev/null rather
645 than :|. Problem reported by Dan Jacobson.
646 Use "seek=2GiB" rather than the wordier "seek=`echo '2^31'|bc`".
647 Say "KiB" not the (inaccurate) "kilobytes".
648 Similarly for "GiB" and "gigabytes".
650 2004-11-16 Paul Eggert <eggert@cs.ucla.edu>
652 * coreutils.texi: Changes inspired by Debian coreutils 5.2.1-2.
653 (General output formatting): -x doesn't have an operand.
654 (Formatting the file names): Warn that even with -N unprintable
655 chars are still printed as '?' some times.
656 (rm invocation): Reword rm -d to note that it's sometimes useful
658 (logname invocation, users invocation, who invocation):
659 The utmp and wtmp file names vary from system to system.
661 * getdate.texi (General date syntax): "next" is 1, not 2.
662 Document that "second" isn't allowed as an ordinal number.
664 2004-11-15 Paul Eggert <eggert@cs.ucla.edu>
666 * coreutils.texi (dd invocation): Reword the new dd message.
668 2004-11-14 Paul Eggert <eggert@cs.ucla.edu>
670 * coreutils.texi (dd invocation): dd now outputs total bytes,
671 seconds, and bytes per second.
673 2004-11-03 Paul Eggert <eggert@cs.ucla.edu>
675 * Makefile.am (_W, W_): New macros.
676 (check-texinfo): Use them instead of assuming grep -w (which is not
679 2004-10-29 Paul Eggert <eggert@cs.ucla.edu>
681 * coreutils.texi: Document TZ better, and adjust to new getdate.texi.
683 (pr invocation, Formatting file timestamps, touch invocation,
684 stat invocation, who invocation, date invocation, Options for date):
686 * getdate.texi: Sync from gnulib.
688 2004-10-28 Paul Eggert <eggert@cs.ucla.edu>
690 * coreutils.texi (Standards conformance): Use "head -10" rather
691 than "head -1" as example of obsolete usage, since the POSIX
692 consensus is that "head -1" could be supported even if we don't
693 yet have clear consensus on "head -10". See today's revision to
695 <http://www.opengroup.org/austin/papers/single_unix_faq.html>.
697 2004-10-24 Paul Eggert <eggert@cs.ucla.edu>
699 * coreutils.texi (pathchk invocation): Options must precede operands.
701 2004-10-17 Paul Eggert <eggert@cs.ucla.edu>
703 * coreutils.texi (pathchk invocation): Overall lengths are
704 OS limits, not file system limits. Component length checks
705 apply to all components, not merely to existing ones. Say
706 that nonexistent names are not errors. For -p, omit all
707 checks based on the underlying file system, not merely length
708 checks. Explain what the portable file name character set is.
710 2004-10-15 Paul Eggert <eggert@cs.ucla.edu>
712 * coreutils.texi (printf invocation): Mention ISO/IEC 10646 as
713 well as Unicode. Various minor formatting cleanups.
715 2004-10-13 Paul Eggert <eggert@cs.ucla.edu>
717 * coreutils.texi (sort invocation): Move LC_ALL, LC_COLLATE
718 index entries to proper paragraph.
720 2004-10-12 Jim Meyering <jim@meyering.net>
722 * Makefile.am (check-texinfo): Add `builtin' and `builtins' to
723 the list of words to avoid.
725 2004-10-11 Paul Eggert <eggert@cs.ucla.edu>
727 * coreutils.texi (Special built-in utilities): New node.
728 (printf invocation): builtin -> built-in, for consistency
729 with POSIX terminology.
730 (test invocation, pwd invocation):
731 Use specific rather than generic language to warn about
733 (chroot invocation, env invocation, nice invocation, nohup invocation):
734 Warn that command must not be a special built-in.
735 (env invocation): Warn about environment variables with unusual
736 spellings, or duplicates.
738 2004-09-26 Paul Eggert <eggert@cs.ucla.edu>
740 * coreutils.texi (ls invocation): Document "ls --hide".
742 2004-09-24 Paul Eggert <eggert@cs.ucla.edu>
744 * coreutils.texi (chmod invocation): Warn about "chmod -w file".
746 2004-09-23 Paul Eggert <eggert@cs.ucla.edu>
748 * coreutils.texi (tail invocation): Fix bugs in the description of
749 the obsolete syntax (e.g., it does not support -k or -m). Warn
750 about usages like "tail -" and "tail -c 4" that are ambigous on
753 2004-09-20 Paul Eggert <eggert@cs.ucla.edu>
755 * coreutils.texi (mv invocation, rm invocation): Say "the response
756 is affirmative" rather than "the response begins with y or Y",
757 so that the documentation is accurate in non-English locales.
758 Problem reported by Munzir Taha.
760 2004-09-18 Paul Eggert <eggert@cs.ucla.edu>
762 * coreutils.texi (dd invocation): Distinguish between options
763 (e.g., --help) and operands (e.g., if=file). Move miscellaneous
764 stuff after the operand descriptions, for clarity.
766 2004-09-09 Paul Eggert <eggert@cs.ucla.edu>
768 * coreutils.texi (sort invocation): -u disables the last-resort
769 comparison, too. Revamp its description.
770 (test invocation): Document -r, -w, -x more carefully.
772 2004-09-08 Paul Eggert <eggert@cs.ucla.edu>
774 * coreutils.texi (Common options): Some programs don't reorder
776 (tr invocation, echo invocation, printf invocation, test invocation,
777 expr invocation, basename invocation, chroot invocation,
778 nice invocation, nohup invocation, seq invocation):
779 This program doesn't reorder options.
780 (tr invocation): Mention --help, --version, --.
781 (echo invocation): Mention that -- isn't special.
782 (test invocation): Mention that the expression is optional,
783 and that test ! EXPR is like ! test EXPR.
784 Mention that -h and -L don't dereference symlinks.
785 (expr invocation): Mention --help, --version.
787 * coreutils.texi (sort invocation): Add remarks about sort -u
788 versus sort | uniq. Prompted by a question from Andrew Noymer.
790 2004-09-06 Paul Eggert <eggert@cs.ucla.edu>
792 * coreutils.texi (od invocation): Several changes for POSIX
793 and FreeBSD compatibility. Add support for XSI syntax
794 (POSIX 1003.1-2004). Rename -s[N] to -S N. Remove documentation
795 for -h. -i is now -t dI (not d2) and -l is now -t dL (not d4).
797 2004-09-05 Paul Eggert <eggert@cs.ucla.edu>
799 * coreutils.texi (String tests): Improve quality of warning about
800 quoting strings for the shell.
802 2004-09-03 Paul Eggert <eggert@cs.ucla.edu>
804 * coreutils.texi (dd invocation): Specify which conversion options
805 are mutually exclusive. Give a bit more detail about ascii,
806 ebcdic, and ibm conversions.
808 2004-08-24 Paul Eggert <eggert@cs.ucla.edu>
810 POSIX-conformance fixes for "expand" and "unexpand".
811 * coreutils.texi: Standardize on "tab stop" (the POSIX usage)
812 rather than "tabstop".
813 (unexpand invocation): Use "blank" rather than "space" when
814 POSIX requires "blank". Define "blank". Initial blanks are
815 converted even if there's just one. For -a, convert two or
816 more blanks only if they occur just before a tab stop.
818 2004-08-19 Paul Eggert <eggert@cs.ucla.edu>
820 * coreutils.texi (chown invocation): Fix synopsis:
821 group must always be preceded by separator.
822 "chown : file" and "chown '' file" don't change the owner or group.
823 Update the explanation of what happens to the set-user-ID or
824 set-group-ID bits, e.g., they sometimes are not cleared if they
825 denote mandatory locking. Change "find"-oriented examples to use
828 2004-08-18 Paul Eggert <eggert@cs.ucla.edu>
830 * coreutils.texi (printf invocation): Clarify how "printf" is
831 supposed to work with extra arguments, missing arguments, etc.
833 2004-08-10 Paul Eggert <eggert@cs.ucla.edu>
835 POSIX-conformance fixes for "-" used as an operand.
836 * coreutils.texi (Common options): Clarify that "-" means
837 stdin/stdout only when it is an operand, not when it is an
839 (shred invocation): "shred -- -" is equivalent to "shred -",
841 (tee invocation): "tee -" means to copy (again) to stdout.
843 2004-07-25 Paul Eggert <eggert@cs.ucla.edu>
845 * coreutils.texi (nice invocation): Document the "nice value", and
846 how it affects the scheduling priority. (The old documentation
847 implied that the nice value equaled the scheduling priority, which
848 isn't accurate.) Document that the range of nice values might
849 exceed -20..19. Specify what happens when you give a nice value
850 that is out of range, or when you don't have permissions to lower
851 the nice value. Bash doesn't have a builtin 'nice', so don't say
852 "most shells" have one.
854 2004-04-03 Dmitry V. Levin <ldv@altlinux.org>
856 * coreutils.texi (readlink invocation): Document new
857 "readlink -f" behaviour and new canonicalize options, -e and -m.
859 2004-07-02 Jim Meyering <jim@meyering.net>
861 * Makefile.am (check-texinfo): Disallow `filename' in .texi files.
862 Spell it like `file name' instead, to be consistent.
863 Fail if a @footnote directive follows non-punctuation.
864 Fail upon use of @url. Use @uref instead.
866 2004-07-01 Paul Eggert <eggert@cs.ucla.edu>
868 * coreutils.texi (Common options, Target directory, cp invocation,
869 install invocation, mv invocation, ln invocation): Add -t as a
870 short option for --target-directory, and -T as a short option for
871 --no-target-directory. Clean up relevant synopses a bit, so that
872 the language is similar for all.
874 2004-06-30 Paul Eggert <eggert@cs.ucla.edu>
876 * coreutils.texi: Put the right amount of space at sentence ends.
877 Make sure "i.e." and "e.g." are followed by commas (the GNU style).
878 Put blank lines before and after every @example, prefer the
879 previous line to end in ":" (when not a sentence end, for consistency),
880 and prepend @noindent to the following line when appropriate.
881 In examples, use "--" arguments when needed to prevent undesired
882 interpretation of operands as options.
883 Use "file name" rather than "filename", as per the GNU coding standards.
884 Remove unwanted spaces before @footnote.
885 Use "---" when appropriate, instead of " -- ".
886 Use "name" (or something like that) rather than "path" or "pathname",
887 since the GNU coding standards don't allow "path".
888 Use @acronym, @command, @minus{}, @samp in a few places,
890 (Target directory): Clarify description of example.
891 (fmt invocation): Give issue number for reference, and reword
893 (sort invocation): Note that xargs without -0 also mishandles
894 file names containing some special characters other than newline.
895 (Translating): Mention that \012 is not universally portable.
896 Use '\0' rather than '\000'.
897 (Squeezing): bourne -> Bourne.
898 Fix unportable usage of '\n' by replacing it with '[\n*]'.
899 (More details about version sort): Remove unnecessary indent
901 (dd invocation): Use 'kill -s USR1', not 'kill -USR1', as POSIX
902 indicates that the former is more portable (the latter is an XSI
904 (shred invocation): Use @uref rather than @url, and use a more-typical
906 (kill invocation): Clarify usage; for example, "kill -s TERM -1"
908 (seq invocation): Reword to avoid implying that printf necessarily
909 fails for numbers outside the 32-bit range. Prefer separating
910 options from their operands.
911 (Opening the software toolbox): Give an online reference to
912 Robbins's article, and give a date. Don't imply that the
913 current documentation is unchanged from his article.
914 (Putting the tools together): Rework examples so that they don't
915 assume the C locale; nowadays many users now operate outside the C
916 locale by default. While we're at it, don't assume ASCII either.
917 Indent example to match actual output from GNU uniq. Remove some
918 unnecessary and confusing brackets from 'tr' operands. "Software
919 Tools in Pascal" is back in print, according to Amazon anyway.
920 Add references to Kernighan's online copies of examples.
922 2004-06-30 Paul Eggert <eggert@cs.ucla.edu>
924 * coreutils.texi, perm.texi: Standardize on "file system" rather
925 than "filesystem", as POSIX prefers it with a space.
927 2004-06-29 Paul Eggert <eggert@cs.ucla.edu>
929 * coreutils.texi (Common options, Target directory, cp
930 invocation, install invocation, mv invocation, ln invocation):
932 (link invocation): Explain how to rewrite link using ln now
933 that we have --no-target-directory.
934 (ln invocation): Explain that --no-target-directory subsumes
936 (unlink invocation): Modify wording to match new wording in
939 2004-06-25 Paul Eggert <eggert@cs.ucla.edu>
941 * coreutils.texi (install invocation): Document
942 --target-directory in synopsis, too.
944 2004-06-15 Paul Eggert <eggert@cs.ucla.edu>
946 * coreutils.texi (yes invocation): "--" is now supported.
947 (false invocation, true invocation): --help and --version now
948 work unconditionally.
950 2004-06-07 Jim Meyering <jim@meyering.net>
952 * coreutils.texi: Remove menu references to just-removed subsection.
954 2004-06-06 Jim Meyering <jim@meyering.net>
956 * coreutils.texi (tr invocation): Remove the section describing
957 how POSIXLY_CORRECT changes tr's behavior.
959 2004-06-02 Jim Meyering <jim@meyering.net>
961 * coreutils.texi (cut invocation): Clarify what --output-delimiter=STR
962 does with byte/character ranges.
964 2004-06-01 Paul Eggert <eggert@cs.ucla.edu>
966 * coreutils.texi (tr invocation): Mention -C.
968 2004-05-13 Paul Eggert <eggert@cs.ucla.edu>
970 * coreutils.texi (echo invocation): Document today's changes.
972 2004-05-17 Jim Meyering <jim@meyering.net>
974 chgrp and chown now dereference symlinks by default, per POSIX.
975 * coreutils.texi (chgrp invocation, chown invocation): Document it.
977 2004-05-13 Paul Eggert <eggert@cs.ucla.edu>
979 * coreutils.texi (sort invocation): Document that "sort -m -o F"
980 might write F before reading all the input.
982 2004-05-09 Jim Meyering <jim@meyering.net>
984 * coreutils.texi (stat invocation): Change IO to I/O.
985 * Makefile.am (check-texinfo): Check for the above.
987 2004-04-25 Paul Eggert <eggert@twinsun.com>
989 * coreutils.texi (sort invocation): Mention -k earlier, so
990 that the options are in alphabetical order. Describe how -b works
991 more-accurately; this involves fixing some examples, too. Mention
992 what happens if the start field falls after an end field or after
993 a line end. Warn about using -k without -b, -g, -M, -n, or -t.
994 Add an example of how to sort IPv4 addresses and Apache Common
995 Log Format dates. Remove a duplicate example.
996 (Putting the tools together): Use separate options rather
997 than agglomerating them.
999 2004-03-27 Paul Eggert <eggert@twinsun.com>
1001 cp -pu and mv -u (when copying) now take the destination
1002 file system time stamp resolution into account.
1004 * coreutils.texi (mv invocation): Document this.
1005 (cp invocation): Document -u (it was missing!) with new behavior.
1007 2004-04-08 Paul Eggert <eggert@cs.ucla.edu>
1009 * coreutils.texi (dd invocation): Remove noctty flag from dd.
1011 2004-04-07 Paul Eggert <eggert@twinsun.com>
1013 New dd conv= symbols nocreat, excl, fdatasync, fsync,
1014 and new dd options iflag= and oflag=.
1016 * coreutils.texi (dd invocation): Document them.
1018 2004-04-07 Jim Meyering <jim@meyering.net>
1020 * coreutils.texi (stty invocation - Input): Document new iutf8 option.
1022 2004-04-04 Jim Meyering <jim@meyering.net>
1024 * coreutils.texi (stat invocation): Correct --format description.
1026 2004-02-25 Paul Eggert <eggert@twinsun.com>
1028 * coreutils.texi (Block size): Document new envvar BLOCKSIZE.
1030 2004-03-24 Jim Meyering <jim@meyering.net>
1032 * Makefile.am (check-texinfo): Add a check to ensure future
1033 consistency in using @sc{nul}, not `NUL'.
1035 2004-03-23 Paul Eggert <eggert@twinsun.com>
1037 * coreutils.texi: Use @sc{nul} consistently for NUL.
1038 (du invocation): FILE0 -> FILE.
1040 2004-03-23 Jim Meyering <jim@meyering.net>
1042 * coreutils.texi (du invocation): --files0-from is useful with
1043 --total (-c), not with --summarize.
1045 2004-03-22 Jim Meyering <jim@meyering.net>
1047 * coreutils.texi: Tweak a few lines that resulted in
1048 `overfull hbox' warnings.
1050 2004-03-03 Jim Meyering <jim@meyering.net>
1052 * coreutils.texi (du invocation): Document new option: --file0-from=F.
1054 2004-02-29 Paul Eggert <eggert@twinsun.com>
1056 * coreutils.texi (touch invocation):
1057 Describe use of fractional seconds.
1058 (date invocation, Options for date): Likewise.
1059 * getdate.texi (General date syntax, Time of day items): Likewise.
1060 * coreutils.texi (date invocation): Mention effect of LC_TIME.
1061 (Options for date): Describe new --iso-8601=ns option.
1063 * getdate.texi: Add copyright notice. Change getdate to
1064 get_date when talking about the function name.
1065 (Seconds since the Epoch): New section, containing the time_t
1066 info moved from Date input formats section, along with new
1067 info about the @ syntax. Mention negative time stamps,
1068 fractional time stamps, and leap seconds.
1069 (General date syntax): Modernize examples a bit to reflect new
1071 (General date syntax, Relative items in date strings):
1072 Use ' rather than " to quote formats.
1073 (Time of day items): Add an example with fractional seconds.
1074 Describe fractional-second syntax.
1076 2004-03-15 Jim Meyering <jim@meyering.net>
1078 * coreutils.texi (date invocation): Add missing `C' to %[...] range
1079 in the `Date directives:: ...' menu entry. From Bob Proulx.
1081 * coreutils.texi: Add FIXME comment:
1082 The following don't have `invocation' nodes: [, pinky, shasum, uptime.
1084 2004-03-10 Jim Meyering <jim@meyering.net>
1086 * coreutils.texi (Sorting the output): Remove description of
1087 ls's --sort=directory option. ls doesn't accept that option, yet.
1088 Reported by Arvind Autar.
1090 * coreutils.texi (cp invocation): Improve description of
1091 cp's --sparse=WHEN option.
1093 * coreutils.texi (nl invocation): Specify that these are _basic_
1094 regular expressions (BRE), and add a link to grep's documentation.
1095 Suggestion from Dan Jacobson.
1097 2004-02-23 Paul Eggert <eggert@twinsun.com>
1099 * coreutils.texi (chown invocation): Document that chown now falls
1100 back on USER.GROUP parsing regardless of POSIX version, as POSIX
1101 1003.1-2001 allows that behavior as a compatible extension.
1103 2004-02-22 Jim Meyering <jim@meyering.net>
1105 * coreutils.texi (du invocation): Mention that using du's -H option
1106 currently evokes a warning.
1108 2004-02-15 Paul Eggert <eggert@twinsun.com>
1110 * coreutils.texi (expr invocation):
1111 Document what forms integers may take, and say "integer"
1112 consistently instead of "number". Warn about operands
1113 that "expr" can misinterpret, and how to work around the
1116 2004-02-17 Jim Meyering <jim@meyering.net>
1118 * coreutils.texi (csplit invocation): Correct typo (s/LINE/N/)
1119 in description of `N' pattern. From Reuben Thomas <rrt@sc3d.org>
1121 2004-02-11 Jim Meyering <jim@meyering.net>
1123 * coreutils.texi (Time directives): The %s value *is* changed by the
1124 --date=DATE option; don't say otherwise. Patch from Padraig Brady.
1126 2004-02-10 Paul Eggert <eggert@twinsun.com>
1128 * coreutils.texi (Formatting the file names):
1129 Improve wording for --quoting-style documentation.
1130 Suggestions by Bruno Haible.
1132 2004-02-02 Jim Meyering <jim@meyering.net>
1134 * coreutils.texi (nice invocation): Add examples.
1135 Prompted by a suggestion from Dan Jacobson.
1136 (factor invocation): Add an example.
1137 Update timing numbers for a more modern CPU.
1139 2004-01-27 Jim Meyering <jim@meyering.net>
1141 * coreutils.texi (seq invocation): Remove `@dots{}' at end of synopsis.
1142 Separate `Synopses' section into three examples.
1143 Clarify first paragraph. @w{}-protect an expression.1
1144 Use @option{--option}, rather than @code{--option}.
1146 2004-01-19 Paul Eggert <eggert@twinsun.com>
1148 * coreutils.texi (Exit status): Document that ordinary failure
1149 might not exit with status 1 on unusual platforms.
1150 Mention chroot, env, nice, and su as having unusual exit
1151 status patterns. Don't bother to mention true and false
1152 since their exit status patterns are actually normal.
1153 (sort invocation, su invocation): Mention its unusual exit
1155 (chroot invocation): Simplify description of exit status 1.
1156 Remove duplicate description of status 127.
1157 (env invocation): Use consistent tenses; simplifiy description
1159 (nice invocation): Likewise.
1161 2003-12-15 Paul Eggert <eggert@twinsun.com>
1163 * coreutils.texi (touch invocation): touch -r and -d can now
1164 both be specified, with -r specifying the origin for -d.
1166 2004-01-15 Alfred M. Szmidt <ams@kemisten.nu>
1168 Factor out some common options.
1169 * coreutils.texi (Common options): Define macros here.
1170 (What information is listed, cp invocation): Use the macro(s).
1171 (install invocation, mv invocation, ln invocation): Likewise.
1172 (df invocation, du invocation): Likewise.
1174 2004-01-09 Jim Meyering <jim@meyering.net>
1176 Document the exit status of each and every program.
1177 * coreutils.texi (yes invocation): Document that a write error
1178 makes `yes' exit unsuccessfully.
1179 (chroot invocation): Enumerate the meaning of exit status values.
1180 (nice invocation): Likewise.
1181 (Exit status) [@macro exitstatus]: New macro.
1182 Use @exitstatus to describe the exit status of most programs.
1184 2004-01-02 Jim Meyering <jim@meyering.net>
1186 * coreutils.texi (du invocation): Mention that -H will eventually
1187 mean not --si, but --dereference-args (-D).
1189 2003-12-20 Jim Meyering <jim@meyering.net>
1191 * coreutils.texi (du invocation): Describe new option: -0, --null.
1193 2003-12-03 Paul Eggert <eggert@twinsun.com>
1195 * coreutils.texi (What information is listed, chroot invocation):
1196 Adjust example 'ls' output to match new behavior with narrower
1198 (The cut command): Remove example that cut the output of
1199 'ls -l'. The output was incorrect even with the old 'ls', and
1200 the whole idea of using 'cut' on 'ls -l' output is bogus anyway.
1202 2003-11-24 Paul Eggert <eggert@twinsun.com>
1204 Parse floating-point operands and options in the C locale.
1205 POSIX requires this for printf, and we might as well be
1206 consistent elsewhere (tail, sleep, seq).
1208 * coreutils.texi (tail invocation, printf invocation,
1209 sleep invocation, seq invocation): Document this.
1211 2003-11-24 Jim Meyering <jim@meyering.net>
1213 * coreutils.texi (Traversing symlinks, Treating / specially):
1215 (rm invocation, chown invocation, chmod invocation, chgrp invocation):
1216 Describe new options, --preserve-root and --no-preserve-root.
1218 2003-11-11 Jim Meyering <jim@meyering.net>
1220 * coreutils.texi (chown invocation) [chownchgrpoptions]: New macro
1221 describing -H, -L, -P options. Use it here.
1222 (chgrp invocation): And here.
1224 2003-11-09 Jim Meyering <jim@meyering.net>
1226 * coreutils.texi (dd invocation): Fix typo in example.
1228 2003-10-15 Jim Meyering <jim@meyering.net>
1230 * coreutils.texi (ln invocation): Note that --directory, -d, -F
1231 probably won't work even for superuser. Suggestion from Dan Jacobson.
1233 2003-09-29 Paul Eggert <eggert@twinsun.com>
1235 * coreutils.texi (csplit invocation):
1236 The regexp offset need not have a sign; POSIX requires support
1237 for signless offets.
1239 2003-10-03 Jim Meyering <jim@meyering.net>
1241 * coreutils.texi (du invocation): Describe -P, --no-dereference.
1243 2003-09-28 Jim Meyering <jim@meyering.net>
1245 * coreutils.texi (Translating): Correct typo in menu description.
1248 2003-09-02 Paul Eggert <eggert@twinsun.com>
1250 * coreutils.texi (sort invocation): -d now overrides -i.
1251 "whitespace" -> "blanks"; "whitespace" isn't correct.
1252 -t '\0' now specifies a NUL tab.
1254 2003-08-17 Jim Meyering <jim@meyering.net>
1256 * coreutils.texi (who invocation): Add an entry for -l, --login.
1257 Remove `-l' from the entry for --lookup.
1258 (who invocation): Begin adding missing option documentation.
1260 2003-08-07 Paul Eggert <eggert@twinsun.com>
1262 * coreutils.texi (split invocation):
1263 Add -d or --numeric-suffixes option to 'split'.
1265 2003-07-31 Paul Eggert <eggert@twinsun.com>
1267 * getdate.texi (General date syntax): Add --rfc-2822 option to GNU date.
1268 * coreutils.texi (Options for date): Fix a typo in format:
1269 it's now %d not %_d. Add URLs.
1271 2003-07-31 Paul Eggert <eggert@twinsun.com>
1273 * getdate.texi (Relative items in date strings): Warn about
1274 fuzz in relative units.
1276 2003-07-29 Jim Meyering <jim@meyering.net>
1278 * coreutils.texi (tail invocation): Restore two end-of-sentence words
1279 that were mistakenly removed on 2002-09-13. Reported by Paul Worrall.
1281 2003-07-28 Jim Meyering <jim@meyering.net>
1283 * coreutils.texi (dd invocation): Explain that a SIGUSR1 signal
1284 makes dd give a progress report to stderr.
1286 2003-07-24 Paul Eggert <eggert@twinsun.com>
1288 * coreutils.texi: Document changes of 2003-07-24.
1290 2003-07-24 Jim Meyering <jim@meyering.net>
1292 * coreutils.texi (su invocation): Use `@subsection', not invalid
1295 2003-07-17 Paul Eggert <eggert@twinsun.com>
1297 * coreutils.texi (expr invocation): Exit status is 2 if the
1298 expression is syntactically invalid, 3 if there is some other error.
1299 This change is for conformance to POSIX.
1301 2003-07-14 Paul Eggert <eggert@twinsun.com>
1303 * coreutils.texi (uname invocation): Explain the POSIX
1304 terminology behind uname -m and uname -s.
1306 2003-07-13 Jim Meyering <jim@meyering.net>
1308 * coreutils.texi (chown invocation): Warn that chown
1309 now clears set-user-ID and set-group-ID bits on some systems.
1311 (nohup invocation): Tell what happens when stdout is not a terminal.
1312 Based on a suggestion from Steven Mocking.
1314 2003-07-10 Jim Meyering <jim@meyering.net>
1316 * coreutils.texi (Standards conformance): Mention that uses like
1317 `tail -1' and `head -1', like `sort +1', are non conforming.
1318 (chown invocation): Say that using `.' as a separator may not work.
1320 2003-06-25 Jim Meyering <jim@meyering.net>
1322 * coreutils.texi (Time directives) [%s]: Add a cross reference
1323 to the related examples.
1324 (Examples of date): Add an @anchor here, along with a few more examples.
1325 Suggestion from Dan Jacobson.
1327 2003-06-12 Jim Meyering <jim@meyering.net>
1329 * coreutils.texi (wc invocation): Tweak wording: wc prints counts in
1330 the order `newline, word, byte'. Suggestion from Keith M. Briggs.
1331 Also change `lines' to `newlines'.
1333 2003-05-14 Jim Meyering <jim@meyering.net>
1335 * coreutils.texi (head invocation): Document --bytes=-N and --lines=-N.
1337 2003-05-13 Paul Eggert <eggert@twinsun.com>
1339 * coreutils.texi (uniq invocation, squeezing, The uniq command):
1340 Use "repeated" rather than "duplicate" to describe adjacent
1341 duplicates; this simplifies the description and makes it more
1342 consistent with POSIX.
1343 (uniq invocation): Make it clear that -d and -u suppress the
1344 output of lines, rather than cause some lines to be output.
1345 Mention what happens if a line lacks enough fields or characters.
1347 2003-05-13 Jim Meyering <jim@meyering.net>
1349 * coreutils.texi (true invocation): Mention that it is possible to
1350 make true --help or true --version (in non-POSIX mode) exit nonzero.
1351 Suggestion from Paul Eggert.
1353 2003-05-10 Jim Meyering <jim@meyering.net>
1355 * coreutils.texi (Exit status): Remove `uniq' from the list.
1356 It uses standard exit codes.
1357 (More details about version sort): Note that strverscmp, and hence
1358 `ls -v', does not use LC_COLLATE. Reported by From: Andrey Borzenkov.
1360 2003-04-21 Jim Meyering <jim@meyering.net>
1362 Fix printf POSIX compatibility bug reported by Ben Harris in
1363 <http://mail.gnu.org/archive/html/bug-coreutils/2003-04/msg00070.html>.
1364 * coreutils.texi (printf invocation): It's \NNN in the format,
1365 \0NNN in the %b operand.
1367 2003-04-10 Jim Meyering <jim@meyering.net>
1369 * Makefile.am (check-texinfo): Check for uses of non-zero.
1370 I prefer to spell it `nonzero'.
1372 * coreutils.texi (readlink invocation): Tweak description a little.
1374 2003-04-04 Jim Meyering <jim@meyering.net>
1376 * Makefile.am (constants.texi): Rename target (thus enabling it),
1377 now that fileutils, textutils, and sh-utils have been merged.
1378 (MAINTAINERCLEANFILES): Define.
1380 2003-04-02 Jim Meyering <jim@meyering.net>
1382 * coreutils.texi (false invocation): Note that false exits
1383 unsuccessfully even with --help and --version.
1385 * Makefile.am (check-texinfo): Don't fail if perl is missing.
1386 Reported by Nelson Beebe.
1388 2003-03-27 Jim Meyering <jim@meyering.net>
1390 * coreutils.texi (printf invocation): Fix formatting bugs.
1392 (sort invocation): Describe sort's --stable (-s) option.
1394 2003-03-13 Jim Meyering <jim@meyering.net>
1396 * coreutils.texi (shred invocation): Mention that --exact
1397 is now the default for non-regular files.
1399 2003-03-02 Jim Meyering <jim@meyering.net>
1401 * coreutils.texi (Exit status): New section.
1402 Suggestion from Michael Stone.
1404 2003-02-21 Jim Meyering <jim@meyering.net>
1406 * coreutils.texi (du invocation): Document --apparent-size.
1407 Adjust documentation of --bytes (-b).
1408 (stat invocation): Describe %B.
1410 2003-02-07 Richard Dawe <rich@phekda.freeserve.co.uk>
1412 * coreutils.texi: Use @command instead of @code for program names.
1414 * perm.texi (Mode Structure): Mention filesystem-specific
1415 permissions and that mounting a filesystem as read-only may
1416 override actual file permissions. Use @command instead
1417 of @code for program names.
1419 2003-02-06 Jim Meyering <jim@meyering.net>
1421 * coreutils.texi: Adjust alignment and mention `file, text, shell'
1422 on the `* Coreutils:...' dirently line. From Karl Berry.
1424 2003-02-05 Jim Meyering <jim@meyering.net>
1426 * Makefile.am (check-texinfo): Allow bare `POSIX' to be used on
1429 * coreutils.texi: Use new form of @direntry.
1430 Put unlink in its proper place. Adjust wording in some
1431 dir entry descriptions, mainly so they fit in 80 columns.
1432 Don't use mark-up like @acronym{POSIX} in direntries.
1433 Mostly from Karl Berry.
1435 2003-01-25 Jim Meyering <jim@meyering.net>
1437 * coreutils.texi (cut invocation): Describe new functionality of
1438 --output-delimiter=STR.
1440 2003-01-24 Jim Meyering <jim@meyering.net>
1442 * coreutils.texi (The cut command): Give an example of using cut -c
1443 with an output delimiter. From Jan Nieuwenhuizen.
1445 * coreutils.texi (The cut command): Extend the new example a little.
1446 (Formatting file timestamps): Fix typo: s/%M:S/%M:%S/.
1448 * coreutils.texi: Change each use of `Core-utils' to `Coreutils'.
1451 2003-01-19 Jim Meyering <jim@meyering.net>
1453 * coreutils.texi (Which files are listed): Document new option:
1454 --dereference-command-line-symlink-to-dir.
1456 2003-01-15 Paul Eggert <eggert@twinsun.com>
1458 Change ls -H back to the way it was yesterday, since this is
1459 compatible with FreeBSD and the POSIX spec is confusing
1460 and somewhat contradictory.
1462 * coreutils.texi (Which files are listed, General output
1463 formatting): Undo last change.
1465 2003-01-15 Jim Meyering <jim@meyering.net>
1467 * coreutils.texi (General output formatting): Reflect option name change:
1468 s/--dereference-command-line/--dereference-command-line-symlink-to-dir/.
1469 Say that this option changes how ls treats only symlinks to directories
1470 specified on the command line.
1472 2002-08-27 Dmitry V. Levin <ldv@altlinux.org>
1474 * coreutils.texi: Document readlink.
1476 2002-12-14 Jim Meyering <jim@meyering.net>
1478 * coreutils.texi (mknod invocation): Specify how major and minor mode
1479 numbers are interpreted. Report forwarded by Kristin E Thomas.
1481 2002-11-13 Jim Meyering <jim@meyering.net>
1483 * coreutils.texi (Examples of expr): Remove bogus `^'s.
1484 Reported by Thomas Goerlich.
1486 2002-11-09 Jim Meyering <jim@meyering.net>
1488 * coreutils.texi (What information is listed) [--dired]:
1489 Correct parts of --dired description. Reported by Andre Spiegel.
1490 Include a lot more description, with examples.
1492 2002-11-06 Jim Meyering <jim@meyering.net>
1494 * coreutils.texi (printf invocation): Fix typo in index:
1495 change \0x prefix to \x.
1496 Change \xhhh to \xhh.
1498 2002-10-07 Paul Eggert <eggert@twinsun.com>
1500 Add support for locale-specific size indications (e.g.,
1501 thousands-separators) and for explicit size suffixes on output.
1503 * coreutils.texi (Block size): Say that:
1504 This affects display format as well as block size.
1505 Fractional block counts are rounded up.
1506 ls file size blocksize defaults to 1.
1507 A block size spec preceded by ' generates thousands separators.
1508 A suffix without a preceding integer generates suffixes.
1509 (tail invocation): 32k -> 32 KiB.
1510 (What information is listed): ls -h is now equivalent to
1511 ls --block-size=human, and ls -H is now equivalent to
1512 ls --block-size=si. Displayed file size is now always affected by
1515 2002-09-13 Jim Meyering <jim@meyering.net>
1517 * coreutils.texi (tail invocation): In --sleep-interval=NUMBER,
1518 NUMBER may now be a floating point number.
1519 (stat invocation): Remove references to now-removed %S and %C.
1520 (Time directives) [%S]: Explain why the range is [0..60].
1522 2002-08-30 Jim Meyering <jim@meyering.net>
1524 * coreutils.texi [START-INFO-DIR-ENTRY]: Don't use sc{} on LHS.
1525 Fix typo: s/permission/permissions/. From Michail Litvak.
1527 2002-08-02 Paul Eggert <eggert@twinsun.com>
1529 * coreutils.texi (uniq invocation): uniq now obeys LC_COLLATE.
1531 2002-07-29 Paul Eggert <eggert@twinsun.com>
1533 * coreutils.texi (nohup invocation): Change behavior to conform to
1535 - Do not adjust scheduling priority.
1536 - Redirects stderr to stdout, if stderr is not a terminal.
1537 - Exit status is now 126 if command was found but not invoked,
1538 127 if nohup failed or if command was not found.
1540 2002-07-24 Jim Meyering <jim@meyering.net>
1542 * coreutils.texi (Time directives): Document %P, %R, %e, %F,
1545 2002-07-22 Martin Michlmayr <tbm@cyrius.com>
1547 * coreutils.texi (Formatting the file names): Document
1548 that -N/--literal are equivalent to --quoting-style=literal.
1549 Reported by Oskar Liljeblad as Debian bug#103612.
1551 2002-07-10 Jim Meyering <jim@meyering.net>
1553 * coreutils.texi (du invocation): s/PAT/PATTERN/.
1554 From Martin Michlmayr.
1556 2002-07-08 Jim Meyering <jim@meyering.net>
1558 * coreutils.texi (cp invocation): Remove unnecessary "$@" in example;
1559 Texinfo would render the @" as an umlaut over the following character.
1561 * Makefile.am (check-texinfo): Check for the above.
1563 2002-07-06 Jim Meyering <jim@meyering.net>
1565 * coreutils.texi (stat invocation): Remove description of --secure.
1567 2002-07-03 Jim Meyering <jim@meyering.net>
1569 * coreutils.texi (stat invocation): Rename --link/-l
1570 to --dereference/-L. Rewrite description of --dereference.
1572 2002-06-26 Paul Eggert <eggert@twinsun.com>
1574 * coreutils.texi (Putting the tools together): Don't mention egrep,
1575 since it's not part of POSIX 1003.1-2001.
1577 2002-06-21 Jim Meyering <jim@meyering.net>
1579 * coreutils.texi (stat invocation): New section. From Michael Meskes.
1581 2002-05-19 Paul Eggert <eggert@twinsun.com>
1583 * coreutils.texi (ls invocation): Document new option: --author.
1585 2002-06-03 Jim Meyering <jim@meyering.net>
1587 * coreutils.texi (rm invocation): Add the warning (also in the --help
1588 output) that the contents of a removed file are often recoverable.
1590 2002-05-27 Jim Meyering <jim@meyering.net>
1592 * Makefile.am (check-texinfo): Adapt to reflect that now we use
1595 2002-05-26 Jim Meyering <jim@meyering.net>
1597 * coreutils.texi: Use @acronym in place of most uses of @sc.
1598 * getdate.texi (Date input formats): Likewise.
1600 2002-04-28 Jim Meyering <jim@meyering.net>
1602 * coreutils.texi: Change `@code{PROG}' to `@command{PROG}'.
1604 2002-04-28 Paul Eggert <eggert@twinsun.com>
1606 * coreutils.texi (kill invocation): Document the above.
1607 Document POSIX signals better.
1609 2002-04-15 Jim Meyering <jim@meyering.net>
1611 * coreutils.texi: Document kill.
1612 Written by Marcus Brinkmann.
1614 2002-04-13 Jim Meyering <jim@meyering.net>
1616 * coreutils.texi: Document link and unlink.
1618 2002-04-08 Jim Meyering <jim@meyering.net>
1620 * coreutils.texi: Use new directives, @copying and @insertcopying,
1621 thus now requiring texinfo-4.2 to create the .info file.
1623 2002-02-26 Paul Eggert <eggert@twinsun.com>
1625 * coreutils.texi (File characteristic tests): Document the
1626 behavior of test -nt and -ot when one of the files does not exist,
1627 using the same behavior that is documented in ksh93.
1629 2002-03-05 Paul Eggert <eggert@twinsun.com>
1631 * coreutils.texi (cut invocation): Say that selected input is
1632 written in the same order that it is read, and is written
1635 2002-03-03 Paul Eggert <eggert@twinsun.com>
1637 Make cp -r equivalent to cp -R. Add a new cp option --copy-contents
1638 for people who want to emulate the traditional (and rarely desirable)
1641 * coreutils.texi (cp invocation): Document this.
1642 Fix some related minor bugs: --no-dereference is no longer
1643 equivalent to -d, and --archive (-a) can override the other
1644 symlink options. Warn that cp -R is not portable on symbolic
1645 links unless you also specify -P.
1647 2002-03-02 Jim Meyering <jim@meyering.net>
1649 * coreutils.texi (cp invocation): Document that cp -r
1650 preserves symlinks. Emphasize non-portability of cp -r.
1652 2002-02-27 Paul Eggert <eggert@twinsun.com>
1654 * coreutils.texi (Time directives): Add %N for nanoseconds.
1655 This documents the recent change to 'ls'.
1657 2002-02-28 Jim Meyering <jim@meyering.net>
1659 * coreutils.texi (pr invocation): Reword to avoid using `:'
1660 in an @opindex entry -- info doesn't permit it.
1662 2002-02-27 Paul Eggert <eggert@twinsun.com>
1664 * coreutils.texi (Formatting file timestamps): Document new
1665 time-formatting method: --time-style=+FORMAT.
1667 2002-02-18 Paul Eggert <eggert@twinsun.com>
1669 * coreutils.texi (seq invocation): In the example, use "tail
1670 -n 3", not "tail -3", to conform to POSIX 1003.1-2001.
1672 2002-02-17 Jim Meyering <jim@meyering.net>
1674 * coreutils.texi (tsort background): New section.
1675 From Ian Lance Taylor.
1676 (tsort invocation): Add a more realistic example.
1678 2002-02-15 Paul Eggert <eggert@twinsun.com>
1680 * coreutils.texi: Document _POSIX2_VERSION.
1681 (Standards Conformance): New section.
1683 2002-01-24 Jim Meyering <jim@meyering.net>
1685 * coreutils.texi (START-INFO-DIR-ENTRY): Remove a few entries
1686 and clean up a few others based on suggestions from Bob Proulx.
1688 2002-02-14 Paul Eggert <eggert@twinsun.com>
1690 Add support for POSIX 1003.1-2001, which requires removal for
1691 support of obsolete "+" option syntax in sort, tail, and uniq.
1692 * coreutils.texi: Document this. (Also, document a similar
1693 change to "touch", for fileutils).
1695 2002-01-12 Jim Meyering <jim@meyering.net>
1697 * coreutils.texi (shred invocation): List some journaled filesystems.
1699 2001-11-10 Jim Meyering <jim@meyering.net>
1701 * coreutils.texi (Date directives): Document %u.
1703 2001-11-07 Paul Eggert <eggert@twinsun.com>
1705 * coreutils.texi (paste invocation): Give examples.
1706 Thanks to Dan Jacobson for suggesting the examples.
1708 2001-11-05 Jim Meyering <jim@meyering.net>
1710 * coreutils.texi (sort invocation): Recommend setting LC_ALL=C,
1711 not LC_COLLATE=C. Explain how the latter can cause problems.
1712 Based on a message from Paul Eggert.
1713 (ls invocation): Recommend setting LC_ALL=C, not LC_COLLATE=C.
1715 2001-10-21 Jim Meyering <jim@meyering.net>
1717 * coreutils.texi (cp invocation): Describe --reply=...
1719 2001-10-17 Jim Meyering <jim@meyering.net>
1721 * coreutils.texi (cp invocation): `cp --no-dereference' is
1722 no longer equivalent to `cp -d'.
1723 `cp -d' is equivalent to `--no-dereference --preserve=links'.
1724 cp's -P option means --no-dereference, not --parents.
1725 Describe new optional argument to --preserve.
1726 Describe new option: --no-preserve=ATTRIBUTE_LIST.
1728 2001-09-23 Jim Meyering <jim@meyering.net>
1730 * Makefile.am (check-texinfo): Redirect stderr of `grep -w' to
1731 /dev/null, so people with old versions of grep don't see the failure.
1733 2001-09-16 Jim Meyering <jim@meyering.net>
1735 * coreutils.texi (mv invocation): Describe new option:
1736 --reply={yes,no,query}. Fix a few typos.
1738 2001-09-15 Paul Eggert <eggert@twinsun.com>
1740 * coreutils.texi (uniq invocation): The input need not
1741 be sorted. Try to clarify -d versus -D versus -u.
1743 2001-09-12 Jim Meyering <jim@meyering.net>
1745 * coreutils.texi (tail invocation): Document new option: -F.
1748 2001-09-04 Paul Eggert <eggert@twinsun.com>
1750 * coreutils.texi (join invocation): Describe the GNU
1751 extension to join, which does not require sorted input when
1752 the input contains no unpairable lines.
1754 2001-09-03 Paul Eggert <eggert@twinsun.com>
1757 New 'uname' options -i or --hardware-platform,
1758 and -o or --operating-system.
1759 'uname -a' now outputs -i and -o information at the end.
1760 New uname option --kernel-version is an alias for -v.
1761 Uname option --release has been renamed to --kernel-release,
1762 and --sysname has been renamed to --kernel-name;
1763 the old options will work for a while, but are no longer documented.
1765 2001-08-24 Herbert Xu <herbert@gondor.apana.org.au>
1767 * coreutils.texi (cut invocation): Document how cut treats lines
1770 2001-06-19 Paul Eggert <eggert@twinsun.com>
1772 * coreutils.texi: expr now uses LC_COLLATE for string comparison,
1775 2001-08-25 Jim Meyering <jim@meyering.net>
1777 * coreutils.texi: Use @option, rather than @samp everywhere.
1779 2001-06-21 Paul Eggert <eggert@twinsun.com>
1781 * coreutils.texi: 'expr' now requires '+' rather than 'quote'
1784 2001-07-14 Jim Meyering <jim@meyering.net>
1786 * coreutils.texi (cp invocation): Reflect 2001-07-08 change to
1789 2001-06-16 Jim Meyering <jim@meyering.net>
1791 * Makefile.am (info_TEXINFOS): Reflect renaming: s/omni-/core/.
1792 * coreutils.texi: Likewise.
1794 * coreutils.texi: New, renamed from omni-utils.texi.
1795 * omni-utils.texi: Removed, renamed to coreutils.texi.
1797 * omni-utils.texi (ls invocation): Mention the effect of locale.
1798 Reported by Keith Thompson.
1800 2001-05-24 Jim Meyering <jim@meyering.net>
1802 * texinfo.tex: Update from master source.
1804 * omni-utils.texi (ls invocation): Document more clearly what ls
1805 does when given no arguments.
1807 2001-05-21 Jim Meyering <jim@meyering.net>
1809 * textutils.texi: Remove file.
1811 * Makefile.am ($(DVIS), $(INFO_DEPS)): Depend on $(EXTRA_DIST).
1812 (DISABLED_constants.texi): New rule -- disabled for now.
1814 This directory is now shared by fileutils, textutils, and sh-utils.