[gnuastro-commits] master 0d0100a2: Release: preparations for version 0.21

[Mohammad Akhlaghi]

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

    Release: preparations for version 0.21
    
    Until now, we were developing the various features after Gnuastro 0.20! We
    are now ready for Gnuastro 0.21.
    
    With this commit, the final touches have been done:
    - The version on the webpage has been updated.
    - The development notice at the start of the book is commented.
    - The list of programs in the book and README have been sorted properly.
    - A spell-check was ran in the 'NEWS' file.
    - Some tips have been added in the Conda build checklist based on the
      latest test before this commit.
---
 NEWS                      | 10 +++++-----
 README                    | 12 ++++++------
 doc/gnuastro.en.html      | 10 +++++-----
 doc/gnuastro.fr.html      |  6 +++---
 doc/gnuastro.texi         | 32 ++++++++++++++++----------------
 doc/release-checklist.txt | 15 +++++++++++----
 6 files changed, 46 insertions(+), 39 deletions(-)

diff --git a/NEWS b/NEWS
index 7fe638fa..4c64e900 100644
--- a/NEWS
+++ b/NEWS
@@ -4,7 +4,7 @@ Copyright (C) 2015-2023 Free Software Foundation, Inc.
 See the end of the file for license conditions.
 
 
-* Noteworthy changes in release 0.XX (library XX.X.X) (YYYY-MM-DD)
+* Noteworthy changes in release 0.21 (library 19.0.0) (2023-10-20)
 ** New features
 *** New program
   - 'astscript-pointing-simulate': a new installed script that will
@@ -44,7 +44,7 @@ See the end of the file for license conditions.
   - New operators (see book for a full description):
     - pool-min: Min-pooling to reduce the size of the input by calculating
                 the minimum of a the pixels within the pooling window
-                (accounting for a stride). See the new "Pooling opeators"
+                (accounting for a stride). See the new "Pooling operators"
                 section of the book for more. The pooling operators were
                 all implemented by Faezeh Bidjarchian.
     - pool-max: Similar to 'pool-min' but using maximum.
@@ -118,7 +118,7 @@ See the end of the file for license conditions.
   --madclip-mean: Mean of input elements after MAD-clipping.
   --madclip-std: Standard deviation of input elements after MAD-clipping.
   --madclip-mad: MAD of input elements after MAD-clipping.
-  --mclipparams: Paramters of MAD-clipping, similar to sigma-clipping. Note
+  --mclipparams: Parameters of MAD-clipping, similar to sigma-clipping. Note
                  that in a Gaussian distribution, MAD = 0.67 sigma, so if
                  you want something similar to 3-sigma (the default), you
                  should set the MAD multiple to 5 (the default).
@@ -174,7 +174,7 @@ See the end of the file for license conditions.
 *** MakeNoise
     - MakeNoise (with executable name 'astmknoise') has been removed from
       Gnuastro. This is because the 'mknoise-*' operators of Arithmetic do
-      the same job, but in a much more customizable, modular and managable
+      the same job, but in a much more customizable, modular and manageable
       manner; allowing to mix with other operators. The "Noise basics"
       sub-section of the book has been moved under the Arithmetic program's
       documentation also.
@@ -193,7 +193,7 @@ See the end of the file for license conditions.
 
 *** MakeCatalog
   - The dash in the column names of the following measurement names has
-    been replced by underscore to conform with the general stardard of
+    been replaced by underscore to conform with the general standard of
     using underscores between words in column names (reported by Raul
     Infante-Sainz). Also, in the case of '--sigclip-mean-sb-delta' the
     column name didn't correspond to the option name.
diff --git a/README b/README
index 17a8a4f8..86e83e50 100644
--- a/README
+++ b/README
@@ -110,12 +110,6 @@ running a program in a special way), Gnuastro also 
installs Bash scripts
 (all prefixed with 'astscript-'). They can be run like a program and behave
 very similarly (with minor differences, as explained in the book).
 
-  - astscript-pointing-simulate: Given a table of pointings on the sky,
-    create and a reference image that contain's your camera's distortions
-    and properties, generate a stacked exposure map. This is very useful in
-    testing the coverage of dither patterns when planning your observing
-    strategy and it is highly customizable.
-
   - astscript-ds9-region: Given a table (either as a file or from
     standard input), create an SAO DS9 region file from the requested
     positional columns (WCS or image coordinates).
@@ -124,6 +118,12 @@ very similarly (with minor differences, as explained in 
the book).
     either open SAO DS9 (for images or cubes) or TOPCAT (for tables) to
     view them in a graphic user interface (GUI).
 
+  - astscript-pointing-simulate: Given a table of pointings on the sky,
+    create and a reference image that contain's your camera's distortions
+    and properties, generate a stacked exposure map. This is very useful in
+    testing the coverage of dither patterns when planning your observing
+    strategy and it is highly customizable.
+
   - astscript-radial-profile: Calculate the radial profile of an object
     within an image. The object can be at any location in the image, using
     various measures (median, sigma-clipped mean and etc), and the radial
diff --git a/doc/gnuastro.en.html b/doc/gnuastro.en.html
index c300a9ee..8127b7d8 100644
--- a/doc/gnuastro.en.html
+++ b/doc/gnuastro.en.html
@@ -83,9 +83,9 @@ for entertaining and easy to read real world examples of using
 
 <p>
   The current stable release
-  is <strong><a 
href="https://ftp.gnu.org/gnu/gnuastro/gnuastro-0.20.tar.gz";>Gnuastro
-  0.20</a></strong> (April 29th, 2023).
-  Use <a href="https://ftpmirror.gnu.org/gnuastro/gnuastro-0.20.tar.gz";>a
+  is <strong><a 
href="https://ftp.gnu.org/gnu/gnuastro/gnuastro-0.21.tar.gz";>Gnuastro
+  0.21</a></strong> (October 20th, 2023).
+  Use <a href="https://ftpmirror.gnu.org/gnuastro/gnuastro-0.21.tar.gz";>a
   mirror</a> if possible.
 
   <!-- Comment the test release notice when the test release is not more
@@ -96,7 +96,7 @@ for entertaining and easy to read real world examples of using
   To stay up to date, please subscribe.</em></p>
 
 <p>For details of the significant changes in this release, please see the
-  <a 
href="https://git.savannah.gnu.org/cgit/gnuastro.git/plain/NEWS?id=gnuastro_v0.20";>NEWS</a>
+  <a 
href="https://git.savannah.gnu.org/cgit/gnuastro.git/plain/NEWS?id=gnuastro_v0.21";>NEWS</a>
   file.</p>
 
 <p>The
@@ -449,7 +449,7 @@ Please use the mailing lists for contact. </dd>
 
 
 <h3 id="recentcite">Recent citations of Gnuastro</h3>
-<p>For the full, and up-to-date, list please see the respective <a 
href="https://scholar.google.com/scholar?hl=en&amp;as_sdt=0,5&amp;sciodt=0,5&amp;cites=4207494987138368989&amp;scipsc=&amp;q=&amp;scisbd=1";>Google
 Scholar</a>, or the "Metrics" tab of the <a 
href="https://ui.adsabs.harvard.edu/public-libraries/0QdYMuVCQdmygEh0Vs_4Ew";>Gnuastro
 ADS library</a>, or click on the "cited:" item of each paper on the <a 
href="https://ui.adsabs.harvard.edu/search/p_=0&q=docs(library%2F0QdYMuVCQdmy 
[...]
+<p>For the full, and up-to-date, list please see the <a 
href="https://scholar.google.com/scholar?hl=en&amp;as_sdt=0,5&amp;sciodt=0,5&amp;cites=4207494987138368989&amp;scipsc=&amp;q=&amp;scisbd=1";>Google
 Scholar</a> page for the main article, or the "Metrics" tab of the <a 
href="https://ui.adsabs.harvard.edu/public-libraries/0QdYMuVCQdmygEh0Vs_4Ew";>Gnuastro
 ADS library</a>, the "cited:" item of each paper on the <a 
href="https://ui.adsabs.harvard.edu/search/p_=0&q=docs(library%2F0QdYMuVCQ [...]
 
 
 
diff --git a/doc/gnuastro.fr.html b/doc/gnuastro.fr.html
index 2ca21b09..59f68f02 100644
--- a/doc/gnuastro.fr.html
+++ b/doc/gnuastro.fr.html
@@ -81,14 +81,14 @@
 <h3 id="download">Téléchargement</h3>
 
 <p>La version stable actuelle
-  est <strong><a 
href="https://ftp.gnu.org/gnu/gnuastro/gnuastro-0.20.tar.gz";>Gnuastro
-  0.20</a></strong> (sortie le 29 avril 2022). Utilisez <a 
href="https://ftpmirror.gnu.org/gnuastro/gnuastro-0.20.tar.gz";>un
+  est <strong><a 
href="https://ftp.gnu.org/gnu/gnuastro/gnuastro-0.21.tar.gz";>Gnuastro
+  0.21</a></strong> (sortie le 20 octobre 2023). Utilisez <a 
href="https://ftpmirror.gnu.org/gnuastro/gnuastro-0.21.tar.gz";>un
   miroir</a> si possible.  <br /><em>Les nouvelles versions sont annoncées
   sur <a 
href="https://lists.gnu.org/mailman/listinfo/info-gnuastro";>info-gnuastro</a>.
   Abonnez-vous pour rester au courant.</em></p>
 
 <p>Les changements importants sont décrits dans le
-  fichier <a 
href="https://git.savannah.gnu.org/cgit/gnuastro.git/plain/NEWS?id=gnuastro_v0.20";>
+  fichier <a 
href="https://git.savannah.gnu.org/cgit/gnuastro.git/plain/NEWS?id=gnuastro_v0.21";>
   NEWS</a>.</p>
 
 <p>Le lien
diff --git a/doc/gnuastro.texi b/doc/gnuastro.texi
index b5e60105..c3cdc814 100644
--- a/doc/gnuastro.texi
+++ b/doc/gnuastro.texi
@@ -105,9 +105,9 @@ A copy of the license is included in the section entitled 
``GNU Free Documentati
 * astwarp: (gnuastro)Invoking astwarp. Options to Warp.
 
 * astscript: (gnuastro)Installed scripts. Gnuastro's installed scripts.
-* astscript-pointing-simulate: (gnuastro)Invoking astscript-pointing-simulate. 
Options to this script
 * astscript-ds9-region: (gnuastro)Invoking astscript-ds9-region. Options to 
this script
 * astscript-fits-view: (gnuastro)Invoking astscript-fits-view. Options to this 
script
+* astscript-pointing-simulate: (gnuastro)Invoking astscript-pointing-simulate. 
Options to this script
 * astscript-psf-scale-factor: (gnuastro)Invoking astscript-psf-scale-factor. 
Options to this script
 * astscript-psf-select-stars: (gnuastro)Invoking astscript-psf-select-stars. 
Options to this script
 * astscript-psf-stamp: (gnuastro)Invoking astscript-psf-stamp. Options to this 
script
@@ -150,17 +150,17 @@ A copy of the license is included in the section entitled 
``GNU Free Documentati
 @subtitle
 @subtitle
 @end iftex
-@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}
+@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}
 @author Mohammad Akhlaghi
 
 @page
@@ -1139,16 +1139,16 @@ In Gnuastro, higher-level operations (combining 
multiple programs, or running a
 They can be run just like a program and behave very similarly (with minor 
differences, see @ref{Installed scripts}).
 
 @table @code
-@item astscript-pointing-simulate
-(See @ref{Pointing pattern simulation}) Given a table of pointings on the sky, 
create and a reference image that contains your camera's distortions and 
properties, generate a stacked exposure map.
-This is very useful in testing the coverage of dither patterns when designing 
your observing strategy and it is highly customizable, see the tutorial in 
@ref{Pointing pattern design}.
-
 @item astscript-ds9-region
 (See @ref{SAO DS9 region files from table}) Given a table (either as a file or 
from standard input), create an SAO DS9 region file from the requested 
positional columns (WCS or image coordinates).
 
 @item astscript-fits-view
 (see @ref{Viewing FITS file contents with DS9 or TOPCAT}) Given any number of 
FITS files, this script will either open SAO DS9 (for images or cubes) or 
TOPCAT (for tables) to view them in a graphic user interface (GUI).
 
+@item astscript-pointing-simulate
+(See @ref{Pointing pattern simulation}) Given a table of pointings on the sky, 
create and a reference image that contains your camera's distortions and 
properties, generate a stacked exposure map.
+This is very useful in testing the coverage of dither patterns when designing 
your observing strategy and it is highly customizable, see the tutorial in 
@ref{Pointing pattern design}.
+
 @item astscript-radial-profile
 (See @ref{Generate radial profile}) Calculate the radial profile of an object 
within an image.
 The object can be at any location in the image, using various measures 
(median, sigma-clipped mean, etc.), and the radial distance can also be 
measured on any general ellipse.
diff --git a/doc/release-checklist.txt b/doc/release-checklist.txt
index a8b8192a..9cd80882 100644
--- a/doc/release-checklist.txt
+++ b/doc/release-checklist.txt
@@ -89,6 +89,8 @@ all the commits needed for this release have been completed.
        $ git remote add fork YOUR-FORK-GIT-LOCATION
        $ git checkout -b XXXX-dev
        $ emacs recipe/meta.yaml
+          --> Don't touch the version! The development versioning format
+              of Gnuastro is going to cause problems with the '-'.
           --> Completely replace the URL to the one you uploaded to.
           --> Update the SHA256 checksum to the one you obtained above.
        $ git add -u
@@ -100,9 +102,14 @@ all the commits needed for this release have been 
completed.
      start a build on all available Conda architectures that Gnuastro has
      been configured for. This will usually take about half an hour!
 
-   - If there is any problem, you need to fix it. Otherwise (if all the
-     tests pass), you can close the pull request and delete the branch in
-     your fork.
+   - If there is any problem, you need to fix it with a new commit on the
+     branch; closing the merge request and opening a new one.
+     - Note that if the build takes more than ten minutes, the first
+       generic test will fail. But as long as the other tests are running,
+       everything is fine; once they pass, the generic one will pass also.
+
+   - Once all the tests pass successfully, you can close the pull request
+     and delete the branch in your fork.
 
 
  - [STABLE] Update the versions in the NEWS file and do a spell-check.
@@ -148,7 +155,7 @@ all the commits needed for this release have been completed.
  - [STABLE] Make sure the tarball doesn't have any problems:
 
      $ cd build
-     $ make distcheck -j8
+     $ make distcheck -j12
 
 
  - [STABLE]: After the 'make distcheck' is safely finished, tag the release: