[gnuastro-commits] master 4ce70a2: Release checklist and doc corrected after 0.3.57 release

[Mohammad Akhlaghi]

branch: master
commit 4ce70a2afb495221e6b661b8bce55cda17726685
Author: Mohammad Akhlaghi <address@hidden>
Commit: Mohammad Akhlaghi <address@hidden>

    Release checklist and doc corrected after 0.3.57 release
    
    While making the 0.3.37 tarball release, I noticed some further issues that
    needed to be corrected in the release checklist and documentation. They are
    now applied.
    
    Also, a new file (`doc/announce-acknowledge.txt') was created in the
    version controlled source code to list the people who contributed
    indirectly between each major release. This will make sure we don't miss
    anyone in the announcements.
---
 NEWS                         |  7 +++----
 doc/announce-acknowledge.txt | 15 +++++++++++++++
 doc/gnuastro.texi            | 26 +++++++++++---------------
 doc/release-checklist.txt    | 18 ++++++++----------
 4 files changed, 37 insertions(+), 29 deletions(-)

diff --git a/NEWS b/NEWS
index 14cfc9a..bf17e5e 100644
--- a/NEWS
+++ b/NEWS
@@ -4,8 +4,7 @@ GNU Astronomy Utilities NEWS                          -*- 
outline -*-
 
 ** New features
 
-  All programs: `.fit' suffix is now also recognized as a FITS file
-  extension in all programs and libraries.
+  All programs: `.fit' is now a recognized FITS file suffix.
 
   All programs: ASCII text files (tables) created with CRLF line
   terminators (for example text files created in MS Windows) are now also
@@ -108,7 +107,7 @@ GNU Astronomy Utilities NEWS                          -*- 
outline -*-
 
   `GAL_TILE_PARSE_OPERATE' (only when `OTHER' is given) can now parse and
   operate on different datasets independent of the size of allocated block
-  of memory (the tile sizes of `IN' and `OTHER' have to be idential, but
+  of memory (the tile sizes of `IN' and `OTHER' have to be identical, but
   not their allocated blocks of memory). Until now, it was necessary for
   the two blocks to have the same size and this is no longer the case.
 
@@ -127,7 +126,7 @@ GNU Astronomy Utilities NEWS                          -*- 
outline -*-
 
   Crashes on 32-bit and big-endian systems (bug #51476).
 
-  Warp's align matrix when second dimention must be reversed (bug #51536).
+  Warp's align matrix when second dimension must be reversed (bug #51536).
 
   Reading BZERO for unsigned 64-bit integers (bug #51555).
 
diff --git a/doc/announce-acknowledge.txt b/doc/announce-acknowledge.txt
new file mode 100644
index 0000000..b4c0c94
--- /dev/null
+++ b/doc/announce-acknowledge.txt
@@ -0,0 +1,15 @@
+This file is meant to keep the names of the people who's help must be
+acknowledged in the next release.
+
+Marjan Akbari
+Adrian Bunk
+Antonio Diaz Diaz
+Mosè Giordano
+Raúl Infante Sainz
+Aurélien Jarno
+Alan Lefor
+Guillaume Mahler
+William Pence
+Ole Streicher
+Ignacio Trujillo
+David Valls-Gabaud
diff --git a/doc/gnuastro.texi b/doc/gnuastro.texi
index 0a7e776..ff175d9 100644
--- a/doc/gnuastro.texi
+++ b/doc/gnuastro.texi
@@ -2853,21 +2853,17 @@ activities, please clone the version controlled source 
as described in
 
 @cindex Gzip
 @cindex Lzip
-Gnuastro's official tarball is released with two formats: Gzip (with suffix
address@hidden) and Lzip (with suffix @file{.tar.lz}). The former is a very
-well-known and widely used compression program created by GNU and available
-in most systems. The latter provides a better compression ratio and more
-robust archival capacity. For example Gnuastro 0.2's tarball was 2.8MB and
-4.2MB with Lzip and Gzip respectively. From the
address@hidden://www.nongnu.org/lzip/lzip.html, Lzip webpage}: ``Lzip is a
-lossless data compressor with a user interface similar to the one of gzip
-or bzip2. Lzip can compress about as fast as gzip (@command{lzip -0}), or
-compress most files more than bzip2 (@command{lzip -9}). Decompression
-speed is intermediate between gzip and bzip2. Lzip is better than gzip and
-bzip2 from a data recovery perspective.'' However, Lzip is currently not
-too common, so it might not be pre-installed in your operating
-system. Installing it from your operating system's package manager or from
-source is very easy.
+Gnuastro's official/stable tarball is released with two formats: Gzip (with
+suffix @file{.tar.gz}) and Lzip (with suffix @file{.tar.lz}). The
+pre-release tarballs (after version 0.3) are released only as an Lzip
+tarball. Gzip is a very well-known and widely used compression program
+created by GNU and available in most systems. However, Lzip provides a
+better compression ratio and more robust archival capacity. For example
+Gnuastro 0.3's tarball was 2.9MB and 4.3MB with Lzip and Gzip respectively,
+see the @url{http://www.nongnu.org/lzip/lzip.html, Lzip webpage} for
+more. Lzip might not be pre-installed in your operating system, if so,
+installing it from your operating system's package manager or from source
+is very easy and fast (it is a very small program).
 
 The GNU FTP server is mirrored (has backups) in various locations on the
 globe (@url{http://www.gnu.org/order/ftp.html}). You can use the closest
diff --git a/doc/release-checklist.txt b/doc/release-checklist.txt
index d35aafc..3b25ac0 100644
--- a/doc/release-checklist.txt
+++ b/doc/release-checklist.txt
@@ -6,10 +6,10 @@ set of operations to do for making each release. This should 
be done after
 all the commits needed for this release have been completed.
 
 
- - [ALPHA] Only in the first alpha release after a main release: update the
-   library version (the values starting with `GAL_' in `configure.ac'). See
-   the `Updating library version information' section of the GNU Libtool
-   manual as a guide.
+ - [ALPHA] Only in the first alpha release after a stable release: update
+   the library version (the values starting with `GAL_' in
+   `configure.ac'). See the `Updating library version information' section
+   of the GNU Libtool manual as a guide.
 
 
  - [ALPHA] Run a spell-check (in emacs with `M-x ispell') on the whole book.
@@ -92,9 +92,6 @@ all the commits needed for this release have been completed.
                gnuastro-X.X.tar.gz gnuastro-X.X.tar.lz
 
 
- - [ALPHA]: Now that you have the release number, update the link on the
-   main HTML on the webpage (`gnuastro-top.html').
-
  - [STABLE] Build the manual in all the formats and upload everything. Note
    that you will need to configure Gnuastro in the main source directory to
    build the full webpage with this script.
@@ -112,12 +109,13 @@ all the commits needed for this release have been 
completed.
  - 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
-   `ftp' for a stable, and `alpha' for an alpha release.
+   `stable' or `alpha' and in YYYY, put `ftp' for a stable, and `alpha' for
+   an alpha release.
 
-     $ /path/to/gnulib/build-aux/announce-gen --release-type=stable        \
+     $ /path/to/gnulib/build-aux/announce-gen --release-type=XXXX        \
               --package-name=gnuastro --previous-version=0.1               \
               --current-version=0.2 --gpg-key-id=16A8A4B2AEC42AFF          \
-              --url-directory=http://XXXX.gnu.org/gnu/gnuastro             \
+              --url-directory=http://YYYY.gnu.org/gnu/gnuastro             \
               --archive-suffix=tar.lz > announcement.txt