[gnuastro-commits] master 5a0d4b58: Book: more general link to DS9's binary download in itemized list

[Mohammad Akhlaghi]

branch: master
commit 5a0d4b5891db51487f4f1ca3b81f8e51dc5bd0c3
Author: Faezeh Bidjarchian <fbidjarchian@gmail.com>
Commit: Mohammad Akhlaghi <mohammad@akhlaghi.org>

    Book: more general link to DS9's binary download in itemized list
    
    Until now, for the installation of DS9 (in an appendix) we were guiding the
    readers to the top Google-based page of DS9. However, that page has many
    limiations (for example it does not open in some countries!) and generally
    has a terrible interface making it hard to find the download link.
    
    With this commit, the direct download page https://ds9.si.edu/download is
    now given and we have a simple checklist for the steps to check the
    downloaded file and to install it.
    
    This commit and its message were edited by Mohammad Akhlaghi.
---
 doc/gnuastro.texi | 34 ++++++++++++++++++++++++++--------
 1 file changed, 26 insertions(+), 8 deletions(-)

diff --git a/doc/gnuastro.texi b/doc/gnuastro.texi
index f57d830a..1b5cdedd 100644
--- a/doc/gnuastro.texi
+++ b/doc/gnuastro.texi
@@ -41936,21 +41936,39 @@ It is therefore a useful tool to visually inspect the 
images/cubes of your Gnuas
 In Gnuastro we have an installed script to run DS9 or TOPCAT on any number of 
FITS files (depending on it being an image or table), see @ref{Viewing FITS 
file contents with DS9 or TOPCAT} (which also includes a @file{.desktop} file 
for GUI integration).
 After installing DS9, you can easily use that script to open any FITS file 
(table, image or cube).
 
-Like the other packages, it might already be available in your distribution's 
repositories.
-It is also already pre-compiled in the download section of its web page.
-Once you download it you can unpack and install (move it to a system 
recognized directory) with the following commands (@code{x.x.x} is the version 
number):
-
+Like the other packages, it might already be available in your distribution's 
repositories; but these may be outdated.
+DS9 is also already pre-compiled for many common operating systems in the 
download section of its own web page:
+@enumerate
+@item
+Find your operating system in @url{https://ds9.si.edu/download}.
+Note that many GNU/Linux operating systems are compatible with Debian or 
Fedora, so if you don't find your operating system's name, probably the latest 
Debian or Fedora will also work for you.
+@item
+With the operating system directories, you will find a compressed tarball that 
you need to download (choose the latest one).
+@item
+Unpack the tarball with a command like below:
+@example
+$ tar -xf ds9.debian11.X.X.X.tar.gz
+@end example
+@item
+This should produce a simple @file{ds9} file.
+Before installing, it is good to actually test it like below:
+@example
+$ ./ds9
+@end example
+@item
+If the command above opened DS9 with no error, you can safely install it with 
this command:
 @example
-$ tar xf ds9.linux64.x.x.x.tar.gz
 $ sudo mv ds9 /usr/local/bin
 @end example
-
-@noindent
-To test the build (as long as @file{/usr/local/bin} is in your @code{PATH}, 
see @ref{Installation directory}), you can simply run the command below.
+@item
+Go to your home directory and try running DS9 with the two commands below.
+If it doesn't find it, then you need to add @file{/usr/local/bin} to your 
@file{PATH}, see @ref{Installation directory}.
 
 @example
+$ cd
 $ ds9
 @end example
+@end enumerate
 
 @cartouche
 @noindent