optional: update man-page description of --results to describe subdir behavior.

This commit is contained in:
Drew Frank 2012-12-21 22:02:06 -08:00
parent 701445aac6
commit 42537dafee

View file

@ -992,49 +992,42 @@ Only used with B<--pipe>.
=item B<--res> I<prefix> (beta testing) =item B<--res> I<prefix> (beta testing)
Results in files named by tab separated arguments. Save the output Save the output into files. The files will be stored in a directory tree
into files. The file names will be prefixed with I<prefix> which can rooted at I<prefix>. Within this directory tree, each command will result
contain a path with a prefix string. The file with output from stdout in two files: I<prefix>/<ARGS>/stdout and I<prefix>/<ARGS>/stderr, where
(standard output) will prefixed with 'I<prefix>stdout'. The file <ARGS> is a sequence of directories representing the header of the input
with output from stderr (standard error) will prefixed with source (if using B<--header :>) or the number of the input source and
'I<prefix>stderr'. corresponding values.
The postfix is the header of the input source (if using B<--header :>)
or the number of the input source followed by the value of the input
source. This is repeated for every input source and is separated by
TAB (\t).
E.g: E.g:
parallel --header : --results foo/bar echo {a} {b} ::: a I II ::: b III IIII parallel --header : --results foo echo {a} {b} ::: a I II ::: b III IIII
will generate the files: will generate the files:
foo/barstderr a I b III foo/a/I/b/III/stderr
foo/barstderr a I b IIII foo/a/I/b/IIII/stderr
foo/barstderr a II b III foo/a/II/b/III/stderr
foo/barstderr a II b IIII foo/a/II/b/IIII/stderr
foo/barstdout a I b III foo/a/I/b/III/stdout
foo/barstdout a I b IIII foo/a/I/b/IIII/stdout
foo/barstdout a II b III foo/a/II/b/III/stdout
foo/barstdout a II b IIII foo/a/II/b/IIII/stdout
and and
parallel --results foo/bar echo {1} {2} ::: I II ::: III IIII parallel --results foo echo {1} {2} ::: I II ::: III IIII
will generate the files: will generate the files:
foo/barstderr 1 I 2 III foo/1/I/2/III/stderr
foo/barstderr 1 I 2 IIII foo/1/I/2/IIII/stderr
foo/barstderr 1 II 2 III foo/1/II/2/III/stderr
foo/barstderr 1 II 2 IIII foo/1/II/2/IIII/stderr
foo/barstdout 1 I 2 III foo/1/I/2/III/stdout
foo/barstdout 1 I 2 IIII foo/1/I/2/IIII/stdout
foo/barstdout 1 II 2 III foo/1/II/2/III/stdout
foo/barstdout 1 II 2 IIII foo/1/II/2/IIII/stdout
where all spaces are TABs (\t);.
See also B<--files>, B<--header>, B<--joblog>. See also B<--files>, B<--header>, B<--joblog>.