tange/parallel
1
0
Fork 0
mirror of https://git.savannah.gnu.org/git/parallel.git synced 2024-11-29 17:37:55 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

Fixed: #33629: Update documentation for -X to reflect current behavior.

Browse source 
--help give one line description of the options I use mostly.
This commit is contained in:
Ole Tange 2011-06-27 23:21:26 +02:00
parent 76ae522c84
commit de6d588893
2 changed files with 37 additions and 12 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

30
src/parallel
View file

@ -1641,12 +1641,30 @@ sub die_usage {
sub usage { sub usage {
# Returns: N/A # Returns: N/A
print "Usage:\n"; print join
print "$Global::progname [options] [command [arguments]] < list_of_arguments\n"; ("\n",
print "$Global::progname [options] [command [arguments]] ::: arguments\n"; "Usage:",
print "$Global::progname [options] [command [arguments]] :::: argfile(s)\n"; "$Global::progname [options] [command [arguments]] < list_of_arguments",
print "\n"; "$Global::progname [options] [command [arguments]] (::: arguments|:::: argfile(s))...",
print "See 'man $Global::progname' for the options\n"; "",
"-j n Run n jobs in parallel",
"-k Keep same order",
"-X Multiple arguments with context replace",
"--colsep regexp Split input on regexp for positional replacements",
"{} {.} {/} {/.} Replacement strings",
"{3} {3.} {3/} {3/.} Positional replacement strings",
"",
"-S sshlogin - e.g. foo\@server.example.com",
"--trc {}.bar Shorthand for --transfer --return {}.bar --cleanup",
"--onall Run the given command with argument on all sshlogins",
"--nonall Run the given command with no arguments on all sshlogins",
"",
"--pipe Split stdin (standard input) to multiple jobs.",
"--recend Record end separator for --pipe.",
"--recstart Record start separator for --pipe.",
"",
"See 'man $Global::progname' for details",
"");
} }
sub die_bug { sub die_bug {

19
src/parallel.pod
View file

@ -610,8 +610,11 @@ that specify their own ssh command.
=item B<-m> =item B<-m>
Multiple. Insert as many arguments as the command line length Multiple arguments. Insert as many arguments as the command line
permits. If B<{}> is not used the arguments will be appended to the length permits. If multiple jobs are being run in parallel: distribute
the arguments evenly among the jobs. Use B<-j1> to avoid this.
If B<{}> is not used the arguments will be appended to the
line. If B<{}> is used multiple times each B<{}> will be replaced line. If B<{}> is used multiple times each B<{}> will be replaced
with all the arguments. with all the arguments.
@ -1221,10 +1224,14 @@ See also: B<man sem>
=item B<-X> =item B<-X>
Multiple arguments with context replace. Insert as many arguments as Multiple arguments with context replace. Insert as many arguments as
the command line length permits. If B<{}> is not used the arguments the command line length permits. If multiple jobs are being run in
will be appended to the line. If B<{}> is used as part of a word parallel: distribute the arguments evenly among the jobs. Use B<-j1>
(like I<pic{}.jpg>) then the whole word will be repeated. If B<{}> is to avoid this.
used multiple times each B<{}> will be replaced with the arguments.
If B<{}> is not used the arguments will be appended to the line. If
B<{}> is used as part of a word (like I<pic{}.jpg>) then the whole
word will be repeated. If B<{}> is used multiple times each B<{}> will
be replaced with the arguments.
Normally B<-X> will do the right thing, whereas B<-m> can give Normally B<-X> will do the right thing, whereas B<-m> can give
unexpected results if B<{}> is used as part of a word. unexpected results if B<{}> is used as part of a word.