mirror of
https://git.savannah.gnu.org/git/parallel.git
synced 2024-11-24 23:17:55 +00:00
More thorough documentation of releasing a new version
This commit is contained in:
parent
00d9382abd
commit
2b48b700c9
42
README
42
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/
|
||||
|
|
|
@ -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, <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_>
|
||||
|
|
19
src/parallel
19
src/parallel
|
@ -11,6 +11,21 @@ B<parallel> [-0cdEfghiIkmnpqrtuUvVX] [-I str] [-j num] [--silent]
|
|||
|
||||
=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
|
||||
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>
|
||||
|
@ -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<bzip2> 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 \
|
||||
|
|
Loading…
Reference in a new issue