From 2b48b700c9d2f135647971b1ba4ce8ebeba205f6 Mon Sep 17 00:00:00 2001 From: Ole Tange Date: Tue, 27 Apr 2010 00:52:13 +0200 Subject: [PATCH] More thorough documentation of releasing a new version --- README | 42 ++++++++++++++++- ...nah_publicinfo => pod2savannah_publicinfo} | 0 doc/release_new_version | 47 +++++++++++++++++++ src/parallel | 19 +++++++- 4 files changed, 105 insertions(+), 3 deletions(-) rename doc/{pod_to_savannah_publicinfo => pod2savannah_publicinfo} (100%) diff --git a/README b/README index b980d1d7..f5578f21 100644 --- a/README +++ b/README @@ -1 +1,41 @@ -./configure; make; make install + + GNU Parallel README + +Please send problems and feedback to bug-parallel@gnu.org. + += Presentation of GNU Parallel = + +GNU Parallel is a shell tool for executing jobs in parallel. A job is +typically a single command or a small script that has to be run for +each of the lines in the input. The typical input is a list of files, +a list of hosts, a list of users, or a list of tables. + +If you use xargs today you will find GNU Parallel very easy to use. If +you write loops in shell, you will find GNU Parallel may be able to +replace most of the loops and make them run faster by running jobs in +parallel. If you use ppss or pexec you will find GNU Parallel will +often make the command easier to read. + +GNU Parallel also makes sure output from the commands is the same +output as you would get had you run the commands sequentially. This +makes it possible to use output from GNU Parallel as input for other +programs. + + += Installation = + +Installation of GNU Parallel is a simple as: + + ./configure && make && make install + +After this you should be able to do: + + (echo foss.org.my; echo gnu.org; echo freenetproject.org) | parallel traceroute + +This will run traceroute to 3 different hosts in parallel and print +the output when the traceroutes are done. + + += New versions = + +New versions will be released at: ftp://ftp.gnu.org/gnu/parallel/ diff --git a/doc/pod_to_savannah_publicinfo b/doc/pod2savannah_publicinfo similarity index 100% rename from doc/pod_to_savannah_publicinfo rename to doc/pod2savannah_publicinfo diff --git a/doc/release_new_version b/doc/release_new_version index cf6f3141..fcc965fd 100644 --- a/doc/release_new_version +++ b/doc/release_new_version @@ -50,3 +50,50 @@ gpg -b parallel-$YYYYMMDD.tar.bz2 YYYYMMDD=`yyyymmdd` echo put parallel-$YYYYMMDD.tar.bz2{,.sig,*asc} | ncftp ftp://ftp-upload.gnu.org/incoming/ftp/ + +YYYYMMDD=`yyyymmdd` +echo put parallel-$YYYYMMDD.tar.bz2{,.sig,*asc} | ncftp ftp://ftp-upload.gnu.org/incoming/alpha/ + +== Update web == + +pod2html src/parallel > ../parallel-web/parallel/man.html +cd ../parallel-web +cvs ci + +doc/pod2savannah_publicinfo src/parallel | klipper-stdin +https://savannah.gnu.org/project/admin/editgroupinfo.php?group=parallel + +== Announce release == + +News on Savannah: https://savannah.gnu.org/news/submit.php?group=parallel +Email to: parallel@gnu.org, bug-parallel@gnu.org, , + +<_EMAIL_> +Subject: GNU Parallel <> released +GNU Parallel <> has been released today. It is available for +download at: http://ftp.gnu.org/gnu/parallel/ + +New in this release: + +* GNU Parallel is now official GNU software + += About GNU Parallel = + +GNU Parallel is a shell tool for executing jobs in parallel. A job is +typically a single command or a small script that has to be run for +each of the lines in the input. The typical input is a list of files, +a list of hosts, a list of users, or a list of tables. + +If you use xargs today you will find GNU Parallel very easy to use. If +you write loops in shell, you will find GNU Parallel may be able to +replace most of the loops and make them run faster by running jobs in +parallel. If you use ppss or pexec you will find GNU Parallel will +often make the command easier to read. + +GNU Parallel makes sure output from the commands is the same output as +you would get had you run the commands sequentially. This makes it +possible to use output from GNU Parallel as input for other programs. + +You can find more about GNU Parallel at: +http://www.gnu.org/software/parallel/ + diff --git a/src/parallel b/src/parallel index 2ab85cbe..a58c5eed 100755 --- a/src/parallel +++ b/src/parallel @@ -11,6 +11,21 @@ B [-0cdEfghiIkmnpqrtuUvVX] [-I str] [-j num] [--silent] =head1 DESCRIPTION +GNU B is a shell tool for executing jobs in parallel. A job is +typically a single command or a small script that has to be run for +each of the lines in the input. The typical input is a list of files, +a list of hosts, a list of users, or a list of tables. + +If you use B today you will find GNU B very easy to +use. If you write loops in shell, you will find GNU B may be +able to replace most of the loops and make them run faster by running +jobs in parallel. If you use B or B you will find GNU +B will often make the command easier to read. + +GNU B makes sure output from the commands is the same output as +you would get had you run the commands sequentially. This makes it +possible to use output from GNU B as input for other programs. + For each line of input GNU B will execute B with the line as arguments. If no B is given the line of input is executed. GNU B can often be used as a substitute for B @@ -668,7 +683,7 @@ server has 8 CPU cores. =head1 EXAMPLE 10: Transferring of files (not implemented) -To recompress gzipped files with bzip2 using a remote server run: +To recompress gzipped files with B using a remote server run: find logs/ -name '*.gz' | \ parallel --sshlogin server.example.com \ @@ -700,7 +715,7 @@ machine and the files transfered from the remote machine: --transfer --return {.}.bz2 --cleanup "zcat {} | bzip2 -9 >{.}.bz2" If you want run one several servers add the servers to I<--sshlogin> -either using ',' or separate I<--sshlogin>: +either using ',' or multiple I<--sshlogin>: find logs/ -name '*.gz' | \ parallel --sshlogin server.example.com,server2.example.com \