parallel/doc/release_new_version

332 lines
12 KiB
Plaintext
Raw Normal View History

2010-06-05 23:03:39 +00:00
= Notes on how to release new version =
== alpha/beta/production ==
2014-09-22 16:26:25 +00:00
Check that documentation is updated (compare to web):
git grep -E '(alpha|beta) testing' | cat
2019-04-21 18:16:33 +00:00
git diff $(date --date="last month" +%Y%m22)
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: AC_INIT([parallel], [20100422], [bug-parallel@gnu.org])
src/parallel: $Global::version = 20100422;
2013-04-11 19:55:33 +00:00
README: parallel-20130222
2018-11-22 23:40:20 +00:00
YYYYMMDD=$(echo `yyyymmdd`-1 | bc)
2017-02-21 23:30:36 +00:00
YYYYMMDD=$(echo `yyyymmdd`+1 | bc)
2010-06-05 23:03:39 +00:00
YYYYMMDD=`yyyymmdd`
2017-02-21 23:30:36 +00:00
echo $YYYYMMDD
2013-04-11 19:55:33 +00:00
perl -i -pe "s/20\d\d\d\d\d\d/$YYYYMMDD/" configure.ac
2010-06-05 23:03:39 +00:00
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
2013-04-11 19:55:33 +00:00
perl -i -pe "s/parallel-20\d\d\d\d\d\d/parallel-$YYYYMMDD/" README
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
cd testsuite; make mem; 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`
export YYYYMMDD
2015-04-22 23:16:59 +00:00
eval `gpg-agent --daemon`
2017-01-21 17:36:17 +00:00
# Takes up to 8 minutes
make upload
# Only needed for alpha:
2017-02-21 23:30:36 +00:00
YYYYMMDD=`yyyymmdd`
export YYYYMMDD
eval `gpg-agent --daemon`
2017-02-21 23:30:36 +00:00
# Takes up to 8 minutes
make alphaupload
2013-05-16 20:49:17 +00:00
== Update OpenSUSE build system ==
cd ~/privat/parallel/packager/obs
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:
2017-06-22 12:22:23 +00:00
https://build.opensuse.org/package/show/home:tange/parallel
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 ==
# Only needed for alpha (part of 'make upload')
2011-03-22 00:44:50 +00:00
YYYYMMDD=`yyyymmdd`
pushd /tmp
rm -rf parallel-${YYYYMMDD}*
2014-02-22 10:32:42 +00:00
# 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
2013-07-22 10:54:02 +00:00
sudo cp /usr/local/bin/parallel /usr/local/bin/parallel-$YYYYMMDD
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/env_parallel.html
http://www.gnu.org/software/parallel/parset.html
http://www.gnu.org/software/parallel/parcat.html
http://www.gnu.org/software/parallel/niceload.html
2010-06-08 14:13:20 +00:00
2013-09-20 23:25:06 +00:00
cp src/*.pdf src/*.html ../parallel-web/parallel
cp src/parallel.html ../parallel-web/parallel/man.html
pushd ../parallel-web/parallel
2019-04-21 18:16:33 +00:00
# Bug at Savannah makes this take 30 seconds
torsocks cvs up
torsocks cvs ci -m "New release"
pushd
2010-06-08 14:13:20 +00:00
2011-03-22 00:44:50 +00:00
== Commit released version ==
git diff
# Recheck OBS https://build.opensuse.org/package/show?package=parallel&project=home%3Atange
2014-03-23 00:07:18 +00:00
2014-04-09 03:11:51 +00:00
YYYYMMDD=`yyyymmdd`
TAG=MyTag
echo "Released as $YYYYMMDD ('$TAG')." | grep MyTag && (STOP;STOP;STOP)
2017-10-09 22:33:43 +00:00
echo "$TAG" | grep ' ' && (STOP;STOP;STOP)
echo "Released as $YYYYMMDD ('$TAG')."
2015-04-27 18:56:34 +00:00
git commit -a -m "Released as $YYYYMMDD ('$TAG')"
git tag -s -u 88888888 -m "Released as $YYYYMMDD ('$TAG')" $TAG
git tag -s -u 88888888 -m "Released as $YYYYMMDD ('$TAG')" $YYYYMMDD
2014-04-09 03:11:51 +00:00
2019-04-21 18:16:33 +00:00
torsocks git push
torsocks git push origin $TAG
torsocks git push origin $YYYYMMDD
== Update documentation ==
Update version number + 1
YYYYMMDD=$(echo `yyyymmdd`+1 | bc)
echo $YYYYMMDD
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
Unmodified beta since last version => production
Unmodified alpha since last version => beta
Modified => alpha
== Check URLs ==
make testurls
2011-07-25 22:12:46 +00:00
== Update Savannah ==
file:///home/tange/privat/parallel/doc/release_new_version
2011-07-25 22:12:46 +00:00
Content from release mail:
https://savannah.gnu.org/news/submit.php?group=parallel
2015-08-22 10:05:56 +00:00
Test URLs.
2011-07-25 22:12:46 +00:00
https://savannah.gnu.org/news/approve.php?group=parallel
2010-06-05 23:03:39 +00:00
== Update Freshmeat ==
// FreeCode is dying
2010-06-05 23:03:39 +00:00
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
2015-02-01 13:38:26 +00:00
https://joindiaspora.com/stream
2017-06-05 09:26:39 +00:00
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
2010-11-13 16:04:58 +00:00
2012-01-24 20:53:25 +00:00
[x] Twitter
Aspect: Public
2010-11-13 16:04:58 +00:00
2013-09-20 23:25:06 +00:00
GNU Parallel - for people who live life in the parallel lane.
2010-06-05 23:03:39 +00:00
== Send announce ==
http://groups.google.com/group/comp.unix.shell/post
http://groups.google.com/group/comp.unix.admin/post
2011-04-23 12:01:22 +00:00
https://lists.gnu.org/mailman/admindb/bug-parallel
https://lists.gnu.org/mailman/admindb/parallel
2014-02-22 10:32:42 +00:00
file:///home/tange/privat/parallel/doc/release_new_version
from:tange@gnu.org
2012-01-07 01:24:50 +00:00
to:parallel@gnu.org, bug-parallel@gnu.org
2017-08-12 16:37:52 +00:00
stable-bcc: Jesse Alama <jessealama@fastmail.fm>
2019-04-21 18:16:33 +00:00
Subject: GNU Parallel 20190422 ('Invitation Assange') released <<[stable]>>
2010-06-05 23:03:39 +00:00
2019-04-21 18:16:33 +00:00
GNU Parallel 20190422 ('Invitation') <<[stable]>> has been released. It is available for download at: http://ftpmirror.gnu.org/parallel/
2014-05-22 12:53:33 +00:00
2019-04-21 18:16:33 +00:00
No new functionality was introduced so this is a good candidate for a stable release.
2015-06-22 19:23:26 +00:00
2019-04-21 18:16:33 +00:00
GNU Parallel is 10 years old in a year on 2020-04-22. You are here by invited to a reception on Friday 2020-04-17.
The primary reception will be held in Copenhagen, DK. Please reserve the date and email happybirthdaygnuparallel@tange.dk if you want to join.
If you cannot make it, you are encouraged to host a parallel party.
So far we hope to have parallel parties at:
2018-01-22 16:23:23 +00:00
2019-04-21 18:16:33 +00:00
+verbatim+
PROSA
Vester Farimagsgade 37A
DK-1606 København V
RSVP: happybirthdaygnuparallel@tange.dk
PROSA
Søren Frichs Vej 38 K th
DK-8230 Åbyhøj
RSVP: To be determined
2019-04-21 18:16:33 +00:00
PROSA
Overgade 54
DK-5000 Odense C
RSVP: To be determined
-verbatim-
2019-04-21 18:16:33 +00:00
If you want to host a party held in parallel (either in this or in a parallel universe), please let me know, so it can be announced.
If you have parallel ideas for how to celebrate GNU Parallel, please post on the email list parallel@gnu.org. So far we have the following ideas:
2019-04-21 18:16:33 +00:00
* Use GNU Parallel logo (the café wall illusion) as decoration everywhere preferably in a moving version where the bars slide. Maybe we can borrow this https://www.youtube.com/watch?v=_XFDnFLqRFE or make an animation in javascript based on https://bl.ocks.org/Fil/13177d3c911fb8943cb0013086469b87? Other illusions might be fun, too.
* Only serve beverages in parallel (2 or more), which may or may not be the same kind of beverage, and may or may not be served to the same person, and may or may not be served by multiple waiters in parallel
* Let people drink in parallel with straws (2 or more straws)
* Serve popcorn as snack (funny because cores and kernels are the same word in Danish, and GNU Parallel keeps cores hot)
* Serve saltstænger and similar parallel snacks.
* Serve (snack friendly) cereal in parallel bowls.
* Live parallel streaming from parallel parties
* Play songs in parallel that use the same 4 chords: https://www.youtube.com/watch?v=5pidokakU4I
* Play songs named parallel, serial, mutex, race condition and similar
* Have RC racing cars to demonstrate race condition
* Put a counting semaphore on the toilets
* Only let people leave one at a time to simulate serialized output UNLESS they swap some clothing (to simulate half line mixing)
2019-04-21 18:16:33 +00:00
If you have interesting stories about or uses of GNU Parallel, please post them, so can be part of the anniversary update.
Quote of the month:
Y'all need some GNU parallel in your lives
-- ChaKu @ChaiLovesChai@twitter
New in this release:
2019-04-21 18:16:33 +00:00
* Invitation to the 10 years anniversary next year.
2019-04-21 18:16:33 +00:00
* The Austin Linux Meetup: KVM as Hypervisor and GNU Parallel https://www.meetup.com/linuxaustin/events/jbxcnqyzgbpb/
* Bug fixes and man page updates.
Get the book: GNU Parallel 2018 http://www.lulu.com/shop/ole-tange/gnu-parallel-2018/paperback/product-23558902.html
GNU Parallel - For people who live life in the parallel lane.
2010-06-05 23:03:39 +00:00
= About GNU Parallel =
GNU Parallel is a shell tool for executing jobs in parallel using one or more computers. A job 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.
2011-01-27 21:56:59 +00:00
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.
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.
2010-06-05 23:03:39 +00:00
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/ || fetch -o - http://pi.dk/3) | bash
Watch the intro video on http://www.youtube.com/playlist?list=PL284C9FF2488BC6D1
Walk through the tutorial (man parallel_tutorial). Your command line will love you for it.
When using programs that use GNU Parallel to process data for publication please cite:
O. Tange (2018): GNU Parallel 2018, March 2018, https://doi.org/10.5281/zenodo.1146014.
2011-05-13 12:02:03 +00:00
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://gnuparallel.threadless.com/designs/gnu-parallel
* 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 programs that use GNU Parallel for research:
* Please cite GNU Parallel in you publications (use --citation)
If GNU Parallel saves you money:
* (Have your company) donate to FSF https://my.fsf.org/donate/
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.
2011-05-13 12:02:03 +00:00
The database is addressed using a DBURL. If commands are left out you will get that database's interactive shell.
2011-05-13 12:02:03 +00:00
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.
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.