summaryrefslogtreecommitdiff
path: root/doc
AgeCommit message (Collapse)Author
2008-02-07mkdir, split: write --verbose output to stdout, not stderr.Steven Schubiger
* src/mkdir.c (verbose_output): New function. (announce_mkdir): Use it. * src/split.c (usage): Update. * src/split.c (cwrite): Write to stdout, not stderr. * doc/coreutils.texi (split invocation): Remove the mention of --verbose output being printed to stderr. * tests/mkdir/p-v: Redirect stdout, not stderr. * tests/misc/split-a: Likewise. * NEWS: Mention this change. * TODO: Remove this item.
2008-01-29Improve the description of when dd outputs its final statistics.Michael Stone
* doc/coreutils.texi (dd invocation): Say that dd prints stats upon normal termination and upon SIGINT. Signed-off-by: Jim Meyering <meyering@redhat.com>
2008-01-26Improve a warning about non-portable "mv" usage.Jim Meyering
* doc/coreutils.texi (mv invocation): Adjust the warning: moving a dir-symlink-specified-with-a-trailing-slash works in a surprising manner only on some systems. Reported by Tomas Pospisek in http://bugs.debian.org/343652.
2008-01-02Update copyright date.Jim Meyering
* tests/sample-test: Likewise. * doc/coreutils.texi: Likewise. Signed-off-by: Jim Meyering <meyering@redhat.com>
2007-12-31Add a syntax check, so this doesn't recur. Reorganize existing checks.Jim Meyering
* doc/Makefile.am (sc-exponent-grouping): (syntax_checks): New variable. (sc-avoid-io, sc-avoid-non-zero, sc-avoid-timezone): (sc-avoid-zeroes, sc-use-small-caps-NUL): New rules, extracted from check-texinfo. (check-texinfo): Depend on $(syntax_checks).
2007-12-31doc: Put braces around multi-digit exponents.Jim Meyering
Reported by Darrel Francis.
2007-12-21doc/coreutils.texi: Fix a typo. Avoid the term `relationals'.Ralf Wildenhues
2007-11-25Document install's -D option.Jim Meyering
* doc/coreutils.texi (install invocation): Document -D. Reported by Akim Demialle.
2007-11-22cp: by default, refuse to copy through a dangling destination symlinkJim Meyering
* NEWS: Mention this change. * doc/coreutils.texi (cp invocation): Describe the new behavior. * src/copy.c: No longer include "canonicalize.h". (copy_reg): Upon failure to open a dangling destination symlink, don't canonicalize the name, but rather fail (default) or, with POSIXLY_CORRECT, repeat the open call without O_EXCL (potentially dangerous). * src/copy.h (struct cp_options) [open_dangling_dest_symlink]: New member. Reorder the others, grouping "bool" and "enum" members together. * tests/cp/thru-dangling: Test for changed and new behavior. * src/cp.c (cp_option_init): Initialize new member. * src/install.c (cp_option_init): Likewise. * src/mv.c (cp_option_init): Likewise. Signed-off-by: Jim Meyering <meyering@redhat.com>
2007-11-21Improve the descriptions of the split command options.Pádraig Brady
* doc/coreutils.texi (split invocation):
2007-11-13Likewise for description of cp -a in doc/coreutils.texi: s/-dpPR/-dpR/.Benno Schulenberg
2007-11-01Add example inspired by "make dist" running gzip and lzma in sequence.Jim Meyering
* doc/coreutils.texi (tee invocation): Show how to run tar just once, compressing the tee'd output streams in parallel.
2007-11-01Say that the first process substitution example is contrived.Jim Meyering
* doc/coreutils.texi (tee invocation): ... and show how to do it properly. Pointed out by James Antill.
2007-10-20* doc/coreutils.texi: Add a cross-reference to bashref's Process ↵Jim Meyering
Substitution node.
2007-10-20* doc/coreutils.texi (tee invocation): Fix typo. Add a little.Jim Meyering
2007-10-16Show how to make tee redirect to multiple processes.Jim Meyering
2007-10-05List two systems on which chroot works when run by non-root.Jim Meyering
2007-09-27Make "Date input formats" easier to find in info filePádraig Brady
* doc/coreutils.texi (date invocation): `man date` gives all options for the date command except the description of the date input formats. Therefore it should be easy to browse to this info using `info date`. Signed-off-by: Pádraig Brady <P@draigBrady.com>
2007-09-19Fix typo in previous change.Jim Meyering
Spotted by Andreas Schwab.
2007-09-19* coreutils.texi (expr invocation): Correct description of relativeJim Meyering
operator precedence. Reported by hanpingtian@gmail.com.
2007-08-26Avoid case-insensitive clash in one-page-per-node html docs.Eric Blake
* coreutils.texi (Concept index): Rename from Index.
2007-08-25Remove all .cvsignore files from version control.Jim Meyering
2007-08-21Clarify touch documentation of file arguments.Bob Proulx
* src/touch.c (usage): Improve wording of documentation regarding file argument handling and special handling of - argument. * doc/coreutils.texi (touch invocation): Likewise. Documentation problem reported by Vincent Lefevre.
2007-07-23Update all copyright notices to use the newer form.Jim Meyering
2007-07-15* coreutils.texi: Revise node structure per new fdl.texi.Jim Meyering
2007-07-10New program: archKarel Zak
* NEWS: Mention arch. * README: Add arch to the list of programs. * AUTHORS: Add arch. * src/uname.c: Include "uname.h". (PROGRAM_NAME): Handle arch, too. (ARCH_AUTHORS): Define. (uname_long_options, arch_long_options): Renamed and new globals. (usage): Handle arch-mode as well as uname-mode. (decode_switches): New function, extracted from main, to handle arch-mode as well as uname-mode. (main): Handle both modes. * src/uname-arch.c: New program, alias for "uname -m". * src/uname-uname.c: New file, default uname mode. * src/uname.h: New file, uname modes. * src/Makefile.am (EXTRA_PROGRAMS): Add arch. (uname_SOURCES, arch_SOURCES): Define. * man/arch.x: New file. * man/Makefile.am (dist_man_MANS): Add arch.1. (arch.1): New dependency. * tests/misc/arch: New test, compare "arch" with "uname -m" * configure.ac (OPTIONAL_BIN_PROGS): Add arch. (MAN): Add arch.1. * .x-sc_require_config_h: Exempt uname-arch.c and uname-uname.c from the always-include-<config.h> rule. Signed-off-by: Karel Zak <kzak@redhat.com> Signed-off-by: Jim Meyering <jim@meyering.net>
2007-07-10Change "version 2" to "version 3" in all copyright notices.Jim Meyering
2007-07-04pr -F no longer suppresses the footer or the first two blank header linesPaul Eggert
Here's a patch along the lines of <http://thread.gmane.org/gmane.comp.gnu.coreutils.bugs/10849/focus=10857>. It's a bit large since it changes the test cases to match the behavior, and the test cases' file names depend on the behavior! * NEWS: pr -F no longer suppresses the footer or the first two blank lines in the header. * doc/coreutils.texi (pr invocation): Likewise. Also, a too-short page length implies -t, not -T. * src/pr.c (lines_per_header, lines_per_footer): Now constants. (init_parameters): Don't try to change them. (print_header): Use the same header and footer format regardless of wither form feeds are being used. (usage): Adjust to above change when describing too-short page length. Too-short page length impliesy -t, not -T. * tests/pr/2-S_f-t_notab: Adjust to the fact that -F now affects only formfeed handling; it does not change the header. * tests/pr/2-Sf-t_notab: Likewise. ... * tests/pr/3-5l17f-t: Remove, since it's been renamed to another file whose name has a line count 7 larger, reflecting the new line count needed for this behavior. * tests/pr/3a3l8f-t: Likewise. ... * tests/pr/w72l24f-ll: Likewise. Signed-off-by: Jim Meyering <jim@meyering.net>
2007-06-23seq no longer mishandles cases like "seq 0 0.000001 0.000003",Paul Eggert
where it would not print the desired last number. * doc/coreutils.texi (seq invocation): Remove advice about workaround for seq off-by-one problem, since the bug is fixed now. Replace it with more-generic advice about rounding errors. * src/seq.c (long_double_format, print_numbers): New arg NUMERIC_FORMAT. All uses changed.
2007-06-15Correct cp's handling of destination symlinks in some cases.Paul Eggert
* NEWS: "cp" no longer considers a destination symlink to be the same as the referenced file when copying links or making backups. * src/copy.c (copy_reg): When following a symlink, use the followed name in later chown etc. requests, so that the created file is affected, rather than the symlink. Use O_NOFOLLOW on source when not dereferencing symlinks; this avoids a race. Preserve errno correctly when doing multiple open attempts on the destination. (copy_internal): Follow destination symlinks only when copying a regular file and only when we don't intend to remove or rename the destination first, regardless of whether following source symlinks; this is because since POSIX and tradition (e.g., FreeBSD) say we should ordinarily follow destination symlinks if the system calls would ordinarily do so. * src/copy.h (struct cp_options): Add comment that 'dereference' is only for source files. * src/cp.c (usage): Note that --derereference etc. are only for source files. (make_dir_parents_private): Follow symlinks, regardless of whether --dereference is specified, because these are destination symlinks. * tests/cp/same-file: Adjust tests to match revised behavior. Filter out perror output since it might vary from host to host. Use sed alone instead of also using echo. * doc/coreutils.texi (cp invocation): Document the behavior better when the destination is a symlink. Clarify source versus destination symlinks. Describe the new behavior for destination symlinks. 2007-06-15 Jim Meyering <jim@meyering.net> * src/copy.c: Include "canonicalize.h". (copy_reg): Use canonicalize_filename_mode to follow the symlink, so that we can always open with O_EXCL and avoid a race.
2007-06-15Clarify what "cat" documentation means by "blank" lines.Paul Eggert
* doc/coreutils.texi (cat invocation): "Blank" lines actually mean empty lines. * src/cat.c (usage): Say that "nonblank" means nonempty. Clarify --squeeze-blank.
2007-06-06* coreutils.texi (rmdir invocation): Fix a tiny typo.Jim Meyering
2007-06-04doc: -h and --human-readable are equivalent to --block-size=human-readablePaul Eggert
* doc/coreutils.texi (Common options): Mention that -h and --human-readable are equivalent to --block-size=human-readable. Documentation problem reported by Steve Ward in <http://lists.gnu.org/archive/html/bug-coreutils/2007-06/msg00007.html>. (du invocation): Use optSi rather than duplicating the macro's contents (incorrectly, since we claimed a "B" was output).
2007-06-03Remove constants.texi from version control.Jim Meyering
This file has always been generated. * .gitignore: Add constants.texi. Signed-off-by: Jim Meyering <jim@meyering.net>
2007-05-22Check for an up-to-date copyright year in coreutils.texi.Jim Meyering
* Makefile.maint (copyright-check): Also check for an up-to-date copyright year in doc/$().texi, if that file exists. * doc/coreutils.texi: Add 2007 to list of Copyright years. Reported by Karl Berry.
2007-05-13Add -z option to uniq. Originally proposed by Egmont Koblinger.James Youngman
* NEWS: Mention uniq's new option: --zero-terminated (-z). * src/uniq.c: Add new option, --zero-terminated (-z), to make uniq use the NUL byte as separator/delimiter rather than newline. (check_file): Add a parameter: delimiter. Update caller. Use readlinebuffer_delim in place of readlinebuffer everywhere. (main): Handle the new option. (usage): Describe new option the same way sort does. * doc/coreutils.texi (uniq invocation): Describe the new option.
2007-05-03The following commands and options now support the standard sizePaul Eggert
suffixes kB, M, MB, G, GB, and so on for T, P, Y, Z, and Y: head -c, head -n, od -j, od -N, od -S, split -b, split -C, tail -c, tail -n. * doc/coreutils.texi (od invocation, head invocation, tail invocation): Document support for new size suffixes. (head invocation, tail invocation): Document that -n uses the same suffixes as -c. (tail invocation): More-clearly document what leading "+" does. * src/head.c (usage, string_to_integer): Support new suffixes. * src/od.c (usage, main): Likewise. * src/split.c (usage, main): Likewise. * src/tail.c (usage, parse_options): Likewise. Prompted by a patch from Evan Hunt.
2007-04-28* src/nohup.c (usage): Describe how standard input and output are redirected.Paul Eggert
2007-04-16cut synopsis: fix coreutils.texi, too.Jim Meyering
* doc/coreutils.texi (cut invocation): Adjust synopsis to show that an * THANKS: Add Rudolf Kastl. OPTION is required. Reported by Rudolf Kastl.
2007-03-22* coreutils.texi (md5sum invocation): Document escapes in outputEric Blake
format. Reported by Armijn Hemel.
2007-03-16Fix manual in response to bug reports by Dan Jacobson.Paul Eggert
* coreutils.texi (sort invocation): Explain numeric sorts better. Compress self-congratulation into a simple "comparison is exact" notice; the --general-numeric-sort option already explains the tradeoffs. (seq invocation): Add example of -f.
2007-03-12* coreutils.texi (cp invocation): Mention that --preserve=timestampsJim Meyering
doesn't preserve time stamps on symbolic links. Reported by Polo Talnir in <https://bugzilla.redhat.com/230866>.
2007-02-28* doc/coreutils.texi (Common options): --si outputs "M", not "MB".Paul Eggert
Problem reported by Philip Rowlands in <http://lists.gnu.org/archive/html/bug-coreutils/2007-02/msg00283.html>.
2007-02-27Make df -P immune to effects of e.g., the BLOCK_SIZE envvar.Paul Eggert
* NEWS: With -P, the default block size and output format is not affected by DF_BLOCK_SIZE, BLOCK_SIZE, or BLOCKSIZE. * src/df.c (main): Implement this. * doc/coreutils.texi (df invocation): With -P, the default block size and output format is not affected by DF_BLOCK_SIZE, BLOCK_SIZE, or BLOCKSIZE.
2007-02-24* NEWS: sort no longer compresses temporaries by default.Paul Eggert
* bootstrap.conf: Remove findprog. * doc/coreutils.texi (sort invocation): The default is to not compress. Don't treat "" specially. * src/sort.c: Don't include findprog.h. (create_temp): Compress only if the user specified --compress-program. * tests/misc/sort-compress: Adjusts tests to match new behavior.
2007-02-22Honor dd's noatime flag if possible, even if not supported on build fsPaul Eggert
* doc/coreutils.texi (dd invocation): Warn that noatime might not be reliable. * src/dd.c (flags, usage): Look at O_NOATIME, not HAVE_WORKING_O_NOATIME, to decide whether to support the noatime flag, so that dd attempts O_NOATIME even if the build file system does not support it. Problem reported by Jim Meyering today in bug-coreutils. * tests/dd/misc: Generate a warning, not a failure, if noatime exists but fails.
2007-02-19* NEWS: sort now uses a --compress-program option rather thanPaul Eggert
an environment variable. * doc/coreutils.texi (sort invocation): Document this. * src/sort.c (usage): Likewise. (COMPRESS_PROGRAM_OPTION): New const. (long_options, create_temp, main): Support new option. * tests/misc/sort-compress: Test it.
2007-01-30* coreutils.texi: @item -> @itemx to fix some typos.Paul Eggert
2007-01-30* coreutils.texi (mkdir invocation): Say how to set the filePaul Eggert
permission bits of a parent directory with mkdir -p.
2007-01-29Document new syntax: "chown +0:+287 file", "chgrp +99 file"Jim Meyering
* coreutils.texi (Disambiguating names and IDs): New section. (chown invocation, chgrp invocation): Mention the new syntax with an xref to the new section.