More thorough documentation of releasing a new version

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/

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, <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_>

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 \