More thorough documentation of releasing a new version

This commit is contained in:
Ole Tange 2010-04-27 00:52:13 +02:00
parent 00d9382abd
commit 2b48b700c9
4 changed files with 105 additions and 3 deletions

42
README
View file

@ -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/

View file

@ -50,3 +50,50 @@ gpg -b parallel-$YYYYMMDD.tar.bz2
YYYYMMDD=`yyyymmdd` YYYYMMDD=`yyyymmdd`
echo put parallel-$YYYYMMDD.tar.bz2{,.sig,*asc} | ncftp ftp://ftp-upload.gnu.org/incoming/ftp/ 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, <info-gnu@gnu.org>, <bug-directory@gnu.org>
<_EMAIL_>
Subject: GNU Parallel <<version>> released
GNU Parallel <<version>> 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/
</_EMAIL_>

View file

@ -11,6 +11,21 @@ B<parallel> [-0cdEfghiIkmnpqrtuUvVX] [-I str] [-j num] [--silent]
=head1 DESCRIPTION =head1 DESCRIPTION
GNU B<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 B<xargs> today you will find GNU B<parallel> very easy to
use. If you write loops in shell, you will find GNU B<parallel> may be
able to replace most of the loops and make them run faster by running
jobs in parallel. If you use B<ppss> or B<pexec> you will find GNU
B<parallel> will often make the command easier to read.
GNU B<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 B<parallel> as input for other programs.
For each line of input GNU B<parallel> will execute B<command> with the For each line of input GNU B<parallel> will execute B<command> with the
line as arguments. If no B<command> is given the line of input is line as arguments. If no B<command> is given the line of input is
executed. GNU B<parallel> can often be used as a substitute for B<xargs> executed. GNU B<parallel> can often be used as a substitute for B<xargs>
@ -668,7 +683,7 @@ server has 8 CPU cores.
=head1 EXAMPLE 10: Transferring of files (not implemented) =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<bzip2> using a remote server run:
find logs/ -name '*.gz' | \ find logs/ -name '*.gz' | \
parallel --sshlogin server.example.com \ 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" --transfer --return {.}.bz2 --cleanup "zcat {} | bzip2 -9 >{.}.bz2"
If you want run one several servers add the servers to I<--sshlogin> 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' | \ find logs/ -name '*.gz' | \
parallel --sshlogin server.example.com,server2.example.com \ parallel --sshlogin server.example.com,server2.example.com \