From e1b85214877a47c54a0e6caad5b21b9a25048179 Mon Sep 17 00:00:00 2001 From: Ole Tange Date: Tue, 29 Mar 2011 16:22:56 +0200 Subject: [PATCH] man page update. --- doc/release_new_version | 62 ++++++++--------------------------------- src/parallel | 2 +- src/parallel.pod | 23 ++++++++------- 3 files changed, 25 insertions(+), 62 deletions(-) diff --git a/doc/release_new_version b/doc/release_new_version index 50adbc81..a948d272 100644 --- a/doc/release_new_version +++ b/doc/release_new_version @@ -148,72 +148,32 @@ cc:Peter Simons , Sandro Cazzaniga , Phil Sung , Michael Shigorin , Andrew McFague , Steven M. Christensen , Chris Howey , Fethican Coşkuner , - Rogério Brito , Jonathan Palardy , + Rogério Brito , Koen Vervloesem , R. Tyler Croy , ryoichiro.suzuki@gmail.com,kerick@shiftedbit.net, Christian Faulhammer , Ryoichiro Suzuki , Jesse Alama -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. diff --git a/src/parallel b/src/parallel index f6fd35b8..fa4905b0 100755 --- a/src/parallel +++ b/src/parallel @@ -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; diff --git a/src/parallel.pod b/src/parallel.pod index 8035bc3a..da8b6bee 100644 --- a/src/parallel.pod +++ b/src/parallel.pod @@ -1209,15 +1209,14 @@ file: B -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 +B To do it recursively use B: -B +B Notice how the argument has to start with B<{}> as B<{}> will include path (e.g. running B to avoid the extra .jpg in the file name. This command will make files like ./foo/bar_thumb.jpg: -B +B =head1 EXAMPLE: Substitution and redirection @@ -1267,6 +1266,10 @@ line number and the URL. B>B +Create a mirror directory with the same filenames except all files and +symlinks are empty files. + +B =head1 EXAMPLE: Removing file extension when processing files @@ -2228,17 +2231,17 @@ composed commands and redirection require using B. B> B<{}.wc"> -becomes +becomes (assuming you have 8 cores) -B>B< {}.wc"> +B>B< {}.wc"> and B -becomes +becomes (assuming you have 8 cores) -B +B =head2 DIFFERENCES BETWEEN find -exec AND GNU Parallel