[gnuastro-commits] master b717dc66 2/2: Book: under development notice added on first PDF page

[Mohammad Akhlaghi]

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

    Book: under development notice added on first PDF page
    
    Until now, the PDF generated during the development of Gnuastro (between
    official releases) looked almost identical to the official release PDF!
    Only the small version string differed.
    
    Unfortunately search engines have discovered the URL that I upload the
    under-development manual ('http://akhlaghi.org/gnuastro.pdf'), and in
    things like Google, it now shows very close to the first entry (because it
    is regularly updated, I guess!).
    
    With this commit, to avoid confusing people who get access to the
    un-official PDF, a notice has been added on the empty part of the title
    page, saying that this is not the official release. It also includes the
    relevant links that an interested person may want to follow-up with
    (regarding which release to use and how to get the corresponding source).
---
 doc/gnuastro.texi         | 21 +++++++++++++++++++++
 doc/release-checklist.txt | 11 +++++++++++
 2 files changed, 32 insertions(+)

diff --git a/doc/gnuastro.texi b/doc/gnuastro.texi
index 2837cf6d..82327b60 100644
--- a/doc/gnuastro.texi
+++ b/doc/gnuastro.texi
@@ -144,6 +144,27 @@ A copy of the license is included in the section entitled 
``GNU Free Documentati
 @title GNU Astronomy Utilities
 @subtitle Astronomical data manipulation and analysis programs and libraries
 @subtitle for version @value{VERSION}, @value{UPDATED}
+@iftex
+@subtitle
+@subtitle
+@subtitle
+@subtitle
+@subtitle
+@subtitle
+@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}
 @author Mohammad Akhlaghi
 
 @page
diff --git a/doc/release-checklist.txt b/doc/release-checklist.txt
index 48373e7c..b8fe750f 100644
--- a/doc/release-checklist.txt
+++ b/doc/release-checklist.txt
@@ -81,6 +81,12 @@ all the commits needed for this release have been completed.
    not for upload at this stage, it is only for the version control.
 
 
+ - [STABLE] Remove the development notice on the first page of the PDF: in
+   'doc/gnuastro.texi', put a '@c' at the start of all lines under (not
+   including) '@subtitle for version', until (not including) '@author
+   Mohammad Akhlaghi'.
+
+
  - Commit all these changes:
 
      $ git add -u
@@ -226,6 +232,7 @@ Steps necessary to Package Gnuastro for Debian.
       $ ./bootstrap --copy --gnulib-srcdir=/path/to/gnulib
       $ ./developer-build -p upload-server:folder
 
+
  - Some tips on basic Debian operating system to do the packaging:
 
    After installing Debian from DVD, you may need to tell apt to use an
@@ -264,6 +271,7 @@ Steps necessary to Package Gnuastro for Debian.
    A restart should help in making sure everything that has been updated is
    being used.
 
+
  - It would help to use the most recent versions of packages in Debian. To
    do that, you can update the '/etc/apt/sources.list' file. You can get
    the current releases from this webpage:
@@ -274,6 +282,7 @@ Steps necessary to Package Gnuastro for Debian.
      $ sudo apt-get update
      $ sudo apt-get upgrade
 
+
  - If you don't already have the Gnuastro Debian packaging Git repository,
    clone it with the following command (don't forget to upload your public
    SSH key to that server). A 'gnuastro' directory will be built after the
@@ -373,11 +382,13 @@ Steps necessary to Package Gnuastro for Debian.
 
      $ emacs debian/control   # Only three digits "X.Y.Z"
 
+
  - Check if the years in 'debian/copyright' are up to date (usually on
    first packaging after a new year):
 
      $ emacs debian/copyright
 
+
  - If the soname of the shared libraries has changed:
 
      - Rename the file 'debian/libgnuastroX.install' (set 'X' to the new