summaryrefslogtreecommitdiff
path: root/doc/coreutils.texi
AgeCommit message (Collapse)Author
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.
2004-07-02Put the right amount of space at sentence ends.Jim Meyering
Make sure "i.e." and "e.g." are followed by commas (the GNU style). Put blank lines before and after every @example, prefer the previous line to end in ":" (when not a sentence end, for consistency), and prepend @noindent to the following line when appropriate. In examples, use "--" arguments when needed to prevent undesired interpretation of operands as options. Use "file name" rather than "filename", as per the GNU coding standards. Remove unwanted spaces before @footnote. Use "---" when appropriate, instead of " -- ". Use "name" (or something like that) rather than "path" or "pathname", since the GNU coding standards don't allow "path". Use @acronym, @command, @minus{}, @samp in a few places, where appropriate. (Target directory): Clarify description of example. (fmt invocation): Give issue number for reference, and reword for clarity. (sort invocation): Note that xargs without -0 also mishandles file names containing some special characters other than newline. (Translating): Mention that \012 is not universally portable. Use '\0' rather than '\000'. (Squeezing): bourne -> Bourne. Fix unportable usage of '\n' by replacing it with '[\n*]'. (More details about version sort): Remove unnecessary indent in examples. (dd invocation): Use 'kill -s USR1', not 'kill -USR1', as POSIX indicates that the former is more portable (the latter is an XSI extension). (shred invocation): Use @uref rather than @url, and use a more-typical style for the date. (kill invocation): Clarify usage; for example, "kill -s TERM -1" isn't allowed. (seq invocation): Reword to avoid implying that printf necessarily fails for numbers outside the 32-bit range. Prefer separating options from their operands. (Opening the software toolbox): Give an online reference to Robbins's article, and give a date. Don't imply that the current documentation is unchanged from his article. (Putting the tools together): Rework examples so that they don't assume the C locale; nowadays many users now operate outside the C locale by default. While we're at it, don't assume ASCII either. Indent example to match actual output from GNU uniq. Remove some unnecessary and confusing brackets from 'tr' operands. "Software Tools in Pascal" is back in print, according to Amazon anyway. Add references to Kernighan's online copies of examples.
2004-06-30Standardize on "file system" ratherJim Meyering
than "filesystem", as POSIX prefers it with a space.
2004-06-30(Common options, Target directory, cpJim Meyering
invocation, install invocation, mv invocation, ln invocation): Likewise. (link invocation): Explain how to rewrite link using ln now that we have --no-target-directory. (ln invocation): Explain that --no-target-directory subsumes --no-dereference. (unlink invocation): Modify wording to match new wording in link invocation.
2004-06-29(install invocation): Document --target-directory in synopsis, too.Jim Meyering
2004-06-17(yes invocation): "--" is now supported.Jim Meyering
(false invocation, true invocation): --help and --version now work unconditionally.
2004-06-15Remove special cases for POSIXLY_CORRECT when POSIX allows the GNU behavior.Jim Meyering
(pr invocation, unlink invocation): Document this.
2004-06-07Remove menu references to just-removed subsection.Jim Meyering
2004-06-06(tr invocation): Remove the section describingJim Meyering
how POSIXLY_CORRECT changes tr's behavior.
2004-06-02(cut invocation): Clarify what --output-delimiter=STRJim Meyering
does with byte/character ranges.
2004-06-02(tr invocation): Mention -C.Jim Meyering
2004-06-01Add some index references for POSIXLY_CORRECT.Jim Meyering
(echo invocation): Document today's changes.
2004-05-17chgrp and chown now dereference symlinks by default, per POSIX.Jim Meyering
(chgrp invocation, chown invocation): Document it.
2004-05-14(sort invocation): Document that "sort -m -o F"Jim Meyering
might write F before reading all the input.
2004-05-09(stat invocation): Change IO to I/O.Jim Meyering
2004-04-26(sort invocation): Mention -k earlier, soJim Meyering
that the options are in alphabetical order. Describe how -b works more-accurately; this involves fixing some examples, too. Mention what happens if the start field falls after an end field or after a line end. Warn about using -k without -b, -g, -M, -n, or -t. Add an example of how to sort IPv4 addresses and Apache Common Log Format dates. Remove a duplicate example. (Putting the tools together): Use separate options rather than agglomerating them.
2004-04-12(mv invocation): Document this.Jim Meyering
(cp invocation): Document -u (it was missing!) with new behavior.
2004-04-08Remove noctty flag from dd.Jim Meyering
2004-04-08New dd conv= symbols nocreat, excl, fdatasync, fsync,Jim Meyering
and new dd options iflag= and oflag=. (dd invocation): Document them.
2004-04-07(stty invocation - Input): Document new iutf8 option.Jim Meyering
2004-04-04(stat invocation): Correct --format description.Jim Meyering
2004-03-24(Block size): Document new envvar BLOCKSIZE.Jim Meyering
2004-03-24Use @sc{nul} consistently for NUL.Jim Meyering
(du invocation): FILE0 -> FILE.
2004-03-23(du invocation): --files0-from is useful withJim Meyering
--total (-c), not with --summarize.
2004-03-22Tweak a few lines that resulted in `overfull hbox' warnings.Jim Meyering
2004-03-21(du invocation): Document new option: --file0-from=F.Jim Meyering
2004-03-17(touch invocation):Jim Meyering
Describe use of fractional seconds. (date invocation, Options for date): Likewise. (date invocation): Mention effect of LC_TIME. (Options for date): Describe new --iso-8601=ns option.
2004-03-15(date invocation): Add missing `C' to %[...] rangeJim Meyering
in the `Date directives:: ...' menu entry. From Bob Proulx.
2004-03-15Add FIXME comment:Jim Meyering
The following don't have `invocation' nodes: [, pinky, shasum, uptime
2004-03-10(Sorting the output): Remove description ofJim Meyering
ls's --sort=directory option. ls doesn't accept that option, yet.
2004-03-10(cp invocation): Improve description of cp's --sparse=WHEN option.Jim Meyering
2004-03-10(nl invocation): Specify that these are _basic_Jim Meyering
regular expressions (BRE), and add a link to grep's documentation.
2004-03-03(chown invocation): Document that chown now fallsJim Meyering
back on USER.GROUP parsing regardless of POSIX version, as POSIX 1003.1-2001 allows that behavior as a compatible extension.
2004-02-22tweak wording of last changeJim Meyering
2004-02-22(du invocation): Mention that using du's -H option currently evokes a warning.Jim Meyering
2004-02-21(expr invocation):Jim Meyering
Document what forms integers may take, and say "integer" consistently instead of "number". Warn about operands that "expr" can misinterpret, and how to work around the problem.
2004-02-17(csplit invocation): Correct typo s/LINE/N/Jim Meyering
in description of `N' pattern.
2004-02-11(Formatting the file names):Jim Meyering
Improve wording for --quoting-style documentation. Suggestions by Bruno Haible.
2004-02-11revert unrelated (ls --quoting-style) part of last changeJim Meyering
2004-02-11(Time directives): The %s value *is* changed by theJim Meyering
--date=DATE option; don't say otherwise. Patch from Padraig Brady.
2004-02-09Hyphenate `three-column' when used as an adjective.Jim Meyering
2004-02-02(nice invocation): Add examples.Jim Meyering
Prompted by suggestion from Dan Jacobson. (factor invocation): Add an example. Update timing numbers for a more modern CPU.
2004-01-27 Separate `Synopses' section into three examples.Jim Meyering
Clarify first paragraph. @w{}-protect an expression.1 Use @option{--option}, rather than @code{--option}.
2004-01-27(seq invocation): Remove `@dots{}' at end of synopsis.Jim Meyering
2004-01-22(Exit status): Document that ordinary failureJim Meyering
might not exit with status 1 on unusual platforms. Mention chroot, env, nice, and su as having unusual exit status patterns. Don't bother to mention true and false since their exit status patterns are actually normal. (sort invocation, su invocation): Mention its unusual exit status pattern. (chroot invocation): Simplify description of exit status 1. Remove duplicate description of status 127. (env invocation): Use consistent tenses; simplifiy description of status 1. (nice invocation): Likewise.
2004-01-16(touch invocation): touch -r and -d can nowJim Meyering
both be specified, with -r specifying the origin for -d.