[gnuastro-commits] master c8ec792c: NEWS: preparations for next release

[Mohammad Akhlaghi]

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

    NEWS: preparations for next release
    
    Until now, the top element of the 'NEWS' file was for version 0.20. But
    that has been released and in the next series of commits, new things will
    be added. I also noticed that updates in the annoncing script required some
    changes in 'doc/release-checklist.txt'.
    
    With this commit the new titles of the 'NEWS' file have been added and the
    missing steps in the release checklist have been added. Also the notice at
    the first page of the PDF book has also been added.
---
 NEWS                      | 16 +++++++++++++++-
 doc/gnuastro.texi         | 22 +++++++++++-----------
 doc/release-checklist.txt | 25 ++++++++++++++++++++-----
 3 files changed, 46 insertions(+), 17 deletions(-)

diff --git a/NEWS b/NEWS
index 89ea4e71..5d79a663 100644
--- a/NEWS
+++ b/NEWS
@@ -4,7 +4,21 @@ Copyright (C) 2015-2023 Free Software Foundation, Inc.
 See the end of the file for license conditions.
 
 
-* Noteworthy changes in release 0.20 (library 18.0.0) (2023-04-23)
+* Noteworthy changes in release 0.XX (library XX.X.X) (YYYY-MM-DD)
+
+** New features
+
+** Removed features
+
+** Changed features
+
+** Bugs fixed
+
+
+
+
+
+* Noteworthy changes in release 0.20 (library 18.0.0) (2023-04-29)
 
 ** New features
 
diff --git a/doc/gnuastro.texi b/doc/gnuastro.texi
index 2529ea26..b2e157ae 100644
--- a/doc/gnuastro.texi
+++ b/doc/gnuastro.texi
@@ -152,17 +152,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 7b4ce53a..f0537e6e 100644
--- a/doc/release-checklist.txt
+++ b/doc/release-checklist.txt
@@ -171,11 +171,20 @@ all the commits needed for this release have been 
completed.
     $ git push --follow-tags
 
 
- - Prepare the announcement, this command will calculate the checksums and
-   also make the links ready. You just have to add a starting and ending
-   similar to previous announcements in a text editor. In the 'XXXX', put
-   'stable' or 'alpha' and in YYYY, put 'ftp' for a stable, and 'alpha' for
-   an alpha release.
+ - 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.
+
+     $ cp build/gnuastro-0.20.tar.* ./
+     $ git tag -a vXXXX gnuastro_vXXXX^{}
+     $ git tag -a vYYYY gnuastro_vYYYY^{}
+
+   - 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
+     announcements in a text editor. In the 'XXXX', put 'stable' or 'alpha'
+     and in YYYY, put 'ftp' for a stable, and 'alpha' for an alpha release.
 
      $ cd build
      $ /path/to/gnulib/build-aux/announce-gen --release-type=XXXX          \
@@ -184,6 +193,12 @@ all the commits needed for this release have been 
completed.
               --url-directory=https://YYYY.gnu.org/gnu/gnuastro            \
               > ~/announcement.txt
 
+   - Delete the temporary tags and files:
+
+     $ rm gnuastro-0.20.tar.*
+     $ git tag -d vXXXX
+     $ git tag -d vYYYY
+
 
  - Based on previous announcements, add an intro, the NEWS file and the
    contents of '~/people.txt' to the announcement.