doc/release_new_version

   1 # SPDX-FileCopyrightText: 2021-2022 Ole Tange, http://ole.tange.dk and Free Software and Foundation, Inc.
   2 # SPDX-License-Identifier: GFDL-1.3-or-later
   3 # SPDX-License-Identifier: CC-BY-SA-4.0
   4
   5 = Notes on how to release new version =
   6
   7 == alpha/beta/production ==
   8
   9 Check that documentation is updated (compare to web):
  10
  11 git checkout master
  12 git grep -E '(alpha|beta) testing' | cat
  13 git diff $(date --date="last month" +%Y%m22)
  14 Unmodified beta since last version => production
  15 Unmodified alpha since last version => beta
  16 Modified => alpha
  17
  18 == Update NEWS ==
  19
  20 With the same things that goes in the announce mail
  21
  22 == Testsuite ==
  23
  24 Start termux on Android
  25 Start: wssh mac ping fi.dk
  26 niceload --prg firefox &
  27 cd testsuite;
  28 # With 23 GB RAM free this takes 3m43s
  29 make mem;
  30 # Estimated time: 13m
  31 make long
  32 # Estimated time: 42m
  33 make short
  34
  35 == Update version ==
  36
  37 https://zenodo.org/deposit/new
  38
  39 Do you already have a DOI for this upload? No
  40 (Get a DOI now!)
  41 Resource type: Software
  42 GNU Parallel 20xxxx22 ('Xxxx')
  43 Add creator: Person
  44 Tange, Ole
  45 https://orcid.org/0000-0002-6345-1437
  46 Role: Contact person
  47 Description
  48 GNU Parallel is a general parallelizer to run multiple serial command line programs in parallel without changing them.
  49
  50 License:
  51 gpl
  52
  53 [Save]
  54
  55
  56 DOI=10.5281/zenodo.4381888
  57 SPCTAG='Privacy Shield'
  58
  59 # Update version
  60 . packager/releasescripts/updateversion
  61
  62 # Load doi+tag in other window
  63 . .last-doitag.txt
  64
  65 === Reconfig autoconf/automake, build tar.bz2 and test it ===
  66
  67 . .last-doitag.txt
  68 make reconf &&
  69 make pack_unpack_and_test_build
  70
  71 == Upload ==
  72
  73 . .last-doitag.txt
  74 eval `gpg-agent --daemon`
  75 # Takes up to 8 minutes
  76 make upload
  77
  78 # Only needed for alpha:
  79 . .last-doitag.txt
  80 eval `gpg-agent --daemon`
  81 # Takes up to 8 minutes
  82 make alphaupload
  83
  84 == Update OpenSUSE build system ==
  85
  86 . .last-doitag.txt
  87 cd ~/privat/parallel/packager/obs
  88
  89 find home-tange/parallel/* -type f |
  90   grep -Ev '(PKGBUILD|parallel.spec|Makefile)' |
  91   parallel -j1 'osc rm {} || rm {}'
  92 # This should not create new files
  93 osc up home-tange/parallel/
  94 make
  95 # Reload build-status:
  96 https://build.opensuse.org/package/show/home:tange/parallel
  97 # Check that one .deb (Debian 5.0) and one .rpm (CentOS) end with 'succeeded'
  98
  99 == Upload LBRY ==
 100
 101 lbry://@GnuParallel#4/parallel-20210322.tar.bz2
 102
 103 # An easy way to support GNU Parallel is to tip on LBRY.
 104 #
 105 # :
 106 #
 107 # 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.
 108 #
 109 # Thumbnail: https://www.gnu.org/software/parallel/logo-gray+black10000.png
 110 #
 111 # Tags: gnu parallel software
 112
 113 . .last-doitag.txt
 114 file_path="`pwd`/parallel-$YYYYMMDD.tar.bz2"
 115 title="GNU Parallel $YYYYMMDD ('$SPCTAG') [stable]"
 116
 117 title="GNU Parallel $YYYYMMDD ('$SPCTAG')"
 118 name="GNU-Parallel-$YYYYMMDD-$TAG"
 119 author="Ole Tange"
 120 license="GNU GPLv3 or later"
 121 thumbnail_url=https://www.gnu.org/software/parallel/logo-gray+black10000.png
 122 channel_name="@GnuParallel"
 123 tags_opt='--tag gnu --tag parallel --tag free --tag software'
 124
 125 description="An easy way to support GNU Parallel is to tip on LBRY.
 126
 127 $(perl -ne '/About\sGNU\sParallel/ and exit;/It\sis\savailable/..0 and print' doc/release_new_version)
 128 "
 129 echo "$description" | grep '<<.*>>' && echo STOP STOP STOP ||
 130 echo "$description"
 131
 132 lbrynet publish \
 133   --bid=0.01 \
 134   --file_path="$file_path" \
 135   --name="$name" \
 136   --title="$title" \
 137   --description="$description" \
 138   --author="$author" \
 139   $languages_opt \
 140   $tags_opt \
 141   --license="$license" \
 142   --thumbnail_url="$thumbnail_url" \
 143   --channel_name="$channel_name" \
 144
 145 #  --release_time="$release_time" \
 146
 147 == Update website ==
 148
 149 http://www.gnu.org/software/parallel/
 150 http://www.gnu.org/software/parallel/man.html
 151 http://www.gnu.org/software/parallel/sql.html
 152 http://www.gnu.org/software/parallel/sem.html
 153 http://www.gnu.org/software/parallel/env_parallel.html
 154 http://www.gnu.org/software/parallel/parcat.html
 155 http://www.gnu.org/software/parallel/parset.html
 156 http://www.gnu.org/software/parallel/parsort.html
 157 http://www.gnu.org/software/parallel/niceload.html
 158
 159 make web
 160 cp -r src/*.pdf src/sphinx/build/html/* ../parallel-web/parallel
 161 cp ../parallel-web/parallel/parallel.html  ../parallel-web/parallel/man.html
 162
 163 pushd ../parallel-web/parallel
 164 # Bug at Savannah makes this take 30 seconds
 165 (cd ..;
 166  cvs -z3 -d:ext:tange@cvs.savannah.gnu.org:/web/parallel co parallel)
 167 cvs up
 168 cvs ci -m "New release"
 169 pushd
 170
 171 == Commit released version ==
 172
 173 git diff
 174
 175 # Recheck OBS https://build.opensuse.org/package/show/home:tange/parallel
 176
 177 . .last-doitag.txt
 178 echo "Released as $YYYYMMDD ('$TAG')." | grep MyTag && (STOP;STOP;STOP)
 179 echo "$TAG" | grep ' ' && (STOP;STOP;STOP)
 180 echo "Released as $YYYYMMDD ('$SPCTAG')."
 181
 182 git commit -a -m "Released as $YYYYMMDD ('$SPCTAG')"
 183 git tag -s -u 88888888 -m "Released as $YYYYMMDD ('$SPCTAG')" $TAG
 184 git tag -s -u 88888888 -m "Released as $YYYYMMDD ('$SPCTAG')" $YYYYMMDD
 185
 186 torsocks git push
 187 torsocks git push origin $TAG
 188 torsocks git push origin $YYYYMMDD
 189
 190 git branch -d premaster
 191 git branch premaster
 192
 193
 194 == Zenodo ==
 195
 196 Add tar.bz2 [Start upload] and [Publish].
 197
 198 == Update documentation ==
 199
 200 Update version number + 1
 201
 202 export YYYYMMDD=`yyyymmdd`
 203 export YYYYMMDD=${YYYYMMDD:0:6}23
 204 echo $YYYYMMDD
 205 perl -i -pe "/version/ and s/20\d\d\d\d\d\d/$YYYYMMDD/" src/parallel
 206 perl -i -pe "/version/ and s/20\d\d\d\d\d\d/$YYYYMMDD/" src/sql
 207 perl -i -pe "/version/ and s/20\d\d\d\d\d\d/$YYYYMMDD/" src/env_parallel*
 208 perl -i -pe "/version/ and s/20\d\d\d\d\d\d/$YYYYMMDD/" src/parsort
 209 perl -i -pe "/version/ and s/20\d\d\d\d\d\d/$YYYYMMDD/" src/niceload
 210
 211 Unmodified beta since last version => production
 212 Unmodified alpha since last version => beta
 213 Modified => alpha
 214
 215
 216 == Check URLs ==
 217
 218 make testurls
 219
 220 == Check REUSE ==
 221
 222 make reuse
 223
 224 https://api.reuse.software/info/git.savannah.gnu.org/git/parallel
 225 https://api.reuse.software/status/git.savannah.gnu.org/git/parallel
 226
 227 == Update Savannah ==
 228
 229 file:///home/tange/privat/parallel/doc/release_new_version
 230
 231 Content from release mail:
 232
 233 https://savannah.gnu.org/news/submit.php?group=parallel
 234
 235 Test URLs.
 236
 237 https://savannah.gnu.org/news/approve.php?group=parallel
 238
 239 == Update Freshmeat ==
 240
 241 // FreeCode is dying
 242 http://freshmeat.net/projects/parallel/releases/new
 243
 244 == Update Mastodon Twitter ==
 245
 246 https://hostux.social/@GNU_Parallel
 247
 248 New release of #GNU Parallel pi.dk/0
 249 New in this release pi.dk/2
 250 See the intro videos pi.dk/1
 251 10 secs installation: pi.dk/3
 252
 253 GNU Parallel - for people who live life in the parallel lane.
 254
 255 == Send announce ==
 256
 257 http://groups.google.com/group/comp.unix.shell/post
 258 http://groups.google.com/group/comp.unix.admin/post
 259
 260 https://lists.gnu.org/mailman/admindb/bug-parallel
 261 https://lists.gnu.org/mailman/admindb/parallel
 262
 263 file:///home/tange/privat/parallel/doc/release_new_version
 264
 265 For codename look at https://www.onthisday.com/
 266
 267 from:tange@gnu.org
 268 to:parallel@gnu.org, bug-parallel@gnu.org
 269 stable-bcc: Jesse Alama <jessealama@fastmail.fm>
 270
 271 Subject: GNU Parallel 20240822 ('Southport') released
 272
 273 GNU Parallel 20240822 ('Southport') has been released. It is available for download at: lbry://@GnuParallel:4
 274
 275 Quote of the month:
 276
 277   honestly the coolest software i've ever seen gotta be gnu parallel or
 278   ffmpeg, nothing like them
 279     -- @scootykins scoot
 280
 281 New in this release:
 282
 283 * --match Match input source with regexp to set replacement fields.
 284
 285 * {:%fmt} Use printf formatting of replacement strings.
 286
 287 * Bug fixes and man page updates.
 288
 289
 290 News about GNU Parallel:
 291
 292 * Powerful GNU parallel, more than a loop https://www.linkedin.com/pulse/powerful-gnu-parallel-more-than-loop-zhenguo-zhang-18dxc
 293
 294 * How To Increase File Transfer Speed Using Parallel Rsync? https://contentbase.com/blog/increase-file-transfer-speed-parallel-rsync/
 295
 296 * Converting WebP Images to PNG Using parallel and dwebp https://bytefreaks.net/2024/07/27
 297
 298 * Turbocharging the Box CLI with GNU Parallel https://medium.com/box-developer-blog/turbocharging-the-box-cli-with-gnu-parallel-ee44c48811c0
 299
 300
 301 GNU Parallel - For people who live life in the parallel lane.
 302
 303 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.
 304
 305
 306 = About GNU Parallel =
 307
 308 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.
 309
 310 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.
 311
 312 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.
 313
 314 For example you can run this to convert all jpeg files into png and gif files and have a progress bar:
 315
 316   parallel --bar convert {1} {1.}.{2} ::: *.jpg ::: png gif
 317
 318 Or you can generate big, medium, and small thumbnails of all jpeg files in sub dirs:
 319
 320   find . -name '*.jpg' |
 321     parallel convert -geometry {2} {1} {1//}/thumb{2}_{1/} :::: - ::: 50 100 200
 322
 323 You can find more about GNU Parallel at: http://www.gnu.org/s/parallel/
 324
 325 You can install GNU Parallel in just 10 seconds with:
 326
 327     $ (wget -O - pi.dk/3 || lynx -source pi.dk/3 || curl pi.dk/3/ || \
 328        fetch -o - http://pi.dk/3 ) > install.sh
 329     $ sha1sum install.sh | grep 883c667e01eed62f975ad28b6d50e22a
 330     12345678 883c667e 01eed62f 975ad28b 6d50e22a
 331     $ md5sum install.sh | grep cc21b4c943fd03e93ae1ae49e28573c0
 332     cc21b4c9 43fd03e9 3ae1ae49 e28573c0
 333     $ sha512sum install.sh | grep ec113b49a54e705f86d51e784ebced224fdff3f52
 334     79945d9d 250b42a4 2067bb00 99da012e c113b49a 54e705f8 6d51e784 ebced224
 335     fdff3f52 ca588d64 e75f6033 61bd543f d631f592 2f87ceb2 ab034149 6df84a35
 336     $ bash install.sh
 337
 338 Watch the intro video on http://www.youtube.com/playlist?list=PL284C9FF2488BC6D1
 339
 340 Walk through the tutorial (man parallel_tutorial). Your command line will love you for it.
 341
 342 When using programs that use GNU Parallel to process data for publication please cite:
 343
 344 O. Tange (2018): GNU Parallel 2018, March 2018, https://doi.org/10.5281/zenodo.1146014.
 345
 346 If you like GNU Parallel:
 347
 348 * Give a demo at your local user group/team/colleagues
 349 * Post the intro videos on Reddit/Diaspora*/forums/blogs/ Identi.ca/Google+/Twitter/Facebook/Linkedin/mailing lists
 350 * Get the merchandise https://gnuparallel.threadless.com/designs/gnu-parallel
 351 * Request or write a review for your favourite blog or magazine
 352 * Request or build a package for your favourite distribution (if it is not already there)
 353 * Invite me for your next conference
 354
 355 If you use programs that use GNU Parallel for research:
 356
 357 * Please cite GNU Parallel in you publications (use --citation)
 358
 359 If GNU Parallel saves you money:
 360
 361 * (Have your company) donate to FSF https://my.fsf.org/donate/
 362
 363
 364 = About GNU SQL =
 365
 366 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.
 367
 368 The database is addressed using a DBURL. If commands are left out you will get that database's interactive shell.
 369
 370 When using GNU SQL for a publication please cite:
 371
 372 O. Tange (2011): GNU SQL - A Command Line Tool for Accessing Different Databases Using DBURLs, ;login: The USENIX Magazine, April 2011:29-32.
 373
 374
 375 = About GNU Niceload =
 376
 377 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.