[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[gnuastro-commits] master 7cf87f9 2/2: Minor edits in quick start and pa
From: |
Mohammad Akhlaghi |
Subject: |
[gnuastro-commits] master 7cf87f9 2/2: Minor edits in quick start and package manager sections of book |
Date: |
Tue, 26 Jun 2018 11:15:57 -0400 (EDT) |
branch: master
commit 7cf87f9540658e1e59f58fb2bc2ed93568cc3fd4
Author: Mohammad Akhlaghi <address@hidden>
Commit: Mohammad Akhlaghi <address@hidden>
Minor edits in quick start and package manager sections of book
Some small edits were made in these two sections to make them more useful
and easier to read. In particular the discussion on choosing Lzip over Gzip
was moved to a footnote, since it wasn't directly relevant to someone who
just wants to download and install the Gnuastro.
Also, a link to the dependency installation with package managers was also
added in "Quick start". Finally, the package managers were put before the
operating system names toin the dependency installation in package managers
to be easier to notice (since some operating systems share a package
manager).
---
doc/gnuastro.texi | 46 ++++++++++++++++++++++------------------------
1 file changed, 22 insertions(+), 24 deletions(-)
diff --git a/doc/gnuastro.texi b/doc/gnuastro.texi
index d1ed27d..503d6e8 100644
--- a/doc/gnuastro.texi
+++ b/doc/gnuastro.texi
@@ -736,6 +736,8 @@ history, before it has been fully documented here first. As
discussed in
@section Quick start
@cindex Test
address@hidden Gzip
address@hidden Lzip
@cindex Check
@cindex Build
@cindex Compile
@@ -749,18 +751,14 @@ and robust archival features, an
@url{http://www.nongnu.org/lzip/lzip.html,
Lzip} compressed tarball is also available at
@url{http://ftp.gnu.org/gnu/gnuastro/gnuastro-latest.tar.lz,
@file{gnuastro-latest.tar.lz}}, see @ref{Release tarball} for more details
-on the tarball release.
+on the tarball address@hidden Gzip library and program are commonly
+available on most systems. However, Gnuastro recommends Lzip as described
+above and the beta-releases are also only distributed in @file{tar.lz}. You
+can download and install Lzip's source (in @file{.tar.gz} format) from its
+webpage and follow the same process as below: Lzip has no dependencies, so
+simply decompress, then run @command{./configure}, @command{make},
address@hidden make install}.}.
address@hidden Gzip
address@hidden Lzip
address@hidden GNU Tar
-The Gzip library and program are commonly available on most
-systems. However, Gnuastro recommends Lzip as described above and the
-beta-releases are also only distributed in @file{tar.lz}. You can download
-and install Lzip's source (in @file{.tar.gz} format) from its webpage and
-follow the same process as below: Lzip has no dependencies, so simply
-decompress, then run @command{./configure}, @command{make}, @command{sudo
-make install}.
Let's assume the downloaded tarball is in the @file{TOPGNUASTRO}
directory. The first two commands below can be used to decompress the
@@ -786,9 +784,10 @@ $ tar xf gnuastro-latest.tar
@end example
Gnuastro has three mandatory dependencies and some optional dependencies
-for extra functionality, see @ref{Dependencies} for the full list. Links to
-the dependency sources and instructions on installing each are fully
-described there. When the mandatory dependencies are ready, you can
+for extra functionality, see @ref{Dependencies} for the full list. In
address@hidden from package managers} we have prepared the command to
+easily install Gnuastro's dependencies using the package manager of some
+operating systems. When the mandatory dependencies are ready, you can
configure, compile, check and install Gnuastro on your system with the
following commands.
@@ -4992,12 +4991,11 @@ results and understanding (of what is going on, and
thus how you interpret
your scientific results) will also correspondingly improve.
@end enumerate
-Based on your operating system and its package manager, you can use any of
-the following commands to install the mandatory and optional
-dependencies. If your operating system or package manager are not included,
-please send us the respective command, so we add it here. Gnuastro itself
-if also already packaged in some package managers (for example Debian or
-Homebrew).
+Based on your package manager, you can use any of the following commands to
+install the mandatory and optional dependencies. If your package manager
+isn't included in the list below, please send us the respective command, so
+we add it. Gnuastro itself if also already packaged in some package
+managers (for example Debian or Homebrew).
As discussed above, we recommend installing the @emph{mandatory}
dependencies manually from source. Therefore, in each command below, first
@@ -5007,7 +5005,7 @@ mandatory dependencies with your package manager, just
ignore the empty
line.
@table @asis
address@hidden Debian-based OSs (@command{apt-get})
address@hidden @command{apt-get} (Debian-based OSs: Ubuntu, Linux Mint and etc)
@cindex Debian
@cindex Ubuntu
@cindex @command{apt-get}
@@ -5025,7 +5023,7 @@ $ sudo apt-get install ghostscript libtool-bin
libjpeg-dev \
libgsl0-dev libcfitsio-dev wcslib-dev
@end example
address@hidden macOS (@command{brew})
address@hidden @command{brew} (macOS)
@cindex macOS
@cindex Homebrew
@cindex MacPorts
@@ -5051,7 +5049,7 @@ $ brew tap brewsci/science
$ brew install wcslib
@end example
address@hidden Arch Linux (@command{pacman})
address@hidden @command{pacman} (Arch Linux)
@cindex Arch Linux
@cindex @command{pacman}
Arch Linux is a smaller GNU/Linux distribution. As discussed in
@@ -5060,7 +5058,7 @@ KISS principle ("keep it simple, stupid") as the general
guideline, and
focuses on elegance, code correctness, minimalism and simplicity, and
expects the user to be willing to make some effort to understand the
system's operation''. Arch Linux uses ``Package manager'' (Pacman) to
-manage its packages.
+manage its packages/components.
@example
$ sudo pacman -S ghostscript libtool libjpeg libtiff libgit2 \
\