[gnuastro-commits] (no subject)

[Mohammad Akhlaghi]

branch: master
commit f2a92228806f406db31a9b617a843e9b3af37b86
Author: Mohammad Akhlaghi <address@hidden>
Date:   Tue Jun 7 15:31:46 2016 +0900

    Only necessary TeX Live packages explained in book
    
    LaTeX (and some TeX packages) are necessary to bootstrap Gnuastro. In
    "Bootstrapping dependencies" until now we had not made any particular
    suggestions, so unexperienced enthusiasts would install the full ~4 giga
    byte package. This can be a major problem for some interested people or
    people who are not heavy users of TeX and could discourage people from
    bootstrapping Gnuastor.
    
    With the release of TeX Live 2016, I needed to update my own TeX Live, so I
    thought of finding a way to bootstrap Gnuastro with the least amount of
    downloaded and installed number of packages. After some tests, the "Basic
    scheme" seemed to be the best installation scheme and the extra necessary
    packages to successfully do the bootstrap were then found and included in
    the book along with some explanations so a new commer can have their TeX
    installation ready for the Gnuastro bootstrap easily.
---
 doc/gnuastro.texi |   48 +++++++++++++++++++++++++++++++++++++-----------
 1 file changed, 37 insertions(+), 11 deletions(-)

diff --git a/doc/gnuastro.texi b/doc/gnuastro.texi
index 8347fbc..2511ad3 100644
--- a/doc/gnuastro.texi
+++ b/doc/gnuastro.texi
@@ -2534,20 +2534,46 @@ thus put in a separate directory (@file{lib/}).
 GNU help2man is used to convert the output of the @option{--help} option
 (@ref{--help}) to the traditional Man page (@ref{Man pages}).
 
address@hidden @TeX{} Live
address@hidden @TeX{} Live
address@hidden @LaTeX{} and some @TeX{} packages
 @cindex @LaTeX{}
-Some of the figures in this book are built by @LaTeX{} (using the TikZ
address@hidden @TeX{} Live
+Some of the figures in this book are built by @LaTeX{} (using the PGF/TikZ
 package). The @LaTeX{} source for those figures is version controlled for
 easy maintenance not the actual figures. So the @file{./boostrap} script
-will run @LaTeX{} on the sources.
-
-Installing @TeX{} Live is very easy, simply go to its official webpage
-(@url{https://www.tug.org/texlive/}) and download the appropriate installer
-by following the ``download'' link. Just note that if you do intend to
-download the full package, it needs around 4 Giga-bytes of space, so its
-initial installation can be a little slow. After the installation be sure
-to follow the instructions in setting the environment variables.
+will run @LaTeX{} to build the figtures. The best way to install @LaTeX{}
+and all the necessary packages is through
address@hidden://www.tug.org/texlive/, @TeX{} live} which is a package manager
+for @TeX{} related tools that is independent of any operating system. It is
+thus preferred to the @TeX{} Live versions distributed by your operating
+system.
+
+To install @TeX{} Live, go to the webpage and download the appropriate
+installer by following the ``download'' link. Note that by default the full
+package repository will be downloaded and installed (around 4 Giga Bytes)
+which can take @emph{very} long to download and to update later. However,
+most packages are not needed by everyone, it is easier, faster and better
+to install only the ``Basic scheme'' (consisting of only the most basic
address@hidden and @LaTeX{} packages, which is less than 200 Mega
+bytes)@footnote{You can also download the DVD iso file at a later time to
+keep as a backup for when you don't have internet connection if you need a
+package.}.
+
+After the installation be sure to set the environment variables as
+suggested in the end of the outputs. Any time you confront (need) a package
+you don't have, simply install it with a command like below (similar to how
+you install software from your operating system's package
+manager)@footnote{After running @TeX{}, or @LaTeX{}, you might get a
+warning complaining about a @file{missingfile}. Run address@hidden info
+missingfile}' to see the package(s) containing that file which you can
+install.}. To install all the necessary @TeX{} packages for a successful
+Gnuastro bootstrap, run this command:
+
address@hidden
+$ su
+# tlmgr install epsf jknapltx caption biblatex biber iftex \
+                etoolbox logreq xstring xkeyval pgf ms     \
+                xcolor pgfplots times rsfs pstools epspdf
address@hidden example
 
 @item ImageMagick (@command{imagemagick})
 @cindex ImageMagick