summaryrefslogtreecommitdiff
path: root/doc/coreutils.texi
AgeCommit message (Collapse)Author
2005-03-08(date invocation): Use an example that makes itPaul Eggert
clear tha the default date use space-padded day of month. Replace "directive" with "conversion specifier" to be consistent with POSIX. All uses changed. Fix menu RHS to match actual directive lists. (Time conversion specifiers): Renamed from Time directives. Use @samp consistently, sometimes instead of @code. Consistently ention which specifiers are GNU extensions. Give more examples (in some cases, instead of ranges). Say why %F is preferred for dates. (Date conversion specifiers): Renamed from Date directives. Likewise for other changes. (Padding and other flags): Correct the description. Document #. Give an example for %9B.
2005-02-24(Time directives): Say that %k, %l, and %P arePaul Eggert
GNU extensions. For %p and %P, mention handling of noon and midnight. For %s, use ISO 8601, and mention handling of leap seconds. For %S, clarify mention of leap seconds. For %T, say that it's the same as %H:%M:%S. For %X, don't say that it must be the same as %H:%M:%S. For %z and %Z, clarify which time zones are used. These options are now affected by --date, so don't claim that they're not. (Date directives): %C is now all but the last two chars of %Y. For %D, say that it's equivalent to %m/%d/%y. For %e, use blank in example. For %h, use @code for %b. For %Y, mention what happens with outlandish years. (Padding and other flags): Renamed from Padding. Mention that the flags are GNU extensions. Mention the 0 and ^ flags. Mention field widths an modifiers. (Examples of date): - is a flag, not a modifier.
2005-02-08(stat invocation): Document stat -f -c %S (versus %s).Paul Eggert
2005-02-08(stat invocation): Normalize terminology,Paul Eggert
capitalization, and sort order to match --help output. Mention %c for file systems. Say that %s is the "Fundamental block size", since that is what POSIX says.
2005-01-10Update copyright date.Paul Eggert
2005-01-10Document changes responding to POSIX interpretations about pathchk -pPaul Eggert
dated 2005-01-06.
2005-01-07Correct last change: s/zero/no/ From Paul Jarc.Jim Meyering
2005-01-07(sort invocation): Specify that a string of zero digits is interpreted as 0.Jim Meyering
2005-01-04 * coreutils.texi (shred invocation): Clarify that shred works fineJim Meyering
with journaled file systems that are configured not to journal file system data. Also mention BFS and NTFS.
2004-12-15(ls invocation): Change minor problem to bePaul Eggert
"subdirectory not found", since top-level trouble is now serious. (dircolors invocation): Quote argument to eval. Problem reported by Stephane Chazelas.
2004-12-12(join invocation): Mention that blank separatorsPaul Eggert
in the -o option need to be quoted.
2004-12-11(id invocation): -G also prints main group.Paul Eggert
2004-12-09(ls invocation): Document new "ls" exit status.Paul Eggert
2004-12-04(cut invocation): Say when --complement is useful.Jim Meyering
2004-11-27(du invocation): Use if=/dev/null ratherPaul Eggert
than :|. Problem reported by Dan Jacobson. Use "seek=2GiB" rather than the wordier "seek=`echo '2^31'|bc`". Say "KiB" not the (inaccurate) "kilobytes". Similarly for "GiB" and "gigabytes".
2004-11-20(dd invocation): Add noctty flag to dd.Paul Eggert
2004-11-16(General output formatting): -x doesn't havePaul Eggert
an operand. (Formatting the file names): Warn that even with -N unprintable chars are still printed as '?' some times. (rm invocation): Reword rm -d to note that it's sometimes useful on non-directories. (logname invocation, users invocation, who invocation): The utmp and wtmp file names vary from system to system.
2004-11-16(dd invocation): Reword the new dd message.Paul Eggert
2004-11-15(dd invocation): dd now outputs total bytes,Paul Eggert
seconds, and bytes per second.
2004-10-29Document TZ better, and adjust to new getdate.texi.Paul Eggert
(Top): Update menu. (pr invocation, Formatting file timestamps, touch invocation, stat invocation, who invocation, date invocation, Options for date): Mention TZ.
2004-10-28(Standards conformance): Use "head -10" rather than "head -1" asPaul Eggert
example of obsolete usage, since the POSIX consensus is that "head -1" could be supported even if we don't yet have clear consensus on "head -10". See today's revision to the SUS FAQ <http://www.opengroup.org/austin/papers/single_unix_faq.html>.
2004-10-25(pathchk invocation): Options must precede operands.Paul Eggert
2004-10-18(pathchk invocation): Overall lengths arePaul Eggert
OS limits, not file system limits. Component length checks apply to all components, not merely to existing ones. Say that nonexistent names are not errors. For -p, omit all checks based on the underlying file system, not merely length checks. Explain what the portabile file name character set is.
2004-10-15(printf invocation): Mention ISO/IEC 10646 asPaul Eggert
well as Unicode. Various minor formatting cleanups.
2004-10-13(sort invocation): Move LC_ALL, LC_COLLATEPaul Eggert
index entries to proper paragraph.
2004-10-11Add missing .Paul Eggert
2004-10-11(Special built-in utilities): New node.Paul Eggert
(printf invocation): builtin -> built-in, for consistency with POSIX terminology. (test invocation, pwd invocation): Use specific rather than generic language to warn about built-in commands. (chroot invocation, env invocation, nice invocation, nohup invocation): Warn that command must not be a special built-in. (env invocation): Warn about environment variables with unusual spellings, or duplicates.
2004-09-26(ls invocation): Document "ls --hide".Paul Eggert
2004-09-24(chmod invocation): Warn about "chmod -w file".Paul Eggert
2004-09-23(tail invocation): Fix bugs in the description ofPaul Eggert
the obsolete syntax (e.g., it does not support -k or -m). Warn about usages like "tail -" and "tail -c 4" that are ambigous on older systems.
2004-09-21(mv invocation, rm invocation): Say "the responsePaul Eggert
is affirmative" rather than "the response begins with y or Y".
2004-09-19(dd invocation): Distinguish between optionsPaul Eggert
(e.g., --help) and operands (e.g., if=file). Move miscellaneous stuff after the operand descriptions, for clarity.
2004-09-09(test invocation): Document -r, -w, -x more carefully.Paul Eggert
2004-09-09(sort invocation): -u disables the last-resortPaul Eggert
comparison, too. Revamp its description.
2004-09-09(test invocation): Mention that -h and -L don't dereference symlinks.Paul Eggert
2004-09-09(test invocation): Use better synopses.Paul Eggert
2004-09-09(Common options): Some programs don't reorderPaul Eggert
options. (tr invocation, echo invocation, printf invocation, test invocation, expr invocation, basename invocation, chroot invocation, nice invocation, nohup invocation, seq invocation): This program doesn't reorder options. (tr invocation): Mention --help, --version, --. (echo invocation): Mention that -- isn't special. (test invocation): Mention that the expression is optional, and that test ! EXPR is like ! test EXPR. (expr invocation): Mention --help, --version.
2004-09-08(sort invocation): Add remarks about sort -u versus sort | uniq.Paul Eggert
Prompted by a question from Andrew Noymer.
2004-09-06(od invocation): Several changes for POSIXPaul Eggert
and FreeBSD compatibility. Add support for XSI syntax (POSIX 1003.1-2004). Rename -s[N] to -S N. Remove documentation for -h. -i is now -t dI (not d2) and -l is now -t dL (not d4).
2004-09-06(String tests): Improve quality of warning aboutPaul Eggert
quoting strings for the shell.
2004-09-03(dd invocation): Specify which conversion optionsPaul Eggert
are mutually exclusive. Give a bit more detail about ascii, ebcdic, and ibm conversions.
2004-08-24Standardize on "tab stop" (the POSIX usage)Paul Eggert
rather than "tabstop". (unexpand invocation): Use "blank" rather than "space" when POSIX requires "blank". Define "blank". Initial blanks are converted even if there's just one. For -a, convert two or more blanks only if they occur just before a tab stop.
2004-08-19(chown invocation): Fix synopsis:Paul Eggert
group must always be preceded by separator. "chown : file" and "chown '' file" don't change the owner or group. Update the explanation of what happens to the set-user-ID or set-group-ID bits, e.g., they sometimes are not cleared if they denote mandatory locking. Change "find"-oriented examples to use chown -h.
2004-08-18(printf invocation): Clarify how "printf" isPaul Eggert
supposed to work with extra arguments, missing arguments, etc.
2004-08-10(Common options): Clarify that "-" meansPaul Eggert
stdin/stdout only when it is an operand, not when it is an option-argument. (shred invocation): "shred -- -" is equivalent to "shred -", not to "shred ./-". (tee invocation): "tee -" means to copy (again) to stdout.
2004-07-26(nice invocation): Document the "nice value", andPaul Eggert
how it affects the scheduling priority. (The old documentation implied that the nice value equaled the scheduling priority, which isn't accurate.) Document that the range of nice values might exceed -20..19. Specify what happens when you give a nice value that is out of range, or when you don't have permissions to lower the nice value. Bash doesn't have a builtin 'nice', so don't say "most shells" have one.
2004-07-23(tail invocation): "size has remained the same"Paul Eggert
-> "file has not changed", which is more accurate for fifos.
2004-07-22(tail invocation): Do not ignore -f forPaul Eggert
all pipes, just for when standard input is a pipe and no file operand is specified.
2004-07-06(readlink invocation): Document newJim Meyering
"readlink -f" behaviour and new canonicalize options, -e and -m.
2004-07-02(Common options, Target directory, cp invocation,Jim Meyering
install invocation, mv invocation, ln invocation): Add -t as a short option for --target-directory, and -T as a short option for --no-target-directory. Clean up relevant synopses a bit, so that the language is similar for all.