parallel/doc/release_new_version

300 lines
9.7 KiB
Plaintext
Raw Normal View History

2010-06-05 23:03:39 +00:00
= Notes on how to release new version =
== alpha/beta/production ==
Update documentation:
2011-12-21 23:17:49 +00:00
git diff last-release-commit
Unmodified beta since last version => production
Unmodified alpha since last version => beta
Modified => alpha
2010-06-05 23:03:39 +00:00
== Update version ==
=== configure.ac ===
configure.ac: AC_INIT([parallel], [20100422], [bug-parallel@gnu.org])
YYYYMMDD=`yyyymmdd`
perl -i -pe "s/20\d\d\d\d\d\d/$YYYYMMDD/" configure.ac
=== src/parallel ===
src/parallel: $Global::version = 20100422;
YYYYMMDD=`yyyymmdd`
perl -i -pe "/version/ and s/20\d\d\d\d\d\d/$YYYYMMDD/" src/parallel
2010-09-06 22:15:53 +00:00
perl -i -pe "/version/ and s/20\d\d\d\d\d\d/$YYYYMMDD/" src/sql
2010-12-21 20:10:44 +00:00
perl -i -pe "/version/ and s/20\d\d\d\d\d\d/$YYYYMMDD/" src/niceload
2010-06-05 23:03:39 +00:00
=== Autoconf/automake ===
rm -fr autom4te.cache aclocal.m4 config.h config.h.in config.log Makefile.in missing install-sh
rm -rf src/Makefile.in
autoreconf --install -W gnu
./configure
make -j && sudo make install
2010-06-05 23:03:39 +00:00
2010-11-13 13:57:39 +00:00
== Testsuite ==
2010-06-05 23:03:39 +00:00
2010-11-13 13:57:39 +00:00
cd testsuite; make
2010-06-05 23:03:39 +00:00
== Update NEWS ==
With the same things that goes in the announce mail
2010-06-05 23:03:39 +00:00
== Package ==
./configure
make dist
make dist-bzip2
2010-08-22 09:00:52 +00:00
== Test the package ==
YYYYMMDD=`yyyymmdd`
2010-08-22 09:00:52 +00:00
cp parallel-$YYYYMMDD.tar.bz2 /tmp
pushd /tmp
2010-08-22 09:00:52 +00:00
tar xjvf parallel-$YYYYMMDD.tar.bz2
cd parallel-$YYYYMMDD
./configure && make -j && sudo make -j install
pushd
2010-08-22 09:00:52 +00:00
2010-06-05 23:03:39 +00:00
== Upload ==
YYYYMMDD=`yyyymmdd`
cp doc/parallel.directive parallel-$YYYYMMDD.tar.bz2.directive
perl -i -pe "s/20\d\d\d\d\d\d/$YYYYMMDD/" parallel-*.tar.*directive
2010-06-05 23:03:39 +00:00
gpg --clearsign parallel-$YYYYMMDD.tar.bz2.directive
YYYYMMDD=`yyyymmdd`
gpg -b parallel-$YYYYMMDD.tar.bz2
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/alpha/
2010-06-05 23:03:39 +00:00
== Update OpenSUSE build system ==
cd ~/privat/parallel/packager/obs
# Update version number
em home:tange/parallel/parallel.spec
find home:tange/parallel/* -type f | grep -v parallel.spec | parallel -Xj1 osc rm {}
# This should not create new files
osc up home:tange/parallel/
make
# Update versionsnummeret from 20110422-2 to YYYYMMDD-1
# Reload build-status:
https://build.opensuse.org/package/show?package=parallel&project=home%3Atange
2011-07-25 22:12:46 +00:00
# Check that one .deb (Debian 5.0) and one .rpm (CentOS) end with 'succeeded'
== Download and test ==
2011-03-22 00:44:50 +00:00
YYYYMMDD=`yyyymmdd`
pushd /tmp
rm -rf parallel-${YYYYMMDD}*
wget http://ftp.gnu.org/gnu/parallel/parallel-$YYYYMMDD.tar.bz2
#wget http://alpha.gnu.org/gnu/parallel/parallel-$YYYYMMDD.tar.bz2
tar xjvf parallel-$YYYYMMDD.tar.bz2
cd parallel-$YYYYMMDD
./configure
make -j && sudo make -j install
pushd
2010-06-08 14:13:20 +00:00
== Update website ==
http://www.gnu.org/software/parallel/
http://www.gnu.org/software/parallel/man.html
http://www.gnu.org/software/parallel/sql.html
http://www.gnu.org/software/parallel/sem.html
http://www.gnu.org/software/parallel/niceload.html
2010-06-08 14:13:20 +00:00
pod2html src/parallel.pod > ../parallel-web/parallel/man.html
pod2html src/sql > ../parallel-web/parallel/sql.html
pod2html src/niceload.pod > ../parallel-web/parallel/niceload.html
pod2html src/sem.pod > ../parallel-web/parallel/sem.html
pushd ../parallel-web/parallel
2010-09-05 22:48:28 +00:00
cvs up
2010-06-08 14:13:20 +00:00
cvs ci
pushd
2010-06-08 14:13:20 +00:00
2011-03-22 00:44:50 +00:00
== Commit released version ==
git diff
git commit -a
2011-07-25 22:12:46 +00:00
== Update Savannah ==
Content from release mail:
cat doc/release_new_version | klipper-stdin
https://savannah.gnu.org/news/submit.php?group=parallel
https://savannah.gnu.org/news/approve.php?group=parallel
# No longer updated. Too long and too buggy
# doc/pod2savannah_publicinfo src/parallel | klipper-stdin
# https://savannah.gnu.org/project/admin/editgroupinfo.php?group=parallel
2010-06-05 23:03:39 +00:00
== Update Freshmeat ==
http://freshmeat.net/projects/parallel/releases/new
2012-01-07 01:24:50 +00:00
== Update Diaspora Twitter ==
2010-11-13 16:04:58 +00:00
New version of #GNU Parallel released. See what is new in this release
2012-01-07 01:24:50 +00:00
http://nd.gd/2j Watch the intro videos http://nd.gd/039
2010-11-13 16:04:58 +00:00
https://savannah.gnu.org/news/?group=parallel
# Obsolete: Now use @GnuParallel
# # Only 350 requests per hour: 1 tweet = 3 requests
# # 119 tweets/hour = sleep 30 per tweet (40 to be safe)
# # The above is not enough.
# # Went over the limit at number 132 (sleep 40)
# # https://support.twitter.com/entries/15364-about-twitter-limits-update-api-dm-and-following
# # says 250 direct msg per day = 86400/250 = sleep 345
# cat twitters | grep -iv removed |
# parallel -j1 sleep 354\; echo @{} You have shown interest in GNU Parallel. \
# New version: http://nd.gd/2j This is the last message: Follow @GnuParallel \
# '|' ttytter
2010-06-05 23:03:39 +00:00
== Send announce ==
http://groups.google.com/group/comp.unix.shell/post
Newsgroups: comp.unix.shell,comp.unix.admin
2011-04-23 12:01:22 +00:00
https://lists.gnu.org/mailman/admindb/bug-parallel
https://lists.gnu.org/mailman/admindb/parallel
2010-06-05 23:03:39 +00:00
<<<<<
from:tange@gnu.org
2012-01-07 01:24:50 +00:00
to:parallel@gnu.org, bug-parallel@gnu.org
cc:Sandro Cazzaniga <kharec@mandriva.org>,
2012-01-07 01:24:50 +00:00
Tim Cuthbertson <tim3d.junk@gmail.com>,
Steven M. Christensen <sunfreeware@gmail.com>,
Ludovic Courtès <ludo@gnu.org>, Markus Ammer <mkmm@gmx-topmail.de>,
Pavel Nuzhdin <pnzhdin@gmail.com>, Phil Sung <psung@alum.mit.edu>,
Michael Shigorin <mike@altlinux.org>,
Andrew McFague <amcfague@wgen.net>,
Chris Howey <howeyc@gmail.com>,
Fethican Coşkuner <fethicanc@gmail.com>,
Rogério Brito <rbrito@ime.usp.br>,
Koen Vervloesem <koen@vervloesem.eu>,
R. Tyler Croy <tyler@monkeypox.org>,
kerick@shiftedbit.net, Christian Faulhammer <fauli@gentoo.org>,
2012-01-07 01:24:50 +00:00
Ryoichiro Suzuki <ryoichiro.suzuki@gmail.com>,
Jesse Alama <jesse.alama@gmail.com>
2010-06-05 23:03:39 +00:00
Subject: GNU Parallel 20120122 ('Dead SOPA') released
2010-06-05 23:03:39 +00:00
GNU Parallel 20120122 ('Dead SOPA') has been released. It is
2011-03-22 00:44:50 +00:00
available for download at: http://ftp.gnu.org/gnu/parallel/
New in this release:
* --header : uses the first input line as column names and you can
then use {colname} as a replacement string in the command. This also
works with multiple :::'s.
2012-01-07 01:24:50 +00:00
* --header <regexp> matches a header as a regular expression and
repeats the header for each block with --pipe.
2012-01-07 01:24:50 +00:00
* --resume resumes from the last unfinished job. Useful if you stop
GNU Parallel and restart it later with the same arguments.
* niceload now propagates exit status correctly.
* Show your support for GNU Parallel. For a limited time you can get a
GNU Parallel T-shirt+mug+pen+100 postcards at 20 EUR. See
https://www.gnu.org/software/parallel/merchandise.html
* Options -g -B -T -U -W -Y are retired as warned 6 months ago.
* GNU Parallel referenced in article on Holographic Grid Cloud. Thanks
to Stefano Gallozzi. http://arxiv.org/pdf/1112.6128
* Article in IEEE Software on GNU Parallel. Thanks to Diomidis
Spinellis. http://www.spinellis.gr/blog/20110911/
* An article on Narwhal which uses GNU Parallel. They forgot to add
the reference. Please remember --bibtex if you use GNU Parallel in
an article.
http://bioinformatics.oxfordjournals.org/content/early/2011/11/08/bioinformatics.btr613.full.pdf
* Blog post on using GNU Parallel to speed up BLAST queries:
http://blog.mckuhn.de/2012/01/embarrassingly-parallel-blast-search.html
2012-01-07 01:24:50 +00:00
* Video showing Wake-on-LAN with GNU Parallel.
https://www.youtube.com/watch?v=0mB-yIyKFLQ
2011-12-21 23:17:49 +00:00
2012-01-07 01:24:50 +00:00
* Using GNU Parallel with Solr.
http://sujitpal.blogspot.com/2011/12/solr-report-generation-with-python.html
2011-11-22 21:38:57 +00:00
2012-01-07 01:24:50 +00:00
* First job ad including GNU Parallel:
http://seeker.dice.com/jobsearch/servlet/JobSearch?op=101&dockey=xml/7/6/76f858de083a094f74b1a5d3ba53ffc5@endecaindex
2011-12-21 23:17:49 +00:00
* Bug fixes and man page updates.
2010-06-05 23:03:39 +00:00
= About GNU Parallel =
GNU Parallel is a shell tool for executing jobs in parallel using one
2011-01-27 21:56:59 +00:00
or more computers. A job is can be 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, a list of
URLs, or a list of tables. A job can also be a command that reads from
a pipe. GNU Parallel can then split the input and pipe it into
commands in parallel.
If you use xargs and tee today you will find GNU Parallel very easy to
use as GNU Parallel is written to have the same options as xargs. If
you write loops in shell, you will find GNU Parallel may be able to
2010-06-05 23:03:39 +00:00
replace most of the loops and make them run faster by running several
2011-05-13 12:02:03 +00:00
jobs in parallel. GNU Parallel can even replace nested loops.
2010-06-05 23:03:39 +00:00
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/s/parallel/
2011-11-22 21:52:52 +00:00
Watch the intro video on
http://www.youtube.com/playlist?list=PL284C9FF2488BC6D1 or at
http://tinyogg.com/watch/TORaR/ and http://tinyogg.com/watch/hfxKj/
When using GNU Parallel for a publication please cite:
O. Tange (2011): GNU Parallel - The Command-Line Power Tool, ;login:
The USENIX Magazine, February 2011:42-47.
2011-05-13 12:02:03 +00:00
= About GNU SQL =
GNU sql aims to give a simple, unified interface for accessing
databases through all the different databases' command line
clients. So far the focus has been on giving a common way to specify
login information (protocol, username, password, hostname, and port
number), size (database and table size), and running queries.
The database is addressed using a DBURL. If commands are left out you
will get that database's interactive shell.
When using GNU SQL for a publication please cite:
O. Tange (2011): GNU SQL - A Command Line Tool for Accessing Different
2011-05-20 23:07:45 +00:00
Databases Using DBURLs, ;login: The USENIX Magazine, April 2011:29-32.
2011-07-25 22:12:46 +00:00
= About GNU Niceload =
GNU niceload slows down a program when the computer load average (or
other system activity) is above a certain limit. When the limit is
reached the program will be suspended for some time. If the limit is a
soft limit the program will be allowed to run for short amounts of
time before being suspended again. If the limit is a hard limit the
program will only be allowed to run when the system is below the
limit.
2010-06-05 23:03:39 +00:00
>>>>>