From a35c2e1b9ea4b200d417d694d319c523da2a602a Mon Sep 17 00:00:00 2001 From: Leah Neukirchen Date: Thu, 12 Oct 2017 15:05:32 +0200 Subject: README.md: link to manpage instead of duplicating content --- README.md | 55 ++----------------------------------------------------- 1 file changed, 2 insertions(+), 53 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index 6f48be7..977ce92 100644 --- a/README.md +++ b/README.md @@ -14,65 +14,14 @@ Over xargs: * Can also take arguments from command-line. * No shell involved unless `-s` is used. * `{}` replacing possible with multiple arguments. +* Support for patterns to run different commands depending on the argument. Over apply: * Parallel mode. * Sane argument splitting. * Can use shell-syntax instead of escape characters. -## Usage: - - xe [-0FLRnv] [-I arg] [-N maxargs] [-j maxjobs] COMMAND... - | -f ARGFILE COMMAND... - | -s SHELLSCRIPT - | -a COMMAND... -- ARGS... - | -A ARGSEP COMMAND... ARGSEP ARGS... - -* `-0`: input filenames are separated by NUL bytes (default: newlines). -* `-F`: fatal: stop after first failing command. -* `-L`: run the commands with line-buffered output; lines from two jobs - will not interleave. -* `-LL`: prefix each line with the job id in such a manner that the - output can be piped to `sort -snk1` to group it by job. -* `-R`: return with status 122 when no arguments have been passed. -* `-n`: don't run the commands, just print them. -* `-v`: print commands to standard error before running them. -* `-vv`: print job id and exit status for each command. -* `-I`: replace occurrences of *arg* with the argument(s) (default: `{}`). - Use an empty *arg* to disable the replace function. -* `-N`: pass up to *maxargs* arguments to each COMMAND (default: 1). - `-N0` will pass as many arguments as possible. -* `-j`: run up to *maxjobs* processes concurrently. - `-j0` will run as many processes as there are CPU cores running. - `-j2x` will run twice as many processes as there are CPU cores running. -* `COMMAND...`: default operation: each command line argument is - passed as-is, `{}` is replaced by the argument (not with `-N` > 1). -* `-f ARGFILE`: Read arguments from ARGFILE, do not close standard input. -* `-s SHELLSCRIPT`: The argument `SHELLSCRIPT` is evaluated using `/bin/sh` - with the arguments (up to `-N`) passed as `$1`, `$2`, `$3`... - (this behaves as if `/bin/sh -c SHELLSCRIPT -` is passed as plain COMMAND). -* `-a`: take arguments from commandline, starting after the first `--`. -* `-A`: take arguments from commandline, starting after the first *argsep*. - -If no argument is passed, default to "printf %s\n". - -The current iteration is passed as `$ITER` to the child process -(increased on every exec()). - -## Return code - -Like GNU and OpenBSD xargs: - -* 0 on success -* 123 if any invocation of the command exited with status 1-125 -* 124 if the command exited with status 255 -* 125 if the command is killed by a signal -* 126 if the command cannot be run -* 127 if the command is not found -* 1 if some other error occurred. - -Additionally, 122 is returned when `-R` is passed and no -input/arguments were passed. +## [Man page](README) ## Installation -- cgit 1.4.1