1 2006-08-17 Paul Eggert <eggert@cs.ucla.edu>
3 * ChangeLog: Add copyright notice.
4 * Makefile.am: Likewise.
5 * getdate.texi: Likewise.
7 * getdate.texi: Update to version 1.2 of the GNU FDL.
8 * coreutils.texi: Likewise.
9 (Copying This Manual): Renamed from GNU Free Documentation License.
10 Now an appendix. Include fdl.texi rather than doclicense.texi.
11 * fdl.tex: Renamed from doclicense.texi. Latest version from FSF.
12 * perm.texi: Add copyright notice.
14 2006-08-15 Paul Eggert <eggert@cs.ucla.edu>
16 * coreutils.texi (df invocation): df exits nonzero if it outputs
19 2006-08-09 Paul Eggert <eggert@cs.ucla.edu>
21 * coreutils.texi (dd invocation): Warn about oflag=append without
22 conv=notrunc. See Debian bug 373736.
24 2006-08-08 Paul Eggert <eggert@cs.ucla.edu>
26 * coreutils.texi (shuf invocation, Random sources): New sections.
27 (Operating on sorted files): Add shuf.
28 (sort invocation, shred invocation): New option --random-source.
29 (sort invocation): Fix typo: -R -> -r.
31 2006-07-28 Paul Eggert <eggert@cs.ucla.edu>
33 * coreutils.texi (install invocation, mkdir invocation):
34 Add cross-references to Directory Setuid and Setgid.
35 (install-invocation): The default mode is no longer equivalent to 755.
36 * perm.texi (Changing Special Mode Bits): Clarify u+s versus
37 a+s versus +s, and likewise for g+s.
38 (Numeric Modes): Bring back example of 0055 == 55. 4755 no
39 longer clears setgid bit on directories.
40 (Directory Setuid and Setgid): Numeric modes now affect setuid
41 and setgid on directories only if they set these bits. This
42 is so that leading 0 has no effect on numeric modes.
44 2006-07-26 Jim Meyering <jim@meyering.net>
46 * coreutils.texi (What information is listed): Mention that missing
47 pieces of information are marked with "?". From Paul Eggert.
49 2006-07-25 Paul Eggert <eggert@cs.ucla.edu>
51 * perm.texi (Directory Setuid and Setgid): Explain that this is a
52 GNU extension, and that other systems behave differently here.
54 2006-07-22 Paul Eggert <eggert@cs.ucla.edu>
56 * coreutils.texi (What information is listed): Clarify that the
57 restricted deletion flag is another name for the sticky bit.
58 * perm.texi (Mode Structure): The restricted deletion flag
59 restricts only unprivileged users.
60 (Mode Structure, Symbolic Modes, Numeric Modes): Be more careful
61 about distinguishing file mode bits from permissions bits,
62 and about execute versus search permission. The FreeBSD command
63 is chflags, not chrflags.
65 2006-07-16 Paul Eggert <eggert@cs.ucla.edu>
67 * coreutils.texi: Change GNU to @acronym{GNU} in a few places.
68 Use "set-user-ID" and "set-group-ID" a bit more consistently.
69 Use "appropriate privileges" rather than "super-user" a bit
71 (install invocation): Parent directories are now 755 without uid
72 or gid changing. The default mode is now 0755, not 755.
73 (mkdir invocation): Rewrite the top-level usage description, since
74 I couldn't easily follow the old one. It's now 3 lines not 8.
75 For -m, describe file permission bits versus other bits, and note
76 that mkdir is atomic if you don't mention special bits.
77 (chmod invocation): Mention what chmod does to setgid and setuid bits.
78 * perm.texi (Mode Structure): Modernize the explanation of the
79 setuid and setgid bits on directories.
80 (Changing Special Mode Bits): Mention that a implies both u and g
81 for s. Cross reference to new node.
82 (Numeric Modes): Don't claim that 0055 is the same as 55; this isn't
83 true any more. Mention new node.
84 4755 is now like u=rwxs,go=rx,g-s, not like u=rwxs,go=rx.
85 (Directory Setuid and Setgid): New node.
87 2006-07-08 Jim Meyering <jim@meyering.net>
89 * coreutils.texi (Squeezing): Separate doubled "the", so typo-checkers
92 * Makefile.am (check-texinfo): Enforce the zeros vs. zeroes consistency.
94 2006-07-08 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
96 * coreutils.texi: Fix some typos. Use `zeros' consistently (both
97 `zeros' and `zeroes' are correct).
99 2006-07-01 Paul Eggert <eggert@cs.ucla.edu>
101 * coreutils.texi (tail invocation): With no operand, 'tail -f' now
102 silently ignores the '-f' only if standard input is a FIFO or pipe
103 and POSIXLY_CORRECT is set.
105 2006-06-30 Paul Eggert <eggert@cs.ucla.edu>
107 * coreutils.texi (seq invocation): seq now uses long double
108 internally rather than double. It now defaults to a minimal fixed
109 point format if possible. It lets you use %a, %A, %E, %F, %G.
110 Don't assume printf doesn't work for numbers that fit in 64 but
111 not 32 bits; typically they work these days. Improve discussion
112 of large integers and update the rounding-error numbers.
114 2006-06-28 Paul Eggert <eggert@cs.ucla.edu>
116 * coreutils.texi (sort invocation): 'sort +1 -2' is now supported
117 even when conforming to POSIX 1003.1-2001, since this is a pure
120 2006-06-27 Jim Meyering <jim@meyering.net>
122 * coreutils.texi (wc invocation): Remove ./ prefix from example.
125 2006-06-26 Jim Meyering <jim@meyering.net>
127 * coreutils.texi (wc invocation): Spell out `--files0-from' in
128 the example. Suggestion from Bob Proulx.
130 * coreutils.texi (wc invocation): Document new --files0-from option.
132 2006-06-20 Eric Blake <ebb9@byu.net>
134 * coreutils.texi (sleep invocation): Document that accepting
135 multiple arguments and suffixes are extensions.
136 Reported by Dan Jacobson.
138 2006-06-12 Paul Eggert <eggert@cs.ucla.edu>
140 * Makefile.am (check-texinfo): Use $(_W) and $(W_) instead of
141 assuming grep -w (which is not portable).
143 2006-05-27 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
145 * Makefile.am: Use `AM_MAKEINFOFLAGS' rather than
146 overwriting `MAKEINFO', so that `missing' can do its job.
148 * Makefile.am (check-texinfo): Use `$(EGREP)' instead of `grep -E'.
149 (check-texinfo): Use literal `{' only in brackets, i.e., [{] or [}],
150 to avoid triggering an error from Solaris 2.6's grep.
152 2006-05-25 Paul Eggert <eggert@cs.ucla.edu>
154 * coreutils.texi (sort invocation): Remove mention of --seed, since
157 2006-05-04 Eric Blake <ebb9@byu.net>
159 * coreutils.texi (Examples of date): Give example of @seconds.
161 2006-05-03 Paul Eggert <eggert@cs.ucla.edu>
163 * coreutils.texi (head invocation, tail invocation, sort invocation):
164 Give advice about porting to hosts that support only obsolete syntax.
165 Problem reported by Zack Weinberg.
167 2006-04-23 Francesco Montorsi <fr_m@hotmail.com>
169 * coreutils.texi (Which files are listed): Describe new option:
170 --group-directories-first.
172 2006-04-17 Paul Eggert <eggert@cs.ucla.edu>
174 * coreutils.texi (What information is listed): Add P for Solaris
175 10 ports. Add commented-out entries for other types that POSIX
176 says are possible, or that I observed in FreeBSD documentation.
178 2006-04-18 Jim Meyering <jim@meyering.net>
180 * coreutils.texi (Input processing in ptx): Remove mention of the
181 default --ignore file, /usr/local/lib/eign. That file has never
182 been used. Reported by Eric Blake.
184 2006-04-12 Paul Eggert <eggert@cs.ucla.edu>
186 * coreutils.texi (expr invocation): expr exit status is 3 only for
187 internal errors now; 2 is also for invalid values in expressions.
189 (What information is listed): Document 'ls' type letters.
190 Problem reported by Lincoln Martin.
192 2006-04-09 Ori Avtalion <oavtal@bezeqint.net>
194 * coreutils.texi (Top): Add 'hostid' to System context menu line.
197 2006-03-22 Eric Blake <ebb9@byu.net>
199 * coreutils.texi (General options in ptx): Undocument --copyright.
201 2006-03-27 Eric Blake <ebb9@byu.net>
203 * coreutils.texi (dirname invocation): Macro in previous patch
206 2006-03-11 Eric Blake <ebb9@byu.net>
208 * coreutils.texi (basename invocation, dirname invocation):
209 Improve documentation to match recent // patches.
211 2006-03-23 Paul Eggert <eggert@cs.ucla.edu>
213 * coreutils.texi (nohup invocation): nohup now redirects stderr to
214 nohup.out if stdout is closed and stderr is a tty.
216 2006-03-05 Paul Eggert <eggert@cs.ucla.edu>
218 * coreutils.texi (dd invocation): New flags directory, nolinks.
219 Alphabetize nofollow.
221 2006-02-17 Simon Josefsson <jas@extundo.com>
223 * coreutils.texi: Add base64 section.
225 2006-02-20 Eric Blake <ebb9@byu.net>
227 * coreutils.texi (rm invocation): Fix typo in last patch.
228 (paste invocation): Fix whitespace.
230 2006-02-18 Eric Blake <ebb9@byu.net>
232 * coreutils.texi (rm invocation): Document new -I option, and new
233 --interactive behavior.
235 2006-02-12 Jim Meyering <jim@meyering.net>
237 * coreutils.texi (Character sets): Don't say that an unknown
238 backslash-escape causes an error message -- it doesn't.
239 Mention that `\' also removes any special significance, so
240 is useful for [, ], *, -. Prompted by Richard Neill in
241 http://savannah.gnu.org/bugs/index.php?func=detailitem&item_id=14937
243 2006-02-01 Paul Eggert <eggert@cs.ucla.edu>
245 * coreutils.texi (od invocation): Warn that -t a ignores the high
248 2006-01-30 Paul Eggert <eggert@cs.ucla.edu>
250 * coreutils.texi (tail invocation): In the obsolete usage, the
251 count is optional, so put square brackets around it.
253 2006-01-02 Paul Eggert <eggert@cs.ucla.edu>
255 * getdate.texi (General date syntax): Invalid dates are rejected.
256 (Time of day items): Mention the possibility of leap seconds.
257 Problem reported by Dr. David Alan Gilbert.
259 * coreutils.texi: Use @acronym around "ISO" uniformly.
260 (Date conversion specifiers): Explain %g, %G, and %V a bit better.
262 2006-01-02 Jim Meyering <jim@meyering.net>
264 * coreutils.texi (tail invocation): Say that --retry
265 is useful `mainly' (not `only') when following by name.
267 2006-01-01 Paul Eggert <eggert@cs.ucla.edu>
269 * coreutils.texi, perm.texi: Clarify file mode bits versus
270 file permission bits.
271 * coreutils.texi (mkfifo invocation, mknod invocation): -m
272 affects only file permission bits.
274 2005-12-29 Paul Eggert <eggert@cs.ucla.edu>
276 * coreutils.texi (sort invocation): Clarify that a blank is a space
279 2005-12-15 Jim Meyering <jim@meyering.net>
281 * coreutils.texi (stat invocation) [--printf]: Describe new option.
282 [--format]: Add example. Distinguish from --printf.
283 Sort option descriptions.
285 2005-12-05 Andreas Gruenbacher <agruen@suse.de>
287 * coreutils.texi (ls): Clarify the Alternate Access Method description.
288 (cp): Clarify that --preserve=mode also preserves acls.
290 2005-12-12 Paul Eggert <eggert@cs.ucla.edu>
292 * coreutils.texi (sort invocation): Clarify explanation of
293 --random-sort, and use a simpler example.
295 2005-12-10 Frederik Eaton <frederik@ofb.net>
297 * coreutils.texi (sort invocation): Add --random-sort (-R) and --seed.
299 2005-12-07 Paul Eggert <eggert@cs.ucla.edu>
301 * coreutils.texi (dd invocation): New noatime flag.
303 2005-11-25 Paul Eggert <eggert@cs.ucla.edu>
305 * coreutils.texi (df invocation): Document treatment of dummy file
308 2005-11-16 Paul Eggert <eggert@cs.ucla.edu>
310 * coreutils.texi (ln invocation): ln -v now outputs lines only for
312 (tail invocation): Say that the obsolete form uses exactly one
313 option and at most one file.
315 2005-11-13 Jim Meyering <jim@meyering.net>
317 * perm.texi (Mode Structure): Capitalize two sentences in an
318 enumerated list and fix a typo. From Aaron Hawley.
320 2005-11-08 Paul Eggert <eggert@cs.ucla.edu>
322 * coreutils.texi (Formatting file timestamps): ls now defaults to
323 --time-style='locale', which in turn acts like
324 --time-style='posix-long-iso' if the locale settings are messed up.
326 2005-11-02 Paul Eggert <eggert@cs.ucla.edu>
328 * coreutils.texi (rm invocation): Don't mention --directory (-d).
330 2005-11-01 Paul Eggert <eggert@cs.ucla.edu>
332 * coreutils.texi (tail invocation): Describe obsolete usages
333 like "tail -2" more precisely.
334 (touch invocation): The old usage works only for 1969-1999 now.
336 2005-08-28 David Madore <david.madore@ens.fr>
338 * coreutils.texi: Document SHA-1 and SHA-2 utilities.
340 2005-10-15 Paul Eggert <eggert@cs.ucla.edu>
342 * doc/coreutils.texi (Top, General output formatting, dir invocation):
343 (vdir invocation): Don't document the old v and d commands.
345 2005-10-15 Jim Meyering <jim@meyering.net>
347 * coreutils.texi (du invocation): Document du's -m option,
348 now that we've decided to keep it.
349 (who invocation): Remove documentation for deprecated --idle (-i).
351 2005-10-13 Jim Meyering <jim@meyering.net>
353 * coreutils.texi: Avoid a few overfull/underfull hboxes.
355 2005-09-24 Paul Eggert <eggert@cs.ucla.edu>
357 * coreutils.texi (touch invocation):
358 "touch -" now touches standard output.
360 2005-09-17 Paul Eggert <eggert@cs.ucla.edu>
362 * coreutils.texi (who invocation): Remove a stray '+'.
364 2005-09-15 Paul Eggert <eggert@cs.ucla.edu>
366 * coreutils.texi (uname invocation): uname -a no longer generates
367 the -p and -i outputs if they are unknown.
369 2005-09-13 Paul Eggert <eggert@cs.ucla.edu>
371 * coreutils.texi (Time conversion specifiers, Options for date):
372 Document date --rfc-3339 and new specifiers %:z, %::z, %:::z. Use
373 "date and time" consistently; the old version sometimes said "time
374 and date". Fix a minor bug in the documentation for --rfc-2822:
375 it claimed day-of-month < 10 had leading space, not leading zero.
376 Use a consistent format for terms like "RFC".
377 (uname invocation): Mention that Linux outputs "unknown" for
380 2005-09-08 Paul Eggert <eggert@cs.ucla.edu>
382 * coreutils.texi (nice invocation): Document "niceness" versus
383 "nice value" versus "scheduling priority".
385 2005-09-07 Paul Eggert <eggert@cs.ucla.edu>
387 * coreutils.texi (nice invocation): Use "niceness", not "nice value"
388 to talk about nice values offset by -20. Don't use the word
389 "priority" when niceness is intended.
391 2005-08-15 Jim Meyering <jim@meyering.net>
393 * coreutils.texi (join invocation): Itemize the defaults.
396 2005-08-12 Jim Meyering <jim@meyering.net>
398 * coreutils.texi (cp invocation, mv invocation): Remove square
399 brackets in --reply=[HOW]. Reported by Oscar Liljeblad.
401 2005-07-19 Paul Eggert <eggert@cs.ucla.edu>
403 * coreutils.texi (md5sum invocation): --check now allows multiple
406 2005-07-18 Paul Eggert <eggert@cs.ucla.edu>
408 * coreutils.texi (false invocation):
409 Mention that false is often built-in, and that it exits
410 with status >1 on some hosts.
411 (true invocation): Remove now-incorrect "non-POSIX mode" reference.
413 2005-07-15 Paul Eggert <eggert@cs.ucla.edu>
415 * coreutils.texi (nohup invocation): POSIXLY_CORRECT no longer
416 affects nohup's behavior. Input is redirected from /dev/null.
418 2005-07-11 Paul Eggert <eggert@cs.ucla.edu>
420 * coreutils.texi (cat invocation): Remove -B or --binary option
421 (available on MS-DOS-like platforms only). Explain when text and
422 binary mode are used now.
423 (md5sum invocation): -b actually does have an effect on Unix: it
424 causes "*" to be output. Explain when text and binary mode are
427 2005-07-03 Jim Meyering <jim@meyering.net>
429 * coreutils.texi (cp invocation): Mark --reply as deprecated.
430 (mv invocation): Likewise.
432 2005-06-24 Jim Meyering <jim@meyering.net>
434 * coreutils.texi (cp invocation): Clarify how --reply=no works.
436 2005-06-14 William Brendling <wbrendling@gmail.com>
438 * coreutils.texi (du invocation): New options --last-time and
441 2005-06-19 Jim Meyering <jim@meyering.net>
443 * coreutils.texi (ln invocation): Change a few `paths' to `file names'.
444 * Makefile.am (check-texinfo): Also catch uses of path, pathname.
446 2005-06-17 Jim Meyering <jim@meyering.net>
448 * coreutils.texi (shred invocation): Clarify that shred
449 works on ext3 as long as it's not in data=journal mode.
450 Patch from Mark Melahn.
452 2005-06-16 Jim Meyering <jim@meyering.net>
454 * coreutils.texi (Backup options): Undocument --version-control=S (-V).
456 2005-06-07 Jim Meyering <jim@meyering.net>
458 * coreutils.texi (ln invocation): Examples, from Bob Proulx.
460 2005-06-01 Paul Eggert <eggert@cs.ucla.edu>
462 Use "file name" when talking about file names, instead of "filename"
463 or "path", as per the GNU coding standards.
464 * coreutils.texi (readlink invocation): "path component" ->
465 "component", since we don't use the POSIX "path" nomenclature.
467 2005-05-11 Paul Eggert <eggert@cs.ucla.edu>
469 * getdate.texi (General date syntax): Don't say that date
470 date --iso-8601=ns generates acceptable dates; it doesn't yet.
471 Problem reported by Nic Ferrier.
473 2005-05-06 Paul Eggert <eggert@cs.ucla.edu>
475 * coreutils.texi (dd invocation): New flags "binary" and "text".
477 2005-05-04 Paul Eggert <eggert@cs.ucla.edu>
479 * coreutils.texi (chmod invocation): chmod -w complains if its
480 behavior differs from what chmod a-w would do.
482 2005-05-02 Paul Eggert <eggert@cs.ucla.edu>
484 * coreutils.texi (ls invocation): ls --indicator-style=directory
485 renamed to ls --indicator-style=slash, to avoid confusion with ls
488 2005-04-28 Paul Eggert <eggert@cs.ucla.edu>
490 * perm.texi (Mode Structure, Changing Special Permissions):
491 (Conditional Executability, Numeric Modes):
492 These days the sticky bit is more often uses as the restricted
493 deletion flag, so modernize the discussion about this.
494 (Mode Structure): Linux/GNU -> GNU/Linux.
495 (Symbolic Modes): Don't imply that "+ur" or "u" is valid.
496 (Setting Permissions): Don't imply that "+t" is invalid.
497 Use "rwx" rather than the less-common "rxw" in an example.
498 (Copying Permissions): Say that ugo is a replacement for
499 a string of the other letters. Add spaces around examples.
500 Use "set-user-ID" rather than "set user ID" to avoid ambiguity.
501 Use "+t" rather than "o+t", since POSIX doesn't specify the latter.
502 Mention which combinations are portable and which are GNU.
503 (Numeric Modes): Don't imply they aren't portable; they are
506 2005-04-26 Paul Eggert <eggert@cs.ucla.edu>
508 * coreutils.texi (Standards conformance): Do not mention head -10,
509 since it now works the same regardless of POSIX version.
510 (od invocation): -w N -> -w[N].
511 (pr invocation): -S STRING -> -SSTRING.
512 (fold invocation): -WIDTH works even when conforming to POSIX
514 (head invocation, tail invocation): Likewise for -NUM.
515 (split invocation): Likewise for -LINES.
516 (uniq invocation): Likewise for -N.
517 (expand invocation, unexpand invocation): Likewise for -TAB.
518 (nice invocation): Likewise for -ADJUSTMENT.
519 (sort invocation): Clarify explanation of +N option.
520 (uniq invocation): Likewise.
521 (join invocation): Remove special case for --help, --version.
522 (touch invocation): Clarify explanation of date options.
523 (Options for date): -I timespec -> -I[timespec].
525 2005-04-23 Paul Eggert <eggert@cs.ucla.edu>
527 * coreutils.texi (install invocation): Use a= instead of 0 for
528 the point of departure for -m, and explain what it meeams.
529 (mkdir invocation, mkfifo invocation, mknod invocation):
530 The umask does not affect the point of departure.
531 Problem reported by Mike Stone.
533 2005-04-11 Paul Eggert <eggert@cs.ucla.edu>
535 * coreutils.texi: For consistency, standardize on "user ID" rather
536 than "uid" or "UID" or "user id". Similarly for "group ID".
538 2005-04-09 Jim Meyering <jim@meyering.net>
540 * coreutils.texi (rm invocation): Say that --recursive removes
541 listed directories too, not just their contents.
543 2005-04-08 Paul Eggert <eggert@cs.ucla.edu>
545 * coreutils.texi (dd invocation): Document the distinction between
546 INFO and USR1 for dd, and the effect of POSIXLY_CORRECT here.
548 2005-04-05 Paul Eggert <eggert@cs.ucla.edu>
550 * coreutils.texi (cat invocation, chown invocation)
551 (chgrp invocation, basename invocation, dirname invocation):
552 Add examples, which are copies of the examples newly added
553 to the usage messages.
554 (ln invocation): Use same format as other examples above,
557 2005-03-26 Paul Eggert <eggert@cs.ucla.edu>
559 * coreutils.texi: Clarify NUL vs null byte vs null character.
561 2005-03-18 Paul Eggert <eggert@cs.ucla.edu>
563 * coreutils.texi (nohup invocation): Clarify nohup.out creation.
565 2005-03-11 Paul Eggert <eggert@cs.ucla.edu>
567 * coreutils.texi (Formatting file timestamps): Very long timestamps
568 may be treated as errors.
570 2005-03-08 Paul Eggert <eggert@cs.ucla.edu>
572 * coreutils.texi (date invocation): Use an example that makes it
573 clear tha the default date use space-padded day of month.
574 Replace "directive" with "conversion specifier" to be consistent
575 with POSIX. All uses changed.
576 Fix menu RHS to match actual directive lists.
577 (Time conversion specifiers): Renamed from Time directives.
578 Use @samp consistently, sometimes instead of @code.
579 Consistently ention which specifiers are GNU extensions.
580 Give more examples (in some cases, instead of ranges).
581 Say why %F is preferred for dates.
582 (Date conversion specifiers): Renamed from Date directives.
583 Likewise for other changes.
584 (Padding and other flags): Correct the description.
585 Document #. Give an example for %9B.
587 2005-02-23 Paul Eggert <eggert@cs.ucla.edu>
589 * coreutils.texi: Adjust to match current strftime.c.
590 (Time directives): Say that %k, %l, and %P are GNU extensions.
591 For %p and %P, mention handling of noon and midnight.
592 For %s, use ISO 8601, and mention handling of leap seconds.
593 For %S, clarify mention of leap seconds.
594 For %T, say that it's the same as %H:%M:%S.
595 For %X, don't say that it must be the same as %H:%M:%S.
596 For %z and %Z, clarify which time zones are used. These options
597 are now affected by --date, so don't claim that they're not.
598 (Date directives): %C is now all but the last two chars of %Y.
599 For %D, say that it's equivalent to %m/%d/%y.
600 For %e, use blank in example.
601 For %h, use @code for %b.
602 For %Y, mention what happens with outlandish years.
603 (Padding and other flags): Renamed from Padding.
604 Mention that the flags are GNU extensions.
605 Mention the 0 and ^ flags.
606 Mention field widths an modifiers.
607 (Examples of date): - is a flag, not a modifier.
609 2005-01-07 Jim Meyering <jim@meyering.net>
611 * coreutils.texi (sort invocation): Specify that a string
612 of zero digits is interpreted as 0. Reported by Ulrich Hermisson.
614 2005-01-04 Jim Meyering <jim@meyering.net>
616 * coreutils.texi (shred invocation): Clarify that shred works fine
617 with journaled file systems that are configured not to journal
618 file system data. Also mention BFS and NTFS.
620 2004-12-15 Paul Eggert <eggert@cs.ucla.edu>
622 * coreutils.texi (ls invocation): Change minor problem to be
623 "subdirectory not found", since top-level trouble is now serious.
624 (dircolors invocation): Quote argument to eval. Problem reported
625 by Stephane Chazelas.
627 2004-12-11 Paul Eggert <eggert@cs.ucla.edu>
629 * coreutils.texi (join invocation): Mention that blank separators
630 in the -o option need to be quoted. Problem reported by Phil Clayton.
632 2004-12-10 Paul Eggert <eggert@cs.ucla.edu>
634 * coreutils.texi (id invocation): -G also prints main group.
635 Problem reported by Tim Waugh.
637 2004-12-09 Paul Eggert <eggert@cs.ucla.edu>
639 * coreutils.texi (ls invocation): Document new "ls" exit status.
641 2004-12-08 Paul Eggert <eggert@cs.ucla.edu>
643 * getdate.texi (Time of day items, Time zone items):
644 Describe new formats +00:00, UTC+00:00.
646 2004-12-04 Jim Meyering <jim@meyering.net>
648 * coreutils.texi (cut invocation): Say when --complement is useful.
650 2004-10-01 Paolo Bonzini <bonzini@gnu.org>
652 * coreutils.texi (cut invocation): Document --complement and
653 adjust the documentation of -b, -c, -f.
655 2004-11-27 Paul Eggert <eggert@cs.ucla.edu>
657 * coreutils.texi (du invocation): Use if=/dev/null rather
658 than :|. Problem reported by Dan Jacobson.
659 Use "seek=2GiB" rather than the wordier "seek=`echo '2^31'|bc`".
660 Say "KiB" not the (inaccurate) "kilobytes".
661 Similarly for "GiB" and "gigabytes".
663 2004-11-16 Paul Eggert <eggert@cs.ucla.edu>
665 * coreutils.texi: Changes inspired by Debian coreutils 5.2.1-2.
666 (General output formatting): -x doesn't have an operand.
667 (Formatting the file names): Warn that even with -N unprintable
668 chars are still printed as '?' some times.
669 (rm invocation): Reword rm -d to note that it's sometimes useful
671 (logname invocation, users invocation, who invocation):
672 The utmp and wtmp file names vary from system to system.
674 * getdate.texi (General date syntax): "next" is 1, not 2.
675 Document that "second" isn't allowed as an ordinal number.
677 2004-11-15 Paul Eggert <eggert@cs.ucla.edu>
679 * coreutils.texi (dd invocation): Reword the new dd message.
681 2004-11-14 Paul Eggert <eggert@cs.ucla.edu>
683 * coreutils.texi (dd invocation): dd now outputs total bytes,
684 seconds, and bytes per second.
686 2004-11-03 Paul Eggert <eggert@cs.ucla.edu>
688 * Makefile.am (_W, W_): New macros.
689 (check-texinfo): Use them instead of assuming grep -w (which is not
692 2004-10-29 Paul Eggert <eggert@cs.ucla.edu>
694 * coreutils.texi: Document TZ better, and adjust to new getdate.texi.
696 (pr invocation, Formatting file timestamps, touch invocation,
697 stat invocation, who invocation, date invocation, Options for date):
699 * getdate.texi: Sync from gnulib.
701 2004-10-28 Paul Eggert <eggert@cs.ucla.edu>
703 * coreutils.texi (Standards conformance): Use "head -10" rather
704 than "head -1" as example of obsolete usage, since the POSIX
705 consensus is that "head -1" could be supported even if we don't
706 yet have clear consensus on "head -10". See today's revision to
708 <http://www.opengroup.org/austin/papers/single_unix_faq.html>.
710 2004-10-24 Paul Eggert <eggert@cs.ucla.edu>
712 * coreutils.texi (pathchk invocation): Options must precede operands.
714 2004-10-17 Paul Eggert <eggert@cs.ucla.edu>
716 * coreutils.texi (pathchk invocation): Overall lengths are
717 OS limits, not file system limits. Component length checks
718 apply to all components, not merely to existing ones. Say
719 that nonexistent names are not errors. For -p, omit all
720 checks based on the underlying file system, not merely length
721 checks. Explain what the portable file name character set is.
723 2004-10-15 Paul Eggert <eggert@cs.ucla.edu>
725 * coreutils.texi (printf invocation): Mention ISO/IEC 10646 as
726 well as Unicode. Various minor formatting cleanups.
728 2004-10-13 Paul Eggert <eggert@cs.ucla.edu>
730 * coreutils.texi (sort invocation): Move LC_ALL, LC_COLLATE
731 index entries to proper paragraph.
733 2004-10-12 Jim Meyering <jim@meyering.net>
735 * Makefile.am (check-texinfo): Add `builtin' and `builtins' to
736 the list of words to avoid.
738 2004-10-11 Paul Eggert <eggert@cs.ucla.edu>
740 * coreutils.texi (Special built-in utilities): New node.
741 (printf invocation): builtin -> built-in, for consistency
742 with POSIX terminology.
743 (test invocation, pwd invocation):
744 Use specific rather than generic language to warn about
746 (chroot invocation, env invocation, nice invocation, nohup invocation):
747 Warn that command must not be a special built-in.
748 (env invocation): Warn about environment variables with unusual
749 spellings, or duplicates.
751 2004-09-26 Paul Eggert <eggert@cs.ucla.edu>
753 * coreutils.texi (ls invocation): Document "ls --hide".
755 2004-09-24 Paul Eggert <eggert@cs.ucla.edu>
757 * coreutils.texi (chmod invocation): Warn about "chmod -w file".
759 2004-09-23 Paul Eggert <eggert@cs.ucla.edu>
761 * coreutils.texi (tail invocation): Fix bugs in the description of
762 the obsolete syntax (e.g., it does not support -k or -m). Warn
763 about usages like "tail -" and "tail -c 4" that are ambigous on
766 2004-09-20 Paul Eggert <eggert@cs.ucla.edu>
768 * coreutils.texi (mv invocation, rm invocation): Say "the response
769 is affirmative" rather than "the response begins with y or Y",
770 so that the documentation is accurate in non-English locales.
771 Problem reported by Munzir Taha.
773 2004-09-18 Paul Eggert <eggert@cs.ucla.edu>
775 * coreutils.texi (dd invocation): Distinguish between options
776 (e.g., --help) and operands (e.g., if=file). Move miscellaneous
777 stuff after the operand descriptions, for clarity.
779 2004-09-09 Paul Eggert <eggert@cs.ucla.edu>
781 * coreutils.texi (sort invocation): -u disables the last-resort
782 comparison, too. Revamp its description.
783 (test invocation): Document -r, -w, -x more carefully.
785 2004-09-08 Paul Eggert <eggert@cs.ucla.edu>
787 * coreutils.texi (Common options): Some programs don't reorder
789 (tr invocation, echo invocation, printf invocation, test invocation,
790 expr invocation, basename invocation, chroot invocation,
791 nice invocation, nohup invocation, seq invocation):
792 This program doesn't reorder options.
793 (tr invocation): Mention --help, --version, --.
794 (echo invocation): Mention that -- isn't special.
795 (test invocation): Mention that the expression is optional,
796 and that test ! EXPR is like ! test EXPR.
797 Mention that -h and -L don't dereference symlinks.
798 (expr invocation): Mention --help, --version.
800 * coreutils.texi (sort invocation): Add remarks about sort -u
801 versus sort | uniq. Prompted by a question from Andrew Noymer.
803 2004-09-06 Paul Eggert <eggert@cs.ucla.edu>
805 * coreutils.texi (od invocation): Several changes for POSIX
806 and FreeBSD compatibility. Add support for XSI syntax
807 (POSIX 1003.1-2004). Rename -s[N] to -S N. Remove documentation
808 for -h. -i is now -t dI (not d2) and -l is now -t dL (not d4).
810 2004-09-05 Paul Eggert <eggert@cs.ucla.edu>
812 * coreutils.texi (String tests): Improve quality of warning about
813 quoting strings for the shell.
815 2004-09-03 Paul Eggert <eggert@cs.ucla.edu>
817 * coreutils.texi (dd invocation): Specify which conversion options
818 are mutually exclusive. Give a bit more detail about ascii,
819 ebcdic, and ibm conversions.
821 2004-08-24 Paul Eggert <eggert@cs.ucla.edu>
823 POSIX-conformance fixes for "expand" and "unexpand".
824 * coreutils.texi: Standardize on "tab stop" (the POSIX usage)
825 rather than "tabstop".
826 (unexpand invocation): Use "blank" rather than "space" when
827 POSIX requires "blank". Define "blank". Initial blanks are
828 converted even if there's just one. For -a, convert two or
829 more blanks only if they occur just before a tab stop.
831 2004-08-19 Paul Eggert <eggert@cs.ucla.edu>
833 * coreutils.texi (chown invocation): Fix synopsis:
834 group must always be preceded by separator.
835 "chown : file" and "chown '' file" don't change the owner or group.
836 Update the explanation of what happens to the set-user-ID or
837 set-group-ID bits, e.g., they sometimes are not cleared if they
838 denote mandatory locking. Change "find"-oriented examples to use
841 2004-08-18 Paul Eggert <eggert@cs.ucla.edu>
843 * coreutils.texi (printf invocation): Clarify how "printf" is
844 supposed to work with extra arguments, missing arguments, etc.
846 2004-08-10 Paul Eggert <eggert@cs.ucla.edu>
848 POSIX-conformance fixes for "-" used as an operand.
849 * coreutils.texi (Common options): Clarify that "-" means
850 stdin/stdout only when it is an operand, not when it is an
852 (shred invocation): "shred -- -" is equivalent to "shred -",
854 (tee invocation): "tee -" means to copy (again) to stdout.
856 2004-07-25 Paul Eggert <eggert@cs.ucla.edu>
858 * coreutils.texi (nice invocation): Document the "nice value", and
859 how it affects the scheduling priority. (The old documentation
860 implied that the nice value equaled the scheduling priority, which
861 isn't accurate.) Document that the range of nice values might
862 exceed -20..19. Specify what happens when you give a nice value
863 that is out of range, or when you don't have permissions to lower
864 the nice value. Bash doesn't have a builtin 'nice', so don't say
865 "most shells" have one.
867 2004-04-03 Dmitry V. Levin <ldv@altlinux.org>
869 * coreutils.texi (readlink invocation): Document new
870 "readlink -f" behaviour and new canonicalize options, -e and -m.
872 2004-07-02 Jim Meyering <jim@meyering.net>
874 * Makefile.am (check-texinfo): Disallow `filename' in .texi files.
875 Spell it like `file name' instead, to be consistent.
876 Fail if a @footnote directive follows non-punctuation.
877 Fail upon use of @url. Use @uref instead.
879 2004-07-01 Paul Eggert <eggert@cs.ucla.edu>
881 * coreutils.texi (Common options, Target directory, cp invocation,
882 install invocation, mv invocation, ln invocation): Add -t as a
883 short option for --target-directory, and -T as a short option for
884 --no-target-directory. Clean up relevant synopses a bit, so that
885 the language is similar for all.
887 2004-06-30 Paul Eggert <eggert@cs.ucla.edu>
889 * coreutils.texi: Put the right amount of space at sentence ends.
890 Make sure "i.e." and "e.g." are followed by commas (the GNU style).
891 Put blank lines before and after every @example, prefer the
892 previous line to end in ":" (when not a sentence end, for consistency),
893 and prepend @noindent to the following line when appropriate.
894 In examples, use "--" arguments when needed to prevent undesired
895 interpretation of operands as options.
896 Use "file name" rather than "filename", as per the GNU coding standards.
897 Remove unwanted spaces before @footnote.
898 Use "---" when appropriate, instead of " -- ".
899 Use "name" (or something like that) rather than "path" or "pathname",
900 since the GNU coding standards don't allow "path".
901 Use @acronym, @command, @minus{}, @samp in a few places,
903 (Target directory): Clarify description of example.
904 (fmt invocation): Give issue number for reference, and reword
906 (sort invocation): Note that xargs without -0 also mishandles
907 file names containing some special characters other than newline.
908 (Translating): Mention that \012 is not universally portable.
909 Use '\0' rather than '\000'.
910 (Squeezing): bourne -> Bourne.
911 Fix unportable usage of '\n' by replacing it with '[\n*]'.
912 (More details about version sort): Remove unnecessary indent
914 (dd invocation): Use 'kill -s USR1', not 'kill -USR1', as POSIX
915 indicates that the former is more portable (the latter is an XSI
917 (shred invocation): Use @uref rather than @url, and use a more-typical
919 (kill invocation): Clarify usage; for example, "kill -s TERM -1"
921 (seq invocation): Reword to avoid implying that printf necessarily
922 fails for numbers outside the 32-bit range. Prefer separating
923 options from their operands.
924 (Opening the software toolbox): Give an online reference to
925 Robbins's article, and give a date. Don't imply that the
926 current documentation is unchanged from his article.
927 (Putting the tools together): Rework examples so that they don't
928 assume the C locale; nowadays many users now operate outside the C
929 locale by default. While we're at it, don't assume ASCII either.
930 Indent example to match actual output from GNU uniq. Remove some
931 unnecessary and confusing brackets from 'tr' operands. "Software
932 Tools in Pascal" is back in print, according to Amazon anyway.
933 Add references to Kernighan's online copies of examples.
935 2004-06-30 Paul Eggert <eggert@cs.ucla.edu>
937 * coreutils.texi, perm.texi: Standardize on "file system" rather
938 than "filesystem", as POSIX prefers it with a space.
940 2004-06-29 Paul Eggert <eggert@cs.ucla.edu>
942 * coreutils.texi (Common options, Target directory, cp
943 invocation, install invocation, mv invocation, ln invocation):
945 (link invocation): Explain how to rewrite link using ln now
946 that we have --no-target-directory.
947 (ln invocation): Explain that --no-target-directory subsumes
949 (unlink invocation): Modify wording to match new wording in
952 2004-06-25 Paul Eggert <eggert@cs.ucla.edu>
954 * coreutils.texi (install invocation): Document
955 --target-directory in synopsis, too.
957 2004-06-15 Paul Eggert <eggert@cs.ucla.edu>
959 * coreutils.texi (yes invocation): "--" is now supported.
960 (false invocation, true invocation): --help and --version now
961 work unconditionally.
963 2004-06-07 Jim Meyering <jim@meyering.net>
965 * coreutils.texi: Remove menu references to just-removed subsection.
967 2004-06-06 Jim Meyering <jim@meyering.net>
969 * coreutils.texi (tr invocation): Remove the section describing
970 how POSIXLY_CORRECT changes tr's behavior.
972 2004-06-02 Jim Meyering <jim@meyering.net>
974 * coreutils.texi (cut invocation): Clarify what --output-delimiter=STR
975 does with byte/character ranges.
977 2004-06-01 Paul Eggert <eggert@cs.ucla.edu>
979 * coreutils.texi (tr invocation): Mention -C.
981 2004-05-13 Paul Eggert <eggert@cs.ucla.edu>
983 * coreutils.texi (echo invocation): Document today's changes.
985 2004-05-17 Jim Meyering <jim@meyering.net>
987 chgrp and chown now dereference symlinks by default, per POSIX.
988 * coreutils.texi (chgrp invocation, chown invocation): Document it.
990 2004-05-13 Paul Eggert <eggert@cs.ucla.edu>
992 * coreutils.texi (sort invocation): Document that "sort -m -o F"
993 might write F before reading all the input.
995 2004-05-09 Jim Meyering <jim@meyering.net>
997 * coreutils.texi (stat invocation): Change IO to I/O.
998 * Makefile.am (check-texinfo): Check for the above.
1000 2004-04-25 Paul Eggert <eggert@twinsun.com>
1002 * coreutils.texi (sort invocation): Mention -k earlier, so
1003 that the options are in alphabetical order. Describe how -b works
1004 more-accurately; this involves fixing some examples, too. Mention
1005 what happens if the start field falls after an end field or after
1006 a line end. Warn about using -k without -b, -g, -M, -n, or -t.
1007 Add an example of how to sort IPv4 addresses and Apache Common
1008 Log Format dates. Remove a duplicate example.
1009 (Putting the tools together): Use separate options rather
1010 than agglomerating them.
1012 2004-03-27 Paul Eggert <eggert@twinsun.com>
1014 cp -pu and mv -u (when copying) now take the destination
1015 file system time stamp resolution into account.
1017 * coreutils.texi (mv invocation): Document this.
1018 (cp invocation): Document -u (it was missing!) with new behavior.
1020 2004-04-08 Paul Eggert <eggert@cs.ucla.edu>
1022 * coreutils.texi (dd invocation): Remove noctty flag from dd.
1024 2004-04-07 Paul Eggert <eggert@twinsun.com>
1026 New dd conv= symbols nocreat, excl, fdatasync, fsync,
1027 and new dd options iflag= and oflag=.
1029 * coreutils.texi (dd invocation): Document them.
1031 2004-04-07 Jim Meyering <jim@meyering.net>
1033 * coreutils.texi (stty invocation - Input): Document new iutf8 option.
1035 2004-04-04 Jim Meyering <jim@meyering.net>
1037 * coreutils.texi (stat invocation): Correct --format description.
1039 2004-02-25 Paul Eggert <eggert@twinsun.com>
1041 * coreutils.texi (Block size): Document new envvar BLOCKSIZE.
1043 2004-03-24 Jim Meyering <jim@meyering.net>
1045 * Makefile.am (check-texinfo): Add a check to ensure future
1046 consistency in using @sc{nul}, not `NUL'.
1048 2004-03-23 Paul Eggert <eggert@twinsun.com>
1050 * coreutils.texi: Use @sc{nul} consistently for NUL.
1051 (du invocation): FILE0 -> FILE.
1053 2004-03-23 Jim Meyering <jim@meyering.net>
1055 * coreutils.texi (du invocation): --files0-from is useful with
1056 --total (-c), not with --summarize.
1058 2004-03-22 Jim Meyering <jim@meyering.net>
1060 * coreutils.texi: Tweak a few lines that resulted in
1061 `overfull hbox' warnings.
1063 2004-03-03 Jim Meyering <jim@meyering.net>
1065 * coreutils.texi (du invocation): Document new option: --file0-from=F.
1067 2004-02-29 Paul Eggert <eggert@twinsun.com>
1069 * coreutils.texi (touch invocation):
1070 Describe use of fractional seconds.
1071 (date invocation, Options for date): Likewise.
1072 * getdate.texi (General date syntax, Time of day items): Likewise.
1073 * coreutils.texi (date invocation): Mention effect of LC_TIME.
1074 (Options for date): Describe new --iso-8601=ns option.
1076 * getdate.texi: Add copyright notice. Change getdate to
1077 get_date when talking about the function name.
1078 (Seconds since the Epoch): New section, containing the time_t
1079 info moved from Date input formats section, along with new
1080 info about the @ syntax. Mention negative time stamps,
1081 fractional time stamps, and leap seconds.
1082 (General date syntax): Modernize examples a bit to reflect new
1084 (General date syntax, Relative items in date strings):
1085 Use ' rather than " to quote formats.
1086 (Time of day items): Add an example with fractional seconds.
1087 Describe fractional-second syntax.
1089 2004-03-15 Jim Meyering <jim@meyering.net>
1091 * coreutils.texi (date invocation): Add missing `C' to %[...] range
1092 in the `Date directives:: ...' menu entry. From Bob Proulx.
1094 * coreutils.texi: Add FIXME comment:
1095 The following don't have `invocation' nodes: [, pinky, shasum, uptime.
1097 2004-03-10 Jim Meyering <jim@meyering.net>
1099 * coreutils.texi (Sorting the output): Remove description of
1100 ls's --sort=directory option. ls doesn't accept that option, yet.
1101 Reported by Arvind Autar.
1103 * coreutils.texi (cp invocation): Improve description of
1104 cp's --sparse=WHEN option.
1106 * coreutils.texi (nl invocation): Specify that these are _basic_
1107 regular expressions (BRE), and add a link to grep's documentation.
1108 Suggestion from Dan Jacobson.
1110 2004-02-23 Paul Eggert <eggert@twinsun.com>
1112 * coreutils.texi (chown invocation): Document that chown now falls
1113 back on USER.GROUP parsing regardless of POSIX version, as POSIX
1114 1003.1-2001 allows that behavior as a compatible extension.
1116 2004-02-22 Jim Meyering <jim@meyering.net>
1118 * coreutils.texi (du invocation): Mention that using du's -H option
1119 currently evokes a warning.
1121 2004-02-15 Paul Eggert <eggert@twinsun.com>
1123 * coreutils.texi (expr invocation):
1124 Document what forms integers may take, and say "integer"
1125 consistently instead of "number". Warn about operands
1126 that "expr" can misinterpret, and how to work around the
1129 2004-02-17 Jim Meyering <jim@meyering.net>
1131 * coreutils.texi (csplit invocation): Correct typo (s/LINE/N/)
1132 in description of `N' pattern. From Reuben Thomas <rrt@sc3d.org>
1134 2004-02-11 Jim Meyering <jim@meyering.net>
1136 * coreutils.texi (Time directives): The %s value *is* changed by the
1137 --date=DATE option; don't say otherwise. Patch from Padraig Brady.
1139 2004-02-10 Paul Eggert <eggert@twinsun.com>
1141 * coreutils.texi (Formatting the file names):
1142 Improve wording for --quoting-style documentation.
1143 Suggestions by Bruno Haible.
1145 2004-02-02 Jim Meyering <jim@meyering.net>
1147 * coreutils.texi (nice invocation): Add examples.
1148 Prompted by a suggestion from Dan Jacobson.
1149 (factor invocation): Add an example.
1150 Update timing numbers for a more modern CPU.
1152 2004-01-27 Jim Meyering <jim@meyering.net>
1154 * coreutils.texi (seq invocation): Remove `@dots{}' at end of synopsis.
1155 Separate `Synopses' section into three examples.
1156 Clarify first paragraph. @w{}-protect an expression.1
1157 Use @option{--option}, rather than @code{--option}.
1159 2004-01-19 Paul Eggert <eggert@twinsun.com>
1161 * coreutils.texi (Exit status): Document that ordinary failure
1162 might not exit with status 1 on unusual platforms.
1163 Mention chroot, env, nice, and su as having unusual exit
1164 status patterns. Don't bother to mention true and false
1165 since their exit status patterns are actually normal.
1166 (sort invocation, su invocation): Mention its unusual exit
1168 (chroot invocation): Simplify description of exit status 1.
1169 Remove duplicate description of status 127.
1170 (env invocation): Use consistent tenses; simplifiy description
1172 (nice invocation): Likewise.
1174 2003-12-15 Paul Eggert <eggert@twinsun.com>
1176 * coreutils.texi (touch invocation): touch -r and -d can now
1177 both be specified, with -r specifying the origin for -d.
1179 2004-01-15 Alfred M. Szmidt <ams@kemisten.nu>
1181 Factor out some common options.
1182 * coreutils.texi (Common options): Define macros here.
1183 (What information is listed, cp invocation): Use the macro(s).
1184 (install invocation, mv invocation, ln invocation): Likewise.
1185 (df invocation, du invocation): Likewise.
1187 2004-01-09 Jim Meyering <jim@meyering.net>
1189 Document the exit status of each and every program.
1190 * coreutils.texi (yes invocation): Document that a write error
1191 makes `yes' exit unsuccessfully.
1192 (chroot invocation): Enumerate the meaning of exit status values.
1193 (nice invocation): Likewise.
1194 (Exit status) [@macro exitstatus]: New macro.
1195 Use @exitstatus to describe the exit status of most programs.
1197 2004-01-02 Jim Meyering <jim@meyering.net>
1199 * coreutils.texi (du invocation): Mention that -H will eventually
1200 mean not --si, but --dereference-args (-D).
1202 2003-12-20 Jim Meyering <jim@meyering.net>
1204 * coreutils.texi (du invocation): Describe new option: -0, --null.
1206 2003-12-03 Paul Eggert <eggert@twinsun.com>
1208 * coreutils.texi (What information is listed, chroot invocation):
1209 Adjust example 'ls' output to match new behavior with narrower
1211 (The cut command): Remove example that cut the output of
1212 'ls -l'. The output was incorrect even with the old 'ls', and
1213 the whole idea of using 'cut' on 'ls -l' output is bogus anyway.
1215 2003-11-24 Paul Eggert <eggert@twinsun.com>
1217 Parse floating-point operands and options in the C locale.
1218 POSIX requires this for printf, and we might as well be
1219 consistent elsewhere (tail, sleep, seq).
1221 * coreutils.texi (tail invocation, printf invocation,
1222 sleep invocation, seq invocation): Document this.
1224 2003-11-24 Jim Meyering <jim@meyering.net>
1226 * coreutils.texi (Traversing symlinks, Treating / specially):
1228 (rm invocation, chown invocation, chmod invocation, chgrp invocation):
1229 Describe new options, --preserve-root and --no-preserve-root.
1231 2003-11-11 Jim Meyering <jim@meyering.net>
1233 * coreutils.texi (chown invocation) [chownchgrpoptions]: New macro
1234 describing -H, -L, -P options. Use it here.
1235 (chgrp invocation): And here.
1237 2003-11-09 Jim Meyering <jim@meyering.net>
1239 * coreutils.texi (dd invocation): Fix typo in example.
1241 2003-10-15 Jim Meyering <jim@meyering.net>
1243 * coreutils.texi (ln invocation): Note that --directory, -d, -F
1244 probably won't work even for superuser. Suggestion from Dan Jacobson.
1246 2003-09-29 Paul Eggert <eggert@twinsun.com>
1248 * coreutils.texi (csplit invocation):
1249 The regexp offset need not have a sign; POSIX requires support
1250 for signless offets.
1252 2003-10-03 Jim Meyering <jim@meyering.net>
1254 * coreutils.texi (du invocation): Describe -P, --no-dereference.
1256 2003-09-28 Jim Meyering <jim@meyering.net>
1258 * coreutils.texi (Translating): Correct typo in menu description.
1261 2003-09-02 Paul Eggert <eggert@twinsun.com>
1263 * coreutils.texi (sort invocation): -d now overrides -i.
1264 "whitespace" -> "blanks"; "whitespace" isn't correct.
1265 -t '\0' now specifies a NUL tab.
1267 2003-08-17 Jim Meyering <jim@meyering.net>
1269 * coreutils.texi (who invocation): Add an entry for -l, --login.
1270 Remove `-l' from the entry for --lookup.
1271 (who invocation): Begin adding missing option documentation.
1273 2003-08-07 Paul Eggert <eggert@twinsun.com>
1275 * coreutils.texi (split invocation):
1276 Add -d or --numeric-suffixes option to 'split'.
1278 2003-07-31 Paul Eggert <eggert@twinsun.com>
1280 * getdate.texi (General date syntax): Add --rfc-2822 option to GNU date.
1281 * coreutils.texi (Options for date): Fix a typo in format:
1282 it's now %d not %_d. Add URLs.
1284 2003-07-31 Paul Eggert <eggert@twinsun.com>
1286 * getdate.texi (Relative items in date strings): Warn about
1287 fuzz in relative units.
1289 2003-07-29 Jim Meyering <jim@meyering.net>
1291 * coreutils.texi (tail invocation): Restore two end-of-sentence words
1292 that were mistakenly removed on 2002-09-13. Reported by Paul Worrall.
1294 2003-07-28 Jim Meyering <jim@meyering.net>
1296 * coreutils.texi (dd invocation): Explain that a SIGUSR1 signal
1297 makes dd give a progress report to stderr.
1299 2003-07-24 Paul Eggert <eggert@twinsun.com>
1301 * coreutils.texi: Document changes of 2003-07-24.
1303 2003-07-24 Jim Meyering <jim@meyering.net>
1305 * coreutils.texi (su invocation): Use `@subsection', not invalid
1308 2003-07-17 Paul Eggert <eggert@twinsun.com>
1310 * coreutils.texi (expr invocation): Exit status is 2 if the
1311 expression is syntactically invalid, 3 if there is some other error.
1312 This change is for conformance to POSIX.
1314 2003-07-14 Paul Eggert <eggert@twinsun.com>
1316 * coreutils.texi (uname invocation): Explain the POSIX
1317 terminology behind uname -m and uname -s.
1319 2003-07-13 Jim Meyering <jim@meyering.net>
1321 * coreutils.texi (chown invocation): Warn that chown
1322 now clears set-user-ID and set-group-ID bits on some systems.
1324 (nohup invocation): Tell what happens when stdout is not a terminal.
1325 Based on a suggestion from Steven Mocking.
1327 2003-07-10 Jim Meyering <jim@meyering.net>
1329 * coreutils.texi (Standards conformance): Mention that uses like
1330 `tail -1' and `head -1', like `sort +1', are non conforming.
1331 (chown invocation): Say that using `.' as a separator may not work.
1333 2003-06-25 Jim Meyering <jim@meyering.net>
1335 * coreutils.texi (Time directives) [%s]: Add a cross reference
1336 to the related examples.
1337 (Examples of date): Add an @anchor here, along with a few more examples.
1338 Suggestion from Dan Jacobson.
1340 2003-06-12 Jim Meyering <jim@meyering.net>
1342 * coreutils.texi (wc invocation): Tweak wording: wc prints counts in
1343 the order `newline, word, byte'. Suggestion from Keith M. Briggs.
1344 Also change `lines' to `newlines'.
1346 2003-05-14 Jim Meyering <jim@meyering.net>
1348 * coreutils.texi (head invocation): Document --bytes=-N and --lines=-N.
1350 2003-05-13 Paul Eggert <eggert@twinsun.com>
1352 * coreutils.texi (uniq invocation, squeezing, The uniq command):
1353 Use "repeated" rather than "duplicate" to describe adjacent
1354 duplicates; this simplifies the description and makes it more
1355 consistent with POSIX.
1356 (uniq invocation): Make it clear that -d and -u suppress the
1357 output of lines, rather than cause some lines to be output.
1358 Mention what happens if a line lacks enough fields or characters.
1360 2003-05-13 Jim Meyering <jim@meyering.net>
1362 * coreutils.texi (true invocation): Mention that it is possible to
1363 make true --help or true --version (in non-POSIX mode) exit nonzero.
1364 Suggestion from Paul Eggert.
1366 2003-05-10 Jim Meyering <jim@meyering.net>
1368 * coreutils.texi (Exit status): Remove `uniq' from the list.
1369 It uses standard exit codes.
1370 (More details about version sort): Note that strverscmp, and hence
1371 `ls -v', does not use LC_COLLATE. Reported by From: Andrey Borzenkov.
1373 2003-04-21 Jim Meyering <jim@meyering.net>
1375 Fix printf POSIX compatibility bug reported by Ben Harris in
1376 <http://mail.gnu.org/archive/html/bug-coreutils/2003-04/msg00070.html>.
1377 * coreutils.texi (printf invocation): It's \NNN in the format,
1378 \0NNN in the %b operand.
1380 2003-04-10 Jim Meyering <jim@meyering.net>
1382 * Makefile.am (check-texinfo): Check for uses of non-zero.
1383 I prefer to spell it `nonzero'.
1385 * coreutils.texi (readlink invocation): Tweak description a little.
1387 2003-04-04 Jim Meyering <jim@meyering.net>
1389 * Makefile.am (constants.texi): Rename target (thus enabling it),
1390 now that fileutils, textutils, and sh-utils have been merged.
1391 (MAINTAINERCLEANFILES): Define.
1393 2003-04-02 Jim Meyering <jim@meyering.net>
1395 * coreutils.texi (false invocation): Note that false exits
1396 unsuccessfully even with --help and --version.
1398 * Makefile.am (check-texinfo): Don't fail if perl is missing.
1399 Reported by Nelson Beebe.
1401 2003-03-27 Jim Meyering <jim@meyering.net>
1403 * coreutils.texi (printf invocation): Fix formatting bugs.
1405 (sort invocation): Describe sort's --stable (-s) option.
1407 2003-03-13 Jim Meyering <jim@meyering.net>
1409 * coreutils.texi (shred invocation): Mention that --exact
1410 is now the default for non-regular files.
1412 2003-03-02 Jim Meyering <jim@meyering.net>
1414 * coreutils.texi (Exit status): New section.
1415 Suggestion from Michael Stone.
1417 2003-02-21 Jim Meyering <jim@meyering.net>
1419 * coreutils.texi (du invocation): Document --apparent-size.
1420 Adjust documentation of --bytes (-b).
1421 (stat invocation): Describe %B.
1423 2003-02-07 Richard Dawe <rich@phekda.freeserve.co.uk>
1425 * coreutils.texi: Use @command instead of @code for program names.
1427 * perm.texi (Mode Structure): Mention filesystem-specific
1428 permissions and that mounting a filesystem as read-only may
1429 override actual file permissions. Use @command instead
1430 of @code for program names.
1432 2003-02-06 Jim Meyering <jim@meyering.net>
1434 * coreutils.texi: Adjust alignment and mention `file, text, shell'
1435 on the `* Coreutils:...' dirently line. From Karl Berry.
1437 2003-02-05 Jim Meyering <jim@meyering.net>
1439 * Makefile.am (check-texinfo): Allow bare `POSIX' to be used on
1442 * coreutils.texi: Use new form of @direntry.
1443 Put unlink in its proper place. Adjust wording in some
1444 dir entry descriptions, mainly so they fit in 80 columns.
1445 Don't use mark-up like @acronym{POSIX} in direntries.
1446 Mostly from Karl Berry.
1448 2003-01-25 Jim Meyering <jim@meyering.net>
1450 * coreutils.texi (cut invocation): Describe new functionality of
1451 --output-delimiter=STR.
1453 2003-01-24 Jim Meyering <jim@meyering.net>
1455 * coreutils.texi (The cut command): Give an example of using cut -c
1456 with an output delimiter. From Jan Nieuwenhuizen.
1458 * coreutils.texi (The cut command): Extend the new example a little.
1459 (Formatting file timestamps): Fix typo: s/%M:S/%M:%S/.
1461 * coreutils.texi: Change each use of `Core-utils' to `Coreutils'.
1464 2003-01-19 Jim Meyering <jim@meyering.net>
1466 * coreutils.texi (Which files are listed): Document new option:
1467 --dereference-command-line-symlink-to-dir.
1469 2003-01-15 Paul Eggert <eggert@twinsun.com>
1471 Change ls -H back to the way it was yesterday, since this is
1472 compatible with FreeBSD and the POSIX spec is confusing
1473 and somewhat contradictory.
1475 * coreutils.texi (Which files are listed, General output
1476 formatting): Undo last change.
1478 2003-01-15 Jim Meyering <jim@meyering.net>
1480 * coreutils.texi (General output formatting): Reflect option name change:
1481 s/--dereference-command-line/--dereference-command-line-symlink-to-dir/.
1482 Say that this option changes how ls treats only symlinks to directories
1483 specified on the command line.
1485 2002-08-27 Dmitry V. Levin <ldv@altlinux.org>
1487 * coreutils.texi: Document readlink.
1489 2002-12-14 Jim Meyering <jim@meyering.net>
1491 * coreutils.texi (mknod invocation): Specify how major and minor mode
1492 numbers are interpreted. Report forwarded by Kristin E Thomas.
1494 2002-11-13 Jim Meyering <jim@meyering.net>
1496 * coreutils.texi (Examples of expr): Remove bogus `^'s.
1497 Reported by Thomas Goerlich.
1499 2002-11-09 Jim Meyering <jim@meyering.net>
1501 * coreutils.texi (What information is listed) [--dired]:
1502 Correct parts of --dired description. Reported by Andre Spiegel.
1503 Include a lot more description, with examples.
1505 2002-11-06 Jim Meyering <jim@meyering.net>
1507 * coreutils.texi (printf invocation): Fix typo in index:
1508 change \0x prefix to \x.
1509 Change \xhhh to \xhh.
1511 2002-10-07 Paul Eggert <eggert@twinsun.com>
1513 Add support for locale-specific size indications (e.g.,
1514 thousands-separators) and for explicit size suffixes on output.
1516 * coreutils.texi (Block size): Say that:
1517 This affects display format as well as block size.
1518 Fractional block counts are rounded up.
1519 ls file size blocksize defaults to 1.
1520 A block size spec preceded by ' generates thousands separators.
1521 A suffix without a preceding integer generates suffixes.
1522 (tail invocation): 32k -> 32 KiB.
1523 (What information is listed): ls -h is now equivalent to
1524 ls --block-size=human, and ls -H is now equivalent to
1525 ls --block-size=si. Displayed file size is now always affected by
1528 2002-09-13 Jim Meyering <jim@meyering.net>
1530 * coreutils.texi (tail invocation): In --sleep-interval=NUMBER,
1531 NUMBER may now be a floating point number.
1532 (stat invocation): Remove references to now-removed %S and %C.
1533 (Time directives) [%S]: Explain why the range is [0..60].
1535 2002-08-30 Jim Meyering <jim@meyering.net>
1537 * coreutils.texi [START-INFO-DIR-ENTRY]: Don't use sc{} on LHS.
1538 Fix typo: s/permission/permissions/. From Michail Litvak.
1540 2002-08-02 Paul Eggert <eggert@twinsun.com>
1542 * coreutils.texi (uniq invocation): uniq now obeys LC_COLLATE.
1544 2002-07-29 Paul Eggert <eggert@twinsun.com>
1546 * coreutils.texi (nohup invocation): Change behavior to conform to
1548 - Do not adjust scheduling priority.
1549 - Redirects stderr to stdout, if stderr is not a terminal.
1550 - Exit status is now 126 if command was found but not invoked,
1551 127 if nohup failed or if command was not found.
1553 2002-07-24 Jim Meyering <jim@meyering.net>
1555 * coreutils.texi (Time directives): Document %P, %R, %e, %F,
1558 2002-07-22 Martin Michlmayr <tbm@cyrius.com>
1560 * coreutils.texi (Formatting the file names): Document
1561 that -N/--literal are equivalent to --quoting-style=literal.
1562 Reported by Oskar Liljeblad as Debian bug#103612.
1564 2002-07-10 Jim Meyering <jim@meyering.net>
1566 * coreutils.texi (du invocation): s/PAT/PATTERN/.
1567 From Martin Michlmayr.
1569 2002-07-08 Jim Meyering <jim@meyering.net>
1571 * coreutils.texi (cp invocation): Remove unnecessary "$@" in example;
1572 Texinfo would render the @" as an umlaut over the following character.
1574 * Makefile.am (check-texinfo): Check for the above.
1576 2002-07-06 Jim Meyering <jim@meyering.net>
1578 * coreutils.texi (stat invocation): Remove description of --secure.
1580 2002-07-03 Jim Meyering <jim@meyering.net>
1582 * coreutils.texi (stat invocation): Rename --link/-l
1583 to --dereference/-L. Rewrite description of --dereference.
1585 2002-06-26 Paul Eggert <eggert@twinsun.com>
1587 * coreutils.texi (Putting the tools together): Don't mention egrep,
1588 since it's not part of POSIX 1003.1-2001.
1590 2002-06-21 Jim Meyering <jim@meyering.net>
1592 * coreutils.texi (stat invocation): New section. From Michael Meskes.
1594 2002-05-19 Paul Eggert <eggert@twinsun.com>
1596 * coreutils.texi (ls invocation): Document new option: --author.
1598 2002-06-03 Jim Meyering <jim@meyering.net>
1600 * coreutils.texi (rm invocation): Add the warning (also in the --help
1601 output) that the contents of a removed file are often recoverable.
1603 2002-05-27 Jim Meyering <jim@meyering.net>
1605 * Makefile.am (check-texinfo): Adapt to reflect that now we use
1608 2002-05-26 Jim Meyering <jim@meyering.net>
1610 * coreutils.texi: Use @acronym in place of most uses of @sc.
1611 * getdate.texi (Date input formats): Likewise.
1613 2002-04-28 Jim Meyering <jim@meyering.net>
1615 * coreutils.texi: Change `@code{PROG}' to `@command{PROG}'.
1617 2002-04-28 Paul Eggert <eggert@twinsun.com>
1619 * coreutils.texi (kill invocation): Document the above.
1620 Document POSIX signals better.
1622 2002-04-15 Jim Meyering <jim@meyering.net>
1624 * coreutils.texi: Document kill.
1625 Written by Marcus Brinkmann.
1627 2002-04-13 Jim Meyering <jim@meyering.net>
1629 * coreutils.texi: Document link and unlink.
1631 2002-04-08 Jim Meyering <jim@meyering.net>
1633 * coreutils.texi: Use new directives, @copying and @insertcopying,
1634 thus now requiring texinfo-4.2 to create the .info file.
1636 2002-02-26 Paul Eggert <eggert@twinsun.com>
1638 * coreutils.texi (File characteristic tests): Document the
1639 behavior of test -nt and -ot when one of the files does not exist,
1640 using the same behavior that is documented in ksh93.
1642 2002-03-05 Paul Eggert <eggert@twinsun.com>
1644 * coreutils.texi (cut invocation): Say that selected input is
1645 written in the same order that it is read, and is written
1648 2002-03-03 Paul Eggert <eggert@twinsun.com>
1650 Make cp -r equivalent to cp -R. Add a new cp option --copy-contents
1651 for people who want to emulate the traditional (and rarely desirable)
1654 * coreutils.texi (cp invocation): Document this.
1655 Fix some related minor bugs: --no-dereference is no longer
1656 equivalent to -d, and --archive (-a) can override the other
1657 symlink options. Warn that cp -R is not portable on symbolic
1658 links unless you also specify -P.
1660 2002-03-02 Jim Meyering <jim@meyering.net>
1662 * coreutils.texi (cp invocation): Document that cp -r
1663 preserves symlinks. Emphasize non-portability of cp -r.
1665 2002-02-27 Paul Eggert <eggert@twinsun.com>
1667 * coreutils.texi (Time directives): Add %N for nanoseconds.
1668 This documents the recent change to 'ls'.
1670 2002-02-28 Jim Meyering <jim@meyering.net>
1672 * coreutils.texi (pr invocation): Reword to avoid using `:'
1673 in an @opindex entry -- info doesn't permit it.
1675 2002-02-27 Paul Eggert <eggert@twinsun.com>
1677 * coreutils.texi (Formatting file timestamps): Document new
1678 time-formatting method: --time-style=+FORMAT.
1680 2002-02-18 Paul Eggert <eggert@twinsun.com>
1682 * coreutils.texi (seq invocation): In the example, use "tail
1683 -n 3", not "tail -3", to conform to POSIX 1003.1-2001.
1685 2002-02-17 Jim Meyering <jim@meyering.net>
1687 * coreutils.texi (tsort background): New section.
1688 From Ian Lance Taylor.
1689 (tsort invocation): Add a more realistic example.
1691 2002-02-15 Paul Eggert <eggert@twinsun.com>
1693 * coreutils.texi: Document _POSIX2_VERSION.
1694 (Standards Conformance): New section.
1696 2002-01-24 Jim Meyering <jim@meyering.net>
1698 * coreutils.texi (START-INFO-DIR-ENTRY): Remove a few entries
1699 and clean up a few others based on suggestions from Bob Proulx.
1701 2002-02-14 Paul Eggert <eggert@twinsun.com>
1703 Add support for POSIX 1003.1-2001, which requires removal for
1704 support of obsolete "+" option syntax in sort, tail, and uniq.
1705 * coreutils.texi: Document this. (Also, document a similar
1706 change to "touch", for fileutils).
1708 2002-01-12 Jim Meyering <jim@meyering.net>
1710 * coreutils.texi (shred invocation): List some journaled filesystems.
1712 2001-11-10 Jim Meyering <jim@meyering.net>
1714 * coreutils.texi (Date directives): Document %u.
1716 2001-11-07 Paul Eggert <eggert@twinsun.com>
1718 * coreutils.texi (paste invocation): Give examples.
1719 Thanks to Dan Jacobson for suggesting the examples.
1721 2001-11-05 Jim Meyering <jim@meyering.net>
1723 * coreutils.texi (sort invocation): Recommend setting LC_ALL=C,
1724 not LC_COLLATE=C. Explain how the latter can cause problems.
1725 Based on a message from Paul Eggert.
1726 (ls invocation): Recommend setting LC_ALL=C, not LC_COLLATE=C.
1728 2001-10-21 Jim Meyering <jim@meyering.net>
1730 * coreutils.texi (cp invocation): Describe --reply=...
1732 2001-10-17 Jim Meyering <jim@meyering.net>
1734 * coreutils.texi (cp invocation): `cp --no-dereference' is
1735 no longer equivalent to `cp -d'.
1736 `cp -d' is equivalent to `--no-dereference --preserve=links'.
1737 cp's -P option means --no-dereference, not --parents.
1738 Describe new optional argument to --preserve.
1739 Describe new option: --no-preserve=ATTRIBUTE_LIST.
1741 2001-09-23 Jim Meyering <jim@meyering.net>
1743 * Makefile.am (check-texinfo): Redirect stderr of `grep -w' to
1744 /dev/null, so people with old versions of grep don't see the failure.
1746 2001-09-16 Jim Meyering <jim@meyering.net>
1748 * coreutils.texi (mv invocation): Describe new option:
1749 --reply={yes,no,query}. Fix a few typos.
1751 2001-09-15 Paul Eggert <eggert@twinsun.com>
1753 * coreutils.texi (uniq invocation): The input need not
1754 be sorted. Try to clarify -d versus -D versus -u.
1756 2001-09-12 Jim Meyering <jim@meyering.net>
1758 * coreutils.texi (tail invocation): Document new option: -F.
1761 2001-09-04 Paul Eggert <eggert@twinsun.com>
1763 * coreutils.texi (join invocation): Describe the GNU
1764 extension to join, which does not require sorted input when
1765 the input contains no unpairable lines.
1767 2001-09-03 Paul Eggert <eggert@twinsun.com>
1770 New 'uname' options -i or --hardware-platform,
1771 and -o or --operating-system.
1772 'uname -a' now outputs -i and -o information at the end.
1773 New uname option --kernel-version is an alias for -v.
1774 Uname option --release has been renamed to --kernel-release,
1775 and --sysname has been renamed to --kernel-name;
1776 the old options will work for a while, but are no longer documented.
1778 2001-08-24 Herbert Xu <herbert@gondor.apana.org.au>
1780 * coreutils.texi (cut invocation): Document how cut treats lines
1783 2001-06-19 Paul Eggert <eggert@twinsun.com>
1785 * coreutils.texi: expr now uses LC_COLLATE for string comparison,
1788 2001-08-25 Jim Meyering <jim@meyering.net>
1790 * coreutils.texi: Use @option, rather than @samp everywhere.
1792 2001-06-21 Paul Eggert <eggert@twinsun.com>
1794 * coreutils.texi: 'expr' now requires '+' rather than 'quote'
1797 2001-07-14 Jim Meyering <jim@meyering.net>
1799 * coreutils.texi (cp invocation): Reflect 2001-07-08 change to
1802 2001-06-16 Jim Meyering <jim@meyering.net>
1804 * Makefile.am (info_TEXINFOS): Reflect renaming: s/omni-/core/.
1805 * coreutils.texi: Likewise.
1807 * coreutils.texi: New, renamed from omni-utils.texi.
1808 * omni-utils.texi: Removed, renamed to coreutils.texi.
1810 * omni-utils.texi (ls invocation): Mention the effect of locale.
1811 Reported by Keith Thompson.
1813 2001-05-24 Jim Meyering <jim@meyering.net>
1815 * texinfo.tex: Update from master source.
1817 * omni-utils.texi (ls invocation): Document more clearly what ls
1818 does when given no arguments.
1820 2001-05-21 Jim Meyering <jim@meyering.net>
1822 * textutils.texi: Remove file.
1824 * Makefile.am ($(DVIS), $(INFO_DEPS)): Depend on $(EXTRA_DIST).
1825 (DISABLED_constants.texi): New rule -- disabled for now.
1827 This directory is now shared by fileutils, textutils, and sh-utils.
1832 Copyright (C) 2001, 2003, 2004, 2005, 2006 Free Software
1835 Copying and distribution of this file, with or without
1836 modification, are permitted provided the copyright notice
1837 and this notice are preserved.