[gnuastro-commits] master bc3d9336: Release: routine post-release operations

[Mohammad Akhlaghi]

branch: master
commit bc3d93368dd03b129f25a9a5c2ace5a533cb761f
Author: Mohammad Akhlaghi <mohammad@akhlaghi.org>
Commit: Mohammad Akhlaghi <mohammad@akhlaghi.org>

    Release: routine post-release operations
    
    Until now, in the previous commit, Gnuastro 0.22 was released. To be
    prepared for all subsequent work, some routine steps are necesseary.
    
    With this commit, all the routine steps are taken based on the release
    checklist, and necessary additions/modifications (based on the 0.22
    release) to the checklist have also been made.
---
 NEWS                      | 11 +++++++++++
 configure.ac              |  2 +-
 doc/gnuastro.texi         | 22 +++++++++++-----------
 doc/release-checklist.txt | 39 +++++++++++++++++++++++++++++----------
 4 files changed, 52 insertions(+), 22 deletions(-)

diff --git a/NEWS b/NEWS
index 5f6896f3..09aa1051 100644
--- a/NEWS
+++ b/NEWS
@@ -3,6 +3,17 @@ GNU Astronomy Utilities NEWS                          -*- 
outline -*-
 Copyright (C) 2015-2024 Free Software Foundation, Inc.
 See the end of the file for license conditions.
 
+* Noteworthy changes in release X.XX (library XX.X.X) (YYYY-MM-DD)
+** New publications
+** New features
+** Removed features
+** Changed features
+** Bugs fixed
+
+
+
+
+
 * Noteworthy changes in release 0.22 (library 20.0.0) (2024-02-03)
 ** New publications
   - https://ui.adsabs.harvard.edu/abs/2023RNAAS...7..269E by Eskandarlou et
diff --git a/configure.ac b/configure.ac
index b26175ff..8b5ebf8e 100644
--- a/configure.ac
+++ b/configure.ac
@@ -52,7 +52,7 @@ AC_CONFIG_MACRO_DIRS([bootstrapped/m4])
 
 # Library version, see the GNU Libtool manual ("Library interface versions"
 # section for the exact definition of each) for
-GAL_CURRENT=20
+GAL_CURRENT=21
 GAL_REVISION=0
 GAL_AGE=0
 GAL_LT_VERSION="${GAL_CURRENT}:${GAL_REVISION}:${GAL_AGE}"
diff --git a/doc/gnuastro.texi b/doc/gnuastro.texi
index eed11a8a..6e4c1a01 100644
--- a/doc/gnuastro.texi
+++ b/doc/gnuastro.texi
@@ -151,17 +151,17 @@ A copy of the license is included in the section entitled 
``GNU Free Documentati
 @subtitle
 @subtitle
 @end iftex
-@c @subtitle @strong{Important note:}
-@c @subtitle This is an @strong{under-development} Gnuastro release 
(bleeding-edge!).
-@c @subtitle It is not yet officially released.
-@c @subtitle The source tarball corresponding to this version is (temporarily) 
available at this URL:
-@c @subtitle @url{http://akhlaghi.org/src/gnuastro-@value{VERSION}.tar.lz}
-@c @subtitle (the tarball link above will not be available after the next 
official release)
-@c @subtitle The most recent under-development source and its corresponding 
book are available at:
-@c @subtitle @url{http://akhlaghi.org/gnuastro.pdf}
-@c @subtitle @url{http://akhlaghi.org/gnuastro-latest.tar.lz}
-@c @subtitle To stay up to date with Gnuastro's official releases, please 
subscribe to this mailing list:
-@c @subtitle @url{https://lists.gnu.org/mailman/listinfo/info-gnuastro}
+@subtitle @strong{Important note:}
+@subtitle This is an @strong{under-development} Gnuastro release 
(bleeding-edge!).
+@subtitle It is not yet officially released.
+@subtitle The source tarball corresponding to this version is (temporarily) 
available at this URL:
+@subtitle @url{http://akhlaghi.org/src/gnuastro-@value{VERSION}.tar.lz}
+@subtitle (the tarball link above will not be available after the next 
official release)
+@subtitle The most recent under-development source and its corresponding book 
are available at:
+@subtitle @url{http://akhlaghi.org/gnuastro.pdf}
+@subtitle @url{http://akhlaghi.org/gnuastro-latest.tar.lz}
+@subtitle To stay up to date with Gnuastro's official releases, please 
subscribe to this mailing list:
+@subtitle @url{https://lists.gnu.org/mailman/listinfo/info-gnuastro}
 @author Mohammad Akhlaghi
 
 @page
diff --git a/doc/release-checklist.txt b/doc/release-checklist.txt
index e6b7facf..9e7ee607 100644
--- a/doc/release-checklist.txt
+++ b/doc/release-checklist.txt
@@ -122,12 +122,12 @@ all the commits needed for this release have been 
completed.
  - Check if README includes all the recent updates and important features.
 
 
- - Run the following commands to keep the list of people who contributed
-   code and those that must be acknowledged for the announcement ('P.P' is
-   the previous version).
+ - Run the following commands to keep the list of people that must be
+   acknowledged for the announcement ('P.P' is the previous version). The
+   people who contributed code will be automatically added in the announce
+   generation step.
 
-     $ git shortlog gnuastro_vX.X...HEAD --numbered --summary > ~/people.txt
-     $ cat doc/announce-acknowledge.txt >> ~/people.txt
+     $ cat doc/announce-acknowledge.txt > ~/people.txt
 
      [STABLE] Remove the names in 'doc/announce-acknowledge.txt'.
 
@@ -230,13 +230,13 @@ all the commits needed for this release have been 
completed.
  - Prepare the announcement:
 
    - To run the command of the step below, you will need the following
-     temporary changes (from the top source directory). Replace 'XXXX' with
-     the old version and 'YYYY' with the new version.
+     temporary changes (from the top source directory). Replace 'X.XX' with
+     the old version and 'Y.YY' with the new version.
 
      $ cd TOP-SOURCE-DIR
      $ cp build/gnuastro-XXXX.tar.* ./
-     $ git tag -a vXXXX gnuastro_vXXXX^{}
-     $ git tag -a vYYYY HEAD
+     $ git tag -a vX.XX gnuastro_vX.XX^{}
+     $ git tag -a vY.YY gnuastro_vY.YY^{}
 
    - The command below will calculate the checksums and also make the links
      ready. You just have to add a starting and ending similar to previous
@@ -253,7 +253,7 @@ all the commits needed for this release have been completed.
    - Delete the temporary tags and files:
 
      $ rm gnuastro-0.XXXX.tar.*
-     $ git tag -d vXXXX vYYYY
+     $ git tag -d vX.XX vY.YY
 
 
  - Based on previous announcements, add an intro, the NEWS file and the
@@ -278,6 +278,16 @@ all the commits needed for this release have been 
completed.
    - Package the announced Gnuastro for Debian (described below) and submit
      it there.
 
+   - Go to your Conda fork and delete the branch locally and remotely (The
+     conda bot should have made the automatic pull request by this time);
+     so you can pull the automatically inserted changes.
+
+     $ cd GNUASTRO-CONDA-SRC
+     $ git checkout main
+     $ git pull
+     $ git branch -D XXXX-dev
+     $ git push fork --delete XXXX-dev
+
    - Update/edit the following URLs with the latest version (where
      necessary, may be updated already):
      - https://savannah.gnu.org/news/submit.php?group=gnuastro
@@ -293,6 +303,15 @@ all the commits needed for this release have been 
completed.
 
    - Uncomment the sub-titles of the title page in 'doc/gnuastro.texi'.
 
+   - Add the basic entries in the 'NEWS' for the next release:
+
+     * Noteworthy changes in release X.XX (library XX.X.X) (YYYY-MM-DD)
+     ** New publications
+     ** New features
+     ** Removed features
+     ** Changed features
+     ** Bugs fixed
+
    - Commit all the changes above.