mirror of
https://git.savannah.gnu.org/git/parallel.git
synced 2024-11-22 14:07:55 +00:00
338 lines
13 KiB
Plaintext
338 lines
13 KiB
Plaintext
= Notes on how to release new version =
|
||
|
||
== alpha/beta/production ==
|
||
|
||
Check that documentation is updated (compare to web):
|
||
|
||
Fixet for 20150622
|
||
git diff last-release-commit
|
||
Unmodified beta since last version => production
|
||
Unmodified alpha since last version => beta
|
||
Modified => alpha
|
||
|
||
== Update version ==
|
||
|
||
configure.ac: AC_INIT([parallel], [20100422], [bug-parallel@gnu.org])
|
||
src/parallel: $Global::version = 20100422;
|
||
README: parallel-20130222
|
||
|
||
YYYYMMDD=`yyyymmdd`
|
||
perl -i -pe "s/20\d\d\d\d\d\d/$YYYYMMDD/" configure.ac
|
||
perl -i -pe "/version/ and s/20\d\d\d\d\d\d/$YYYYMMDD/" src/parallel
|
||
perl -i -pe "/version/ and s/20\d\d\d\d\d\d/$YYYYMMDD/" src/sql
|
||
perl -i -pe "/version/ and s/20\d\d\d\d\d\d/$YYYYMMDD/" src/niceload
|
||
perl -i -pe "s/parallel-20\d\d\d\d\d\d/parallel-$YYYYMMDD/" README
|
||
|
||
=== 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
|
||
|
||
== Testsuite ==
|
||
|
||
cd testsuite; make mem; make
|
||
|
||
== Update NEWS ==
|
||
|
||
With the same things that goes in the announce mail
|
||
|
||
== Package ==
|
||
|
||
./configure
|
||
make dist
|
||
make dist-bzip2
|
||
|
||
== Test the package ==
|
||
|
||
YYYYMMDD=`yyyymmdd`
|
||
cp parallel-$YYYYMMDD.tar.bz2 /tmp
|
||
pushd /tmp
|
||
tar xjvf parallel-$YYYYMMDD.tar.bz2
|
||
cd parallel-$YYYYMMDD
|
||
./configure && make -j && sudo make -j install
|
||
pushd
|
||
|
||
== Upload ==
|
||
|
||
export YYYYMMDD=`yyyymmdd`
|
||
eval `gpg-agent --daemon`
|
||
make upload
|
||
|
||
# Only needed for alpha:
|
||
eval `gpg-agent --daemon`
|
||
cp doc/parallel.directive parallel-$YYYYMMDD.tar.bz2.directive
|
||
perl -i -pe "s/20\d\d\d\d\d\d/$YYYYMMDD/" parallel-*.tar.*directive
|
||
gpg --clearsign --yes parallel-$YYYYMMDD.tar.bz2.directive
|
||
|
||
(echo '#!/bin/bash';
|
||
echo;
|
||
echo "# To check the signature run:"
|
||
echo "# echo | gpg"
|
||
echo "# gpg --auto-key-locate keyserver --keyserver-options auto-key-retrieve parallel-$YYYYMMDD.tar.bz2.sig"
|
||
echo
|
||
echo "echo | gpg 2>/dev/null"
|
||
echo 'gpg --auto-key-locate keyserver --keyserver-options auto-key-retrieve $0'
|
||
echo 'exit $?'
|
||
echo
|
||
gpg -ab -o - parallel-$YYYYMMDD.tar.bz2
|
||
) > parallel-$YYYYMMDD.tar.bz2.sig
|
||
|
||
gpg --auto-key-locate keyserver --keyserver-options auto-key-retrieve parallel-$YYYYMMDD.tar.bz2.sig
|
||
|
||
../ftpsync/src/ftpsync parallel-$YYYYMMDD.tar.bz2{,.sig,*asc} ftp://ftp-upload.gnu.org/incoming/alpha/
|
||
|
||
|
||
== 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
|
||
# Reload build-status:
|
||
https://build.opensuse.org/package/show?package=parallel&project=home%3Atange
|
||
# Check that one .deb (Debian 5.0) and one .rpm (CentOS) end with 'succeeded'
|
||
|
||
== Download and test ==
|
||
|
||
# Only needed for alpha (part of 'make upload')
|
||
|
||
YYYYMMDD=`yyyymmdd`
|
||
pushd /tmp
|
||
rm -rf parallel-${YYYYMMDD}*
|
||
# This can take 7 minutes
|
||
#while ! wget http://ftp.gnu.org/gnu/parallel/parallel-$YYYYMMDD.tar.bz2 ; do sleep 2; done
|
||
while ! wget http://alpha.gnu.org/gnu/parallel/parallel-$YYYYMMDD.tar.bz2 ; do sleep 2; done
|
||
tar xjvf parallel-$YYYYMMDD.tar.bz2
|
||
cd parallel-$YYYYMMDD
|
||
./configure
|
||
make -j && sudo make -j install
|
||
pushd
|
||
sudo cp /usr/local/bin/parallel /usr/local/bin/parallel-$YYYYMMDD
|
||
|
||
== 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
|
||
|
||
cp src/*.pdf src/*.html ../parallel-web/parallel
|
||
cp src/parallel.html ../parallel-web/parallel/man.html
|
||
|
||
pushd ../parallel-web/parallel
|
||
cvs up
|
||
cvs ci -m "New release"
|
||
pushd
|
||
|
||
== Commit released version ==
|
||
|
||
git diff
|
||
|
||
# Recheck OBS https://build.opensuse.org/package/show?package=parallel&project=home%3Atange
|
||
|
||
YYYYMMDD=`yyyymmdd`
|
||
TAG=MyTag
|
||
echo "Released as $YYYYMMDD ('$TAG')."
|
||
|
||
git commit -a -m "Released as $YYYYMMDD ('$TAG')"
|
||
git tag -s -m "Released as $YYYYMMDD ('$TAG')" $TAG
|
||
git tag -s -m "Released as $YYYYMMDD ('$TAG')" $YYYYMMDD
|
||
|
||
git push
|
||
git push origin $TAG
|
||
git push origin $YYYYMMDD
|
||
|
||
== Update documentation ==
|
||
|
||
Update version number + 1
|
||
Unmodified beta since last version => production
|
||
Unmodified alpha since last version => beta
|
||
Modified => alpha
|
||
|
||
== Update Savannah ==
|
||
|
||
file:///home/tange/privat/parallel/doc/release_new_version
|
||
|
||
Content from release mail:
|
||
|
||
https://savannah.gnu.org/news/submit.php?group=parallel
|
||
https://savannah.gnu.org/news/approve.php?group=parallel
|
||
|
||
== Update Freshmeat ==
|
||
|
||
// FreeCode is dying
|
||
http://freshmeat.net/projects/parallel/releases/new
|
||
|
||
== Update Diaspora Twitter ==
|
||
|
||
https://joindiaspora.com/stream
|
||
|
||
New release of #GNU Parallel pi․dk/0 New in this release pi․dk/2 See the intro videos pi․dk/1
|
||
10 secs installation: wget -O - pi․dk/3|bash
|
||
|
||
[x] Twitter
|
||
Aspect: Public
|
||
|
||
GNU Parallel - for people who live life in the parallel lane.
|
||
|
||
== Send announce ==
|
||
|
||
http://groups.google.com/group/comp.unix.shell/post
|
||
http://groups.google.com/group/comp.unix.admin/post
|
||
|
||
https://lists.gnu.org/mailman/admindb/bug-parallel
|
||
https://lists.gnu.org/mailman/admindb/parallel
|
||
|
||
<<<<<
|
||
file:///home/tange/privat/parallel/doc/release_new_version
|
||
|
||
from:tange@gnu.org
|
||
to:parallel@gnu.org, bug-parallel@gnu.org
|
||
cc:Tim Cuthbertson <tim3d.junk@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>,
|
||
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>,
|
||
Ryoichiro Suzuki <ryoichiro.suzuki@gmail.com>,
|
||
Jesse Alama <jesse.alama@gmail.com>
|
||
|
||
Subject: GNU Parallel 20150622 ('Løkke') released
|
||
|
||
GNU Parallel 20150622 ('Løkke') has been released. It is available for download at: http://ftp.gnu.org/gnu/parallel/
|
||
|
||
A performance chart has been made to compare the performance of different versions: http://www.gnu.org/software/parallel/boxplot-j2-3.0ghz-3000-1000.pdf The recent jump is due to every job being wrapped in a Perl-script doing setpgrp.
|
||
|
||
Haiku of the month:
|
||
|
||
Programs very slow.
|
||
Multiple can run at once.
|
||
Use GNU Parallel.
|
||
-- Ole Tange
|
||
|
||
New in this release:
|
||
|
||
* --halt has been rewritten completely. You can now combine percentages with success or fail. See the man page.
|
||
|
||
* Exit values 102..254 have been removed. 101 means more than 100 jobs failed.
|
||
|
||
* Killing through --timeout, --memfree, or --halt is now done as a process group (whence the setpgrp wrapper).
|
||
|
||
* --termseq determines which signals are sent when a job is killed.
|
||
|
||
* An empty argument would previously cause no string to be inserted. This is now changed to '' being inserted, thus prepending a space to the output of: parallel echo {} b ::: ''
|
||
|
||
* $PARALLEL_ENV can now be set to an environment prepending the command. Used in env_parallel as mentioned in the manpage.
|
||
|
||
* --retry-failed will retry all failed jobs in a joblog. It will ignore any command given.
|
||
|
||
* --ssh and $PARALLEL_SSH can be used to set the command used for ssh. The command is assumed to behave the same way as ssh.
|
||
|
||
* --fifo now works in csh, too.
|
||
|
||
* Q(...) can be used in {= =} to shell quote a string.
|
||
|
||
* GNU Parallel was cited in: Contrasting regional architectures of schizophrenia and other complex diseases using fast variance components analysis http://biorxiv.org/content/biorxiv/early/2015/06/05/016527.full.pdf
|
||
|
||
* GNU Parallel was cited in: DockBench: An Integrated Informatic Platform Bridging the Gap between the Robust Validation of Docking Protocols and Virtual Screening Simulations http://www.mdpi.com/1420-3049/20/6/9977
|
||
|
||
* GNU Parallel was cited in: Swedes Online: You Are More Tracked Than You Think http://www.diva-portal.org/smash/get/diva2:807623/FULLTEXT01.pdf
|
||
|
||
* GNU Parallel was cited in: Tutorial: Lorenz-Mie theory for 2D scattering and resonance calculations http://arxiv.org/pdf/1505.07691.pdf
|
||
|
||
* GNU Parallel was cited in: A quantitative assessment of the Hadoop framework for analyzing massively parallel DNA sequencing data http://link.springer.com/article/10.1186/s13742-015-0058-5
|
||
|
||
* GNU Parallel was cited in: A composite genome approach to identify phylogenetically informative data from next-generation sequencing http://www.biomedcentral.com/content/pdf/s12859-015-0632-y.pdf
|
||
|
||
* GNU Parallel was cited in: Tutorial: Lorenz-Mie theory for 2D scattering and resonance calculations http://arxiv.org/pdf/1505.07691.pdf
|
||
|
||
* <<Har angiveligt submittet ny version - afventer opdatering>> GNU Parallel was used (unfortunately without citation) in: MUGBAS: a species free gene-based programme suite for post-GWAS analysis http://www.ncbi.nlm.nih.gov/pubmed/25765345
|
||
|
||
* <<Afventer updateret publisering>> GNU Parallel was used in: Large Scale Author Name Disambiguation in Digital Libraries http://ieeexplore.ieee.org/xpl/abstractReferences.jsp?tp=&arnumber=7004487&url=http%3A%2F%2Fieeexplore.ieee.org%2Fxpls%2Fabs_all.jsp%3Farnumber%3D7004487
|
||
|
||
* <<kontaktet 2015-06-22>> GNU Parallel was used (unfortunately with wrong citation) in: TADSim: Discrete Event-Based Performance Prediction for Temperature-Accelerated Dynamics http://vruehle.de/publications/2015c.pdf
|
||
|
||
* << Update forventet juni Rachel har lige svaret >> GNU Parallel was used in: SISRS: Site Identification from Short Read Sequences https://github.com/rachelss/SISRS/
|
||
|
||
* GNU Parallel is used in: taxator-tk http://algbio.cs.uni-duesseldorf.de/webapps/wa-download/
|
||
|
||
* GNU Parallel is used in: https://github.com/d2207197/local-mapreduce
|
||
|
||
* GNU Parallel is used in: wiki-edit-news https://github.com/albert-decatur/wiki-edit-news
|
||
|
||
* GNU Parallel is used in: A Fingerprint Identification System https://curve.carleton.ca/system/files/theses/28733.pdf
|
||
|
||
* Job ad asking for GNU Parallel experience: http://searchjobs.intel.com/gdansk-pol/software-validation-engineer/63A06826DAF24797AB414DC146201C2E/job/
|
||
|
||
* Using BLAT http://wangzhengyuan.blogspot.dk/2015/06/using-blat.html
|
||
|
||
* Bug fixes and man page updates.
|
||
|
||
GNU Parallel - For people who live life in the parallel lane.
|
||
|
||
|
||
= About GNU Parallel =
|
||
|
||
GNU Parallel is a shell tool for executing jobs in parallel using one 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 replace most of the loops and make them run faster by running several jobs in parallel. GNU Parallel can even replace nested loops.
|
||
|
||
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/
|
||
|
||
You can install GNU Parallel in just 10 seconds with: (wget -O - pi.dk/3 || curl pi.dk/3/) | bash
|
||
|
||
Watch the intro video on http://www.youtube.com/playlist?list=PL284C9FF2488BC6D1
|
||
|
||
Walk through the tutorial (man parallel_tutorial). Your commandline will love you for it.
|
||
|
||
When using programs that use GNU Parallel to process data for publication please cite:
|
||
|
||
O. Tange (2011): GNU Parallel - The Command-Line Power Tool, ;login: The USENIX Magazine, February 2011:42-47.
|
||
|
||
If you like GNU Parallel:
|
||
|
||
* Give a demo at your local user group/team/colleagues
|
||
* Post the intro videos on Reddit/Diaspora*/forums/blogs/ Identi.ca/Google+/Twitter/Facebook/Linkedin/mailing lists
|
||
* Get the merchandise https://www.gnu.org/s/parallel/merchandise.html
|
||
* Request or write a review for your favourite blog or magazine
|
||
* Request or build a package for your favourite distribution (if it is not already there)
|
||
* Invite me for your next conference
|
||
|
||
If you use GNU Parallel for research:
|
||
|
||
* Please cite GNU Parallel in you publications (use --bibtex)
|
||
|
||
If GNU Parallel saves you money:
|
||
|
||
* (Have your company) donate to FSF https://my.fsf.org/donate/
|
||
|
||
|
||
= 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 Databases Using DBURLs, ;login: The USENIX Magazine, April 2011:29-32.
|
||
|
||
|
||
= 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.
|