tange/parallel
1
0
Fork 0
mirror of https://git.savannah.gnu.org/git/parallel.git synced 2024-11-26 07:57:58 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

man page update.

Browse source
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
Show stats Download patch file Download diff file Expand all files Collapse all files

62
doc/release_new_version
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>, Phil Sung <psung@alum.mit.edu>, Michael Shigorin <mike@altlinux.org>,
Andrew McFague <amcfague@wgen.net>, Steven M. Christensen <sunfreeware@gmail.com>, Andrew McFague <amcfague@wgen.net>, Steven M. Christensen <sunfreeware@gmail.com>,
Chris Howey <howeyc@gmail.com>, Fethican Coşkuner <fethicanc@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>, Koen Vervloesem <koen@vervloesem.eu>, R. Tyler Croy <tyler@monkeypox.org>,
ryoichiro.suzuki@gmail.com,kerick@shiftedbit.net, ryoichiro.suzuki@gmail.com,kerick@shiftedbit.net,
Christian Faulhammer <fauli@gentoo.org>, Ryoichiro Suzuki <ryoichiro.suzuki@gmail.com>, Christian Faulhammer <fauli@gentoo.org>, Ryoichiro Suzuki <ryoichiro.suzuki@gmail.com>,
Jesse Alama <jesse.alama@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/ available for download at: http://ftp.gnu.org/gnu/parallel/
New in this release: New in this release:
* --tollef to be switch compatible with Tollef's parallel. This will ? Part of Fedora?
cause -l to mean --load, and the argument separator will be -- ? Part of Debian?
instead of ::: ? Part of Ubuntu?
* --gnu will force GNU Parallel to behave like GNU Parallel even if * GNU Parallel was presented at:
--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:
- LUGA, Augsburg, 2011-03-26, http://www.luga.de/Aktionen/LIT-2011/Programm - LUGA, Augsburg, 2011-03-26, http://www.luga.de/Aktionen/LIT-2011/Programm
- OSAA.dk, Aarhus, 2011-04-12 - OSAA.dk, Aarhus, 2011-04-12
* Video of presentation from FSCONS 2010-11-07. The presenter was * Example of how to use GNU Parallel on PBS clusters. Thanks to Andrew
_really_ hoarse that day (Something to do with loads of alcohol the J Dolgert: http://web0.tc.cornell.edu/wiki/index.php?title=Gnu_Parallel
night before). http://vimeo.com/20838834
* Review with examples in German. Thanks to M. Nieberg. * First example of using GNU Parallel in Hebrew. Thanks to omry.
http://kenntwas.de/2011/linux/gnu-parallel/ http://nd.gd/jk
* 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/
* Bug fixes and man page updates. * Bug fixes and man page updates.

2
src/parallel
View file

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

23
src/parallel.pod
View file

@ -1209,15 +1209,14 @@ file:
B<convert -geometry 120 foo.jpg thumb_foo.jpg> B<convert -geometry 120 foo.jpg thumb_foo.jpg>
If the system has more than 1 CPU core it can be run with This will run with number-of-cpu-cores jobs in parallel for all jpg
number-of-cpu-cores jobs in parallel (B<-j> +0). This will do that for files in a directory:
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>: 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 Notice how the argument has to start with B<{}> as B<{}> will include path
(e.g. running B<convert -geometry 120 ./foo/bar.jpg (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 Use B<{.}> to avoid the extra .jpg in the file name. This command will
make files like ./foo/bar_thumb.jpg: 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 =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"> 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 =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"> 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 and
B<ls | parallel "echo {}; ls {}|wc"> 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 =head2 DIFFERENCES BETWEEN find -exec AND GNU Parallel