man page update.

This commit is contained in:
Ole Tange 2011-03-29 16:22:56 +02:00
parent 12d39d59f9
commit e1b8521487
3 changed files with 25 additions and 62 deletions

View file

@ -148,72 +148,32 @@ cc:Peter Simons <simons@cryp.to>, Sandro Cazzaniga <kharec@mandriva.org>,
Phil Sung <psung@alum.mit.edu>, Michael Shigorin <mike@altlinux.org>,
Andrew McFague <amcfague@wgen.net>, Steven M. Christensen <sunfreeware@gmail.com>,
Chris Howey <howeyc@gmail.com>, Fethican Coşkuner <fethicanc@gmail.com>,
Rogério Brito <rbrito@ime.usp.br>, Jonathan Palardy <jonathan.palardy@gmail.com>,
Rogério Brito <rbrito@ime.usp.br>,
Koen Vervloesem <koen@vervloesem.eu>, R. Tyler Croy <tyler@monkeypox.org>,
ryoichiro.suzuki@gmail.com,kerick@shiftedbit.net,
Christian Faulhammer <fauli@gentoo.org>, Ryoichiro Suzuki <ryoichiro.suzuki@gmail.com>,
Jesse Alama <jesse.alama@gmail.com>
Subject: GNU Parallel 20110322 (the Japan release) released
Subject: GNU Parallel 2011XXXX ('Libya') released
GNU Parallel 20110322 (the Japan release) has been released. It is
GNU Parallel 2011XXXX ('Libya') has been released. It is
available for download at: http://ftp.gnu.org/gnu/parallel/
New in this release:
* --tollef to be switch compatible with Tollef's parallel. This will
cause -l to mean --load, and the argument separator will be --
instead of :::
? Part of Fedora?
? Part of Debian?
? Part of Ubuntu?
* --gnu will force GNU Parallel to behave like GNU Parallel even if
--tollef is set.
* Site wide config file: /etc/parallel/config
This should solve the issue with some packagers renaming GNU
Parallel to gparallel to avoid the naming conflict.
By putting --tollef in the site wide config file you can deinstall
Tollef's parallel and install GNU Parallel instead without any
change for users or scripts. This is useful for packagers that
currently rename GNU Parallel or simply do not distribute GNU
Parallel because the command name conflicts with Tollef's parallel.
* -L 0 -n 0, and -N 0 implemented. They will read one argument,
but insert 0 arguments on the command line. Useful if you just want
to run the same command with the same arguments a number of times.
* GNU Parallel is now in Fink. Thanks to Jesse Alama.
http://pdb.finkproject.org/pdb/package.php/parallel
* Opscode Cookbook for Chef. Thanks to Joshua Timberman.
https://github.com/opscode/cookbooks/tree/master/gnu_parallel
* Man page examples translated into Japanese. Thanks to Koshigoe.
http://w.koshigoe.jp/study/?%5Bsystem%5D+GNU+parallel+%BB%C8%CD%D1%CE%E3#l13
* GNU Parallel will be presented at:
* GNU Parallel was presented at:
- LUGA, Augsburg, 2011-03-26, http://www.luga.de/Aktionen/LIT-2011/Programm
- OSAA.dk, Aarhus, 2011-04-12
* Video of presentation from FSCONS 2010-11-07. The presenter was
_really_ hoarse that day (Something to do with loads of alcohol the
night before). http://vimeo.com/20838834
* Example of how to use GNU Parallel on PBS clusters. Thanks to Andrew
J Dolgert: http://web0.tc.cornell.edu/wiki/index.php?title=Gnu_Parallel
* Review with examples in German. Thanks to M. Nieberg.
http://kenntwas.de/2011/linux/gnu-parallel/
* A review of the --pipe option in German. Thanks to Mathias Huber.
http://www.linux-magazin.de/NEWS/GNU-Parallel-20110205-stueckelt-Daten
* A small example of grepping maillogs. Thanks to François Maillet.
http://www.francoismaillet.com/blog/?p=399
* Using GNU Parallel instead of xargs. Thanks to James Cuff.
http://blog.jcuff.net/2011/02/on-train-ride-in.html
* Using GNU Parallel from 0install (German). Thanks to AdaMin.
http://forum.ubuntuusers.de/topic/gnu-parallel-mit-zero-install-kurzinfo-kein-wi/
* First example of using GNU Parallel in Hebrew. Thanks to omry.
http://nd.gd/jk
* Bug fixes and man page updates.

View file

@ -384,7 +384,7 @@ sub get_options_from_array {
sub parse_options {
# Returns: N/A
# Defaults:
$Global::version = 20110323;
$Global::version = 20110324;
$Global::progname = 'parallel';
$Global::infinity = 2**31;
$Global::debug = 0;

View file

@ -1209,15 +1209,14 @@ file:
B<convert -geometry 120 foo.jpg thumb_foo.jpg>
If the system has more than 1 CPU core it can be run with
number-of-cpu-cores jobs in parallel (B<-j> +0). This will do that for
all jpg files in a directory:
This will run with number-of-cpu-cores jobs in parallel for all jpg
files in a directory:
B<ls *.jpg | parallel -j +0 convert -geometry 120 {} thumb_{}>
B<ls *.jpg | parallel convert -geometry 120 {} thumb_{}>
To do it recursively use B<find>:
B<find . -name '*.jpg' | parallel -j +0 convert -geometry 120 {} {}_thumb.jpg>
B<find . -name '*.jpg' | parallel convert -geometry 120 {} {}_thumb.jpg>
Notice how the argument has to start with B<{}> as B<{}> will include path
(e.g. running B<convert -geometry 120 ./foo/bar.jpg
@ -1227,7 +1226,7 @@ generate files like ./foo/bar.jpg_thumb.jpg.
Use B<{.}> to avoid the extra .jpg in the file name. This command will
make files like ./foo/bar_thumb.jpg:
B<find . -name '*.jpg' | parallel -j +0 convert -geometry 120 {} {.}_thumb.jpg>
B<find . -name '*.jpg' | parallel convert -geometry 120 {} {.}_thumb.jpg>
=head1 EXAMPLE: Substitution and redirection
@ -1267,6 +1266,10 @@ line number and the URL.
B<cat urlfile | parallel "wget {} 2>>B</dev/null || grep -n {} urlfile">
Create a mirror directory with the same filenames except all files and
symlinks are empty files.
B<cp -rs /the/source/dir mirror_dir; find mirror_dir -type l | parallel -m rm {} '&&' touch {}>
=head1 EXAMPLE: Removing file extension when processing files
@ -2228,17 +2231,17 @@ composed commands and redirection require using B<bash -c>.
B<ls | parallel "wc {} >> B<{}.wc">
becomes
becomes (assuming you have 8 cores)
B<ls | xargs -d "\n" -P9 -I {} bash -c "wc {} >>B< {}.wc">
B<ls | xargs -d "\n" -P8 -I {} bash -c "wc {} >>B< {}.wc">
and
B<ls | parallel "echo {}; ls {}|wc">
becomes
becomes (assuming you have 8 cores)
B<ls | xargs -d "\n" -P9 -I {} bash -c "echo {}; ls {}|wc">
B<ls | xargs -d "\n" -P8 -I {} bash -c "echo {}; ls {}|wc">
=head2 DIFFERENCES BETWEEN find -exec AND GNU Parallel