summaryrefslogtreecommitdiff
path: root/doc/coreutils.texi
AgeCommit message (Collapse)Author
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.
2007-01-24* NEWS: New option sort -C, proposed by XCU ERN 127, which looksPaul Eggert
like it will be approved. Also add --check=quiet, --check=silent as long aliases, and --check=diagnose-first as an alias for -c. * doc/coreutils.texi (sort invocation): Document this. Also, mention that sort -c can take at most one file. * src/sort.c: Implement this. Include argmatch.h. (usage): Document the change. (CHECK_OPTION): New constant. (long_options): --check now takes an optional argument, and is now treated differently from 'c'. (check_args, check_types): New constant arrays. (check): New arg CHECKONLY, which suppresses diagnostic if -C. (main): Parse the new options. * tests/sort/Test.pm (02d, 02d, incompat5, incompat6): New tests for -C.
2007-01-24* src/sort.c (MAX_FORK_RETRIES_COMPRESS, MAX_FORK_RETRIES_DECOMPRESS):Dan Hipschman
In pipe_fork callers, use these named constants, not "2" and "8". (proctab, nprocs): Declare to be "static". (pipe_fork) [lint]: Initialize local, pid, to avoid unwarranted may-be-used-uninitialized warning. (create_temp): Use the active voice. Describe parameters, too. 2007-01-21 James Youngman <jay@gnu.org> Centralize all the uses of sigprocmask(). Don't restore an invalid saved mask. * src/sort.c (enter_cs, leave_cs): New functions for protecting code sequences against signal delivery. * (exit_cleanup): Use enter_cs and leave_cs instead of calling sigprocmask directly. (create_temp_file, pipe_fork, zaptemp): Likewise 2007-01-21 Dan Hipschman <dsh@linux.ucla.edu> Add compression of temp files to sort. * NEWS: Mention this. * bootstrap.conf: Import findprog. * configure.ac: Add AC_FUNC_FORK. * doc/coreutils.texi: Document GNUSORT_COMPRESSOR environment variable. * src/sort.c (compress_program): New global, holds the name of the external compression program. (struct sortfile): New type used by mergepfs and friends instead of filenames to hold PIDs of compressor processes. (proctab): New global, holds compressor PIDs on which to wait. (enum procstate, struct procnode): New types used by proctab. (proctab_hasher, proctab_comparator): New functions for proctab. (nprocs): New global, number of forked but unreaped children. (reap, reap_some): New function, wait for/cleanup forked processes. (register_proc, update_proc, wait_proc): New functions for adding, modifying and removing proctab entries. (create_temp_file): Change parameter type to pointer to file descriptor, and return type to pointer to struct tempnode. (dup2_or_die): New function used in create_temp and open_temp. (pipe_fork): New function, creates a pipe and child process. (create_temp): Creates a temp file and possibly a compression program to which we filter output. (open_temp): Opens a compressed temp file and creates a decompression process through which to filter the input. (mergefps): Change FILES parameter type to struct sortfile array and update access accordingly. Use open_temp and reap_some. (avoid_trashing_input, merge): Change FILES parameter like mergefps and call create_temp instead of create_temp_file. (sort): Call create_temp instead of create_temp_file. Use reap_some. (avoid_trashing_input, merge, sort, main): Adapt to mergefps.
2007-01-19* coreutils.texi (ls: General output formatting): Mention theJim Meyering
workarounds to accommodate the Apple Terminal bug.
2007-01-04[ChangeLog]Jim Meyering
When decoding, always allow newlines in input, with almost no performance impact. * src/base64.c (do_decode): Initialize decode context. Call base64_decode one more time, after all input is processed. (usage): When decoding, newlines are always accepted. * tests/misc/base64: Add a bunch of tests, for the above. * gl/lib/base64.c: Include <string.h>. (base64_decode_ctx_init, get_4, decode_4): New functions. (base64_decode): Efficiently handle interspersed newlines. (base64_decode_alloc): Update signature. * gl/lib/base64.h (struct base64_decode_context): Define. (base64_decode_ctx_init): Add prototype. (base64_decode, base64_decode_alloc): Update prototypes. [doc/ChangeLog] * coreutils.texi (base64 invocation): When decoding, newlines are always accepted.
2007-01-03[oops] Document what the ".0" in e.g., "-k 2,3.0" means, and...Evan Hunt
* coreutils.texi (sort invocation): ... that it can be applied to the field-end spec, but not the field-start one. Patch from Evan Hunt. Signed-off-by: Jim Meyering <jim@meyering.net>
2006-12-22* NEWS: dd bs= operands now silently override later ibs= and obs=,Paul Eggert
as POSIX requires. * src/dd.c (scanargs): Implement it. * tests/dd/misc (outbytes): Test it. * doc/coreutils.texi (dd invocation): Specify that bs=N overrides later ibs and obs, undoing part of the previous change. (The behavior was wrong.)
2006-12-21* coreutils.texi (dd invocation): Specify that bs=N overrides only anyJim Meyering
_preceding_ ibs and obs settings. Spotted by Andreas Schwab.
2006-12-21* coreutils.texi (dd invocation): Add to the description of cbs.Jim Meyering
2006-12-21* coreutils.texi (dd invocation): Improve the documentationJim Meyering
for bs, ibs, obs, and cbs. Suggestion from Dan Jacobson. Patch by Olivier Delhomme.
2006-12-14chgrp, chown: Don't prohibit -RLh, aka -RL with --no-dereference.Jim Meyering
* src/chgrp.c (main): Don't prohibit -RLh, aka -RL with --no-dereference. * src/chown.c (main): Likewise. * src/chown-core.c (change_file_owner): Add to a comment. * tests/chown/preserve-root: Add tests. * doc/coreutils.texi (Treating / specially): With --preserve-root, chgrp and chown will not modify "/", even through a symlink.
2006-12-14* coreutils.texi: Remove two doubled words.Jim Meyering
2006-10-28* coreutils.texi (wc invocation): When giving the order in whichJim Meyering
the various "counts" are listed, also mention "maximum line length". Prompted by a report from Vincent LeFevre.
2006-10-25new feature: rm accepts new option: --one-file-systemJim Meyering
Suggested by Steve McIntyre in <http://bugs.debian.org/392925>. * src/remove.h (struct rm_options) [one_file_system]: New member. * src/rm.c (rm_option_init): Initialize it. (usage): Document the option. * src/mv.c (rm_option_init): Likewise. * src/remove.c (remove_dir): With --one-file-system and --recursive, for each directory command line argument, do not affect a file system different from that of the starting directory. And give a diagnostic. * src/rm.c (ONE_FILE_SYSTEM): New enum. (main): Handle new option. * tests/rm/one-file-system: Test the above. * tests/rm/Makefile.am (TESTS): Add one-file-system. * tests/Makefile.am (check-root): Add the rm/one-file-system test to the list. (EXTRA_DIST): Add other-fs-tmpdir. * tests/mv/setup: Removed. Renamed to... * tests/other-fs-tmpdir: ...this new file. * tests/mv/Makefile.am (EXTRA_DIST): Remove setup. * tests/mv/acl: Reflect renaming: use ../other-fs-tmpdir. * tests/mv/backup-is-src: Likewise. * tests/mv/hard-link-1: Likewise. * tests/mv/leak-fd: Likewise. * tests/mv/mv-special-1: Likewise. * tests/mv/part-fail: Likewise. * tests/mv/part-hardlink: Likewise. * tests/mv/part-rename: Likewise. * tests/mv/part-symlink: Likewise. * tests/mv/partition-perm: Likewise. * tests/mv/to-symlink: Likewise. * tests/mv/into-self-2: Likewise. [doc/ChangeLog] * coreutils.texi (rm invocation): Describe --one-file-system.
2006-09-26[ChangeLog]Paul Eggert
* NEWS: "groups user" no longer outputs "user :"; you need at least two users. "groups" now processes options like --help more compatibly. * src/groups.sh: Implement the option-processing change. Handle user and group names with special characters more robustly. Report write errors instead of exiting silently with status 1. [doc/ChangeLog] * coreutils.texi (groups invocation): "groups" no longer prefixes the output with "user :" unless more than one user is specified.
2006-09-19* coreutils.texi (Disk usage): Clarify intro. Problem reported by Van Ly.Paul Eggert
2006-09-19(cp invocation): Clarify cp -i a bit more.Paul Eggert
2006-09-19* coreutils.texi (cp invocation): Say that -i and -f arePaul Eggert
independent. Clarify -i's behavior.
2006-09-08tail now ignores the -f option if POSIXLY_CORRECT is set,Paul Eggert
no file operand is given, and standard input is any FIFO.
2006-09-03(Treating / specially): --preserve-root isPaul Eggert
now the default for rm. (rm invocation): Likewise. Also, document that you can't remove `.' or `..'. Use the POSIX term "root directory" rather than the more-ambiguous "file system root".
2006-08-17Add/fix copyright notices and adjust to latest GNU FDL.Paul Eggert
2006-08-15* NEWS: Mention that df exits with nonzero status if it generatesPaul Eggert
no output. This change was in 6.0 but inadvertently unmentioned. * doc/coreutils.texi (df invocation): df exits nonzero if it outpus nothing. * src/df.c (file_systems_processed): Renamed from n_valid_args, and now a boolean. (show_dev): Don't set it until we actually output something. Print the header if this is the first output. (main): Don't print a header, as that is now show_dev's job. * tests/misc/Makefile.am (TESTS): Add df. * tests/misc/df: New file.
2006-08-09Warn about oflag=append without conv=notrunc.Paul Eggert
2006-08-08(shuf invocation, Random sources): New sections.Paul Eggert
(Operating on sorted files): Add shuf. (sort invocation, shred invocation): New option --random-source. (sort invocation): Fix typo: -R -> -r.
2006-07-28(install invocation, mkdir invocation):Paul Eggert
Add cross-references to Directory Setuid and Setgid. (install-invocation): The default mode is no longer equivalent to 755.
2006-07-26* src/ls.c (print_color_indicator): Test for S_IFREG first, ratherJim Meyering
than having the code test for all of the other types first. Hoist the set-uid/gid-testing code "up" into this new block. Classify any other type of file (e.g., S_TYPEISSHM, etc.) as C_ORPHAN, not as C_FILE. * doc/coreutils.texi (What information is listed): Mention that missing pieces of information are marked with "?". From Paul Eggert.
2006-07-23(Mode Structure, Symbolic Modes, Numeric Modes): Be more carefulPaul Eggert
about distinguishing file mode bits from permissions bits, and about execute versus search permission. The FreeBSD command is chflags, not chrflags.
2006-07-22(What information is listed): Clarify that the restricted deletionPaul Eggert
flag is another name for the sticky bit.
2006-07-17Change GNU to @acronym{GNU} in a few places.Paul Eggert
Use "set-user-ID" and "set-group-ID" a bit more consistently. Use "appropriate privileges" rather than "super-user" a bit more consistently. (install invocation): Parent directories are now 755 without uid or gid changing. The default mode is now 0755, not 755. (mkdir invocation): Rewrite the top-level usage description, since I couldn't easily follow the old one. It's now 3 lines not 8. For -m, describe file permission bits versus other bits, and note that mkdir is atomic if you don't mention special bits. (chmod invocation): Mention what chmod does to setgid and setuid bits.
2006-07-08* coreutils.texi (Squeezing): Separate doubled "the", so typo-checkersJim Meyering
don't complain.
2006-07-08* coreutils.texi: Fix some typos. Use `zeros' consistently (bothJim Meyering
`zeros' and `zeroes' are correct).
2006-07-01(tail invocation): With no operand, 'tail -f' nowPaul Eggert
silently ignores the '-f' only if standard input is a FIFO or pipe and POSIXLY_CORRECT is set.
2006-07-01(seq invocation): seq now uses long doublePaul Eggert
internally rather than double. It now defaults to a minimal fixed point format if possible. It lets you use %a, %A, %E, %F, %G. Don't assume printf doesn't work for numbers that fit in 64 but not 32 bits; typically they work these days. Improve discussion of large integers and update the rounding-error numbers.
2006-06-28(sort invocation): 'sort +1 -2' is now supportedPaul Eggert
even when conforming to POSIX 1003.1-2001, since this is a pure extension to POSIX.
2006-06-27* coreutils.texi (wc invocation): Remove ./ prefix from example.Jim Meyering
From Padraig Brady.
2006-06-26* coreutils.texi (wc invocation): Spell out `--files0-from' inJim Meyering
the example. Suggestion from Bob Proulx.
2006-06-26* coreutils.texi (wc invocation): Document new --files0-from option.Jim Meyering
2006-06-25(sleep invocation): Document that acceptingJim Meyering
multiple arguments and suffixes are extensions. Reported by Dan Jacobson.
2006-05-25Remove mention of --seed.Paul Eggert
2006-05-04(Examples of date): Give example of @seconds.Jim Meyering