2021-12-26 22:29:28 +00:00
# SPDX-FileCopyrightText: 2021-2022 Ole Tange, http://ole.tange.dk and Free Software and Foundation, Inc.
2021-04-22 16:20:41 +00:00
# SPDX-License-Identifier: GFDL-1.3-or-later
# SPDX-License-Identifier: CC-BY-SA-4.0
2010-06-05 23:03:39 +00:00
= Notes on how to release new version =
2011-07-18 16:29:37 +00:00
== alpha/beta/production ==
2014-09-22 16:26:25 +00:00
Check that documentation is updated (compare to web):
2011-07-18 16:29:37 +00:00
2018-03-24 23:19:08 +00:00
git grep -E '(alpha|beta) testing' | cat
2019-04-21 18:16:33 +00:00
git diff $(date --date="last month" +%Y%m22)
2011-07-18 16:29:37 +00:00
Unmodified beta since last version => production
2011-08-21 23:01:57 +00:00
Unmodified alpha since last version => beta
Modified => alpha
2011-07-18 16:29:37 +00:00
2020-05-31 14:42:04 +00:00
== Update NEWS ==
2010-06-05 23:03:39 +00:00
2020-05-31 14:42:04 +00:00
With the same things that goes in the announce mail
2020-05-23 18:04:09 +00:00
2020-05-31 14:42:04 +00:00
== Testsuite ==
2014-05-23 17:57:04 +00:00
2021-01-21 20:01:30 +00:00
Start termux on Android
Start: wssh mac ping fi.dk
2021-07-22 20:31:06 +00:00
cd testsuite; make mem; make polar; make long; make short
2020-05-23 18:04:09 +00:00
2020-05-31 14:42:04 +00:00
== Update version ==
2010-06-05 23:03:39 +00:00
2020-05-31 14:42:04 +00:00
https://zenodo.org/deposit/new
2010-06-05 23:03:39 +00:00
2020-05-31 14:42:04 +00:00
(*) Software
(Reserve DOI)
2020-08-07 20:20:30 +00:00
GNU Parallel 20xxxx22 ('Xxxx')
2020-10-26 19:41:00 +00:00
Tange, Ole
2020-05-31 14:42:04 +00:00
https://orcid.org/0000-0002-6345-1437
Description
GNU Parallel is a general parallelizer to run multiple serial command line programs in parallel without changing them.
2010-06-05 23:03:39 +00:00
2020-05-31 14:42:04 +00:00
License:
gpl v3
2010-07-18 02:17:49 +00:00
2020-05-31 14:42:04 +00:00
[Save]
2010-07-18 02:17:49 +00:00
2020-12-30 12:42:02 +00:00
10.5281/zenodo.4381888
2020-07-22 21:06:03 +00:00
DOINO=3956817
2021-04-22 16:20:41 +00:00
SPCTAG='Privacy Shield'
2010-06-05 23:03:39 +00:00
2020-05-31 14:42:04 +00:00
# Update version
. packager/releasescripts/updateversion
2010-06-05 23:03:39 +00:00
2020-11-22 15:22:54 +00:00
# Load doi+tag in other window
. .last-doitag.txt
2020-05-31 14:42:04 +00:00
=== Reconfig autoconf/automake, build tar.bz2 and test it ===
2010-08-22 09:00:52 +00:00
2021-04-22 16:20:41 +00:00
. .last-doitag.txt
2020-05-31 14:42:04 +00:00
make reconf &&
make pack_unpack_and_test_build
2010-08-22 09:00:52 +00:00
2010-06-05 23:03:39 +00:00
== Upload ==
2020-11-22 15:22:54 +00:00
. .last-doitag.txt
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
2015-01-21 21:24:23 +00:00
make upload
2015-01-11 22:08:23 +00:00
2015-01-21 21:24:23 +00:00
# Only needed for alpha:
2020-11-22 15:22:54 +00:00
. .last-doitag.txt
2015-01-21 21:24:23 +00:00
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
2011-07-22 09:08:58 +00:00
== Update OpenSUSE build system ==
2020-11-22 15:22:54 +00:00
. .last-doitag.txt
2011-07-22 09:08:58 +00:00
cd ~/privat/parallel/packager/obs
2013-09-18 00:00:10 +00:00
2020-05-31 14:42:04 +00:00
find home:tange/parallel/* -type f |
2020-08-07 20:20:30 +00:00
grep -Ev '(PKGBUILD|parallel.spec)' |
2020-05-31 14:42:04 +00:00
parallel -j1 'osc rm {} || rm {}'
2011-07-22 09:08:58 +00:00
# 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'
2011-07-22 09:08:58 +00:00
2021-04-22 16:20:41 +00:00
== Upload LBRY ==
2021-05-22 23:18:09 +00:00
lbry://@GnuParallel#4/parallel-20210322.tar.bz2
2021-04-22 16:20:41 +00:00
2021-07-11 14:59:27 +00:00
# An easy way to support GNU Parallel is to tip on LBRY.
#
# :
#
# If you like GNU Parallel record a video testimonial: Say who you are, what you use GNU Parallel for, how it helps you, and what you like most about it. Include a command that uses GNU Parallel if you feel like it.
#
# Thumbnail: https://www.gnu.org/software/parallel/logo-gray+black10000.png
#
# Tags: gnu parallel software
2021-04-22 16:20:41 +00:00
2021-08-22 20:05:37 +00:00
. .last-doitag.txt
2021-07-22 20:31:06 +00:00
file_path="`pwd`/parallel-$YYYYMMDD.tar.bz2"
title="GNU Parallel $YYYYMMDD ('$SPCTAG')"
name="GNU-Parallel-$YYYYMMDD-$TAG"
2021-06-22 17:40:07 +00:00
author="Ole Tange"
license="GNU GPLv3 or later"
thumbnail_url=https://www.gnu.org/software/parallel/logo-gray+black10000.png
channel_name="@GnuParallel"
tags_opt='--tag gnu --tag parallel --tag free --tag software'
2021-07-11 14:59:27 +00:00
description="An easy way to support GNU Parallel is to tip on LBRY.
2021-06-22 17:40:07 +00:00
2021-07-11 14:59:27 +00:00
$(perl -ne '/About\sGNU\sParallel/ and exit;/It\sis\savailable/..0 and print' doc/release_new_version)
2021-06-22 17:40:07 +00:00
"
2021-07-11 14:59:27 +00:00
echo "$description" | grep '<<.*>>' && echo STOP STOP STOP
echo "$description"
2021-04-22 16:20:41 +00:00
lbrynet publish \
--bid=0.01 \
--file_path="$file_path" \
--name="$name" \
--title="$title" \
--description="$description" \
--author="$author" \
$languages_opt \
$tags_opt \
--license="$license" \
--thumbnail_url="$thumbnail_url" \
--channel_name="$channel_name" \
2021-07-11 14:59:27 +00:00
# --release_time="$release_time" \
2021-04-22 16:20:41 +00:00
2010-06-08 14:13:20 +00:00
== Update website ==
http://www.gnu.org/software/parallel/
http://www.gnu.org/software/parallel/man.html
2010-12-21 17:08:16 +00:00
http://www.gnu.org/software/parallel/sql.html
http://www.gnu.org/software/parallel/sem.html
2017-04-22 21:23:24 +00:00
http://www.gnu.org/software/parallel/env_parallel.html
http://www.gnu.org/software/parallel/parcat.html
2020-04-22 18:15:59 +00:00
http://www.gnu.org/software/parallel/parset.html
http://www.gnu.org/software/parallel/parsort.html
2010-12-21 17:08:16 +00:00
http://www.gnu.org/software/parallel/niceload.html
2010-06-08 14:13:20 +00:00
2021-08-03 20:50:03 +00:00
make web
2021-07-22 20:31:06 +00:00
cp -r src/*.pdf src/sphinx/build/html/* ../parallel-web/parallel
cp ../parallel-web/parallel/parallel.html ../parallel-web/parallel/man.html
2013-09-20 23:25:06 +00:00
2011-07-22 09:08:58 +00:00
pushd ../parallel-web/parallel
2019-04-21 18:16:33 +00:00
# Bug at Savannah makes this take 30 seconds
2021-03-22 20:16:35 +00:00
(cd ..;
torsocks cvs -z3 -d:ext:tange@cvs.savannah.gnu.org:/web/parallel co parallel)
2019-04-21 18:16:33 +00:00
torsocks cvs up
torsocks cvs ci -m "New release"
2011-07-22 09:08:58 +00:00
pushd
2010-06-08 14:13:20 +00:00
2011-03-22 00:44:50 +00:00
== Commit released version ==
git diff
2013-09-18 00:00:10 +00:00
2020-05-08 01:35:51 +00:00
# Recheck OBS https://build.opensuse.org/package/show/home:tange/parallel
2014-03-23 00:07:18 +00:00
2020-12-07 15:24:54 +00:00
. .last-doitag.txt
2017-04-01 00:59:07 +00:00
echo "Released as $YYYYMMDD ('$TAG')." | grep MyTag && (STOP;STOP;STOP)
2017-10-09 22:33:43 +00:00
echo "$TAG" | grep ' ' && (STOP;STOP;STOP)
2021-04-22 16:20:41 +00:00
echo "Released as $YYYYMMDD ('$SPCTAG')."
2015-03-24 23:14:50 +00:00
2021-04-22 16:20:41 +00:00
git commit -a -m "Released as $YYYYMMDD ('$SPCTAG')"
git tag -s -u 88888888 -m "Released as $YYYYMMDD ('$SPCTAG')" $TAG
git tag -s -u 88888888 -m "Released as $YYYYMMDD ('$SPCTAG')" $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
2014-08-24 15:19:17 +00:00
2020-05-31 14:42:04 +00:00
== Zenodo ==
2020-08-29 20:12:46 +00:00
Add tar.bz2 [Start upload] and [Publish].
2018-07-22 06:58:32 +00:00
2014-08-24 15:19:17 +00:00
== Update documentation ==
Update version number + 1
2016-03-22 23:20:42 +00:00
2020-05-31 14:42:04 +00:00
export YYYYMMDD=`yyyymmdd`
export YYYYMMDD=${YYYYMMDD:0:6}23
2019-01-25 05:16:35 +00:00
echo $YYYYMMDD
2016-03-22 23:20:42 +00:00
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
2020-10-26 19:41:00 +00:00
perl -i -pe "/version/ and s/20\d\d\d\d\d\d/$YYYYMMDD/" src/env_parallel*
2020-08-29 20:12:46 +00:00
perl -i -pe "/version/ and s/20\d\d\d\d\d\d/$YYYYMMDD/" src/parsort
2016-03-22 23:20:42 +00:00
perl -i -pe "/version/ and s/20\d\d\d\d\d\d/$YYYYMMDD/" src/niceload
2014-08-24 15:19:17 +00:00
Unmodified beta since last version => production
Unmodified alpha since last version => beta
Modified => alpha
2018-07-22 06:58:32 +00:00
== Check URLs ==
make testurls
2021-03-22 20:16:35 +00:00
== Check REUSE ==
make reuse
https://api.reuse.software/info/git.savannah.gnu.org/git/parallel
https://api.reuse.software/status/git.savannah.gnu.org/git/parallel
2018-07-22 06:58:32 +00:00
2011-07-25 22:12:46 +00:00
== Update Savannah ==
2014-05-03 22:42:52 +00:00
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 ==
2014-06-25 23:16:54 +00:00
// 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
2021-08-03 20:50:03 +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: https://git.savannah.gnu.org/cgit/parallel.git/tree/README
2010-11-13 16:04:58 +00:00
2012-01-24 20:53:25 +00:00
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 ==
2010-06-25 23:56:14 +00:00
http://groups.google.com/group/comp.unix.shell/post
2013-06-30 16:11:36 +00:00
http://groups.google.com/group/comp.unix.admin/post
2010-06-14 22:05:47 +00:00
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
2020-09-19 14:47:01 +00:00
For codename look at https://www.onthisday.com/
2010-09-01 13:26:45 +00:00
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>
2021-12-26 22:29:28 +00:00
Subject: GNU Parallel 20220122 ('James Webb/Tutu/Pillar of Shame<<>>') released <<[stable]>>
2014-05-22 12:53:33 +00:00
2021-12-26 22:29:28 +00:00
GNU Parallel 20220122 ('<<>>') <<[stable]>> has been released. It is available for download at: lbry://@GnuParallel:4
2021-11-22 23:59:51 +00:00
2021-12-26 22:29:28 +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
Quote of the month:
2021-01-21 20:01:30 +00:00
2021-12-26 22:29:28 +00:00
<<>>
2020-05-08 01:35:51 +00:00
2019-04-21 18:16:33 +00:00
New in this release:
2021-01-17 11:19:57 +00:00
2020-01-22 17:03:29 +00:00
* Bug fixes and man page updates.
News about GNU Parallel:
2021-12-26 22:29:28 +00:00
* https://morioh.com/p/a01b883dc57c
2021-08-03 20:50:03 +00:00
2021-12-26 22:29:28 +00:00
https://sachachua.com/blog/2021/12/re-encoding-the-emacsconf-videos-with-ffmpeg-and-gnu-parallel/
https://learntutorials.net/ja/bash/topic/10778/%E5%B9%B3%E8%A1%8C
<<>>
2020-03-15 03:28:12 +00:00
2018-09-06 15:00:29 +00:00
Get the book: GNU Parallel 2018 http://www.lulu.com/shop/ole-tange/gnu-parallel-2018/paperback/product-23558902.html
2014-05-03 22:42:52 +00:00
GNU Parallel - For people who live life in the parallel lane.
2011-03-01 22:04:15 +00:00
2020-12-30 12:42:02 +00:00
If you like GNU Parallel record a video testimonial: Say who you are, what you use GNU Parallel for, how it helps you, and what you like most about it. Include a command that uses GNU Parallel if you feel like it.
2020-10-12 23:17:14 +00:00
2014-05-23 17:57:04 +00:00
2010-06-05 23:03:39 +00:00
= About GNU Parallel =
2016-01-28 22:45:11 +00:00
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
2014-01-25 22:29:25 +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
2014-01-25 22:29:25 +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
2019-07-31 20:38:30 +00:00
For example you can run this to convert all jpeg files into png and gif files and have a progress bar:
parallel --bar convert {1} {1.}.{2} ::: *.jpg ::: png gif
Or you can generate big, medium, and small thumbnails of all jpeg files in sub dirs:
find . -name '*.jpg' |
parallel convert -geometry {2} {1} {1//}/thumb{2}_{1/} :::: - ::: 50 100 200
2014-01-25 22:29:25 +00:00
You can find more about GNU Parallel at: http://www.gnu.org/s/parallel/
2010-06-14 22:05:47 +00:00
2018-12-28 11:47:25 +00:00
You can install GNU Parallel in just 10 seconds with:
2019-07-31 20:38:30 +00:00
$ (wget -O - pi.dk/3 || lynx -source pi.dk/3 || curl pi.dk/3/ || \
fetch -o - http://pi.dk/3 ) > install.sh
2021-03-23 21:11:02 +00:00
$ sha1sum install.sh | grep c82233e7da3166308632ac8c34f850c0
12345678 c82233e7 da316630 8632ac8c 34f850c0
$ md5sum install.sh | grep ae3d7aac5e15cf3dfc87046cfc5918d2
ae3d7aac 5e15cf3d fc87046c fc5918d2
$ sha512sum install.sh | grep dfc00d823137271a6d96225cea9e89f533ff6c81f
9c5198d5 31a3b755 b7910ece 3a42d206 c804694d fc00d823 137271a6 d96225ce
a9e89f53 3ff6c81f f52b298b ef9fb613 2d3f9ccd 0e2c7bd3 c35978b5 79acb5ca
2019-07-31 20:38:30 +00:00
$ bash install.sh
2013-04-27 09:09:46 +00:00
2014-01-25 22:29:25 +00:00
Watch the intro video on http://www.youtube.com/playlist?list=PL284C9FF2488BC6D1
2013-09-18 00:00:10 +00:00
2018-12-28 11:47:25 +00:00
Walk through the tutorial (man parallel_tutorial). Your command line will love you for it.
2010-06-14 22:05:47 +00:00
2014-01-25 22:29:25 +00:00
When using programs that use GNU Parallel to process data for publication please cite:
2011-03-14 16:37:30 +00:00
2018-10-22 22:46:38 +00:00
O. Tange (2018): GNU Parallel 2018, March 2018, https://doi.org/10.5281/zenodo.1146014.
2011-05-13 12:02:03 +00:00
2014-10-07 22:27:13 +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
2018-03-24 23:19:08 +00:00
* Get the merchandise https://gnuparallel.threadless.com/designs/gnu-parallel
2014-10-07 22:27:13 +00:00
* 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
2016-05-22 20:43:53 +00:00
If you use programs that use GNU Parallel for research:
2014-10-07 22:27:13 +00:00
2016-05-22 20:43:53 +00:00
* Please cite GNU Parallel in you publications (use --citation)
2014-10-07 22:27:13 +00:00
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 =
2014-01-25 22:29:25 +00:00
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
2014-01-25 22:29:25 +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:
2014-01-25 22:29:25 +00:00
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 =
2014-01-25 22:29:25 +00:00
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.