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