Guide: small fixes

guide/app_config_ini.tex

@@ -843,18 +843,19 @@ \subsection{\big[DialogSizes\big]}
 
 
 \subsection{\big[hips\big]}
-%\label{sec:config.ini:hips}
+\label{sec:config.ini:hips}
 
-This section define the source list of the HiPS surveys, as well as other
+This section defines the source list of the HiPS surveys, as well as other
 HiPS related options.
 \newFeature{0.18.0}
 
 \noindent%
 \begin{tabularx}{\textwidth}{l|l|X}\toprule
-\toprule
 \emph{ID}     & \emph{Type} & \emph{Description}\\\midrule
+show          & bool        & show HiPS at startup? \\
 sources/size  & int         & Number of HiPS survey sources\\%\midrule
-sources/n/url & string      & uri of the nth source hipslist file (n from 1 to sources/size)\\\bottomrule
+sources/n/url & string      & uri of the $n$th source hipslist file ($n \in [1 \ldots \mathtt{sources/size}]$)\\
+visible/url   & bool        & HiPS configured to be displayed. (Stores current setting on program exit)\\\bottomrule
 \end{tabularx}
 
 

guide/ch_interface.tex

@@ -581,20 +581,20 @@ \subsection{The Surveys Tab}
 supported.
 
 On the left side of the window we see the list of available surveys from
-the configured sources (See section \ref{sec:configini:hips} for how to
+the configured sources (See section \ref{sec:config.ini:hips} for how to
 change the default sources).  On the right side a description of the selected
 survey and its properties are displayed.
 
-Surveys are grouped by types. The top combobox allow to filter the listed
-survey according to a given type (Deep sky or Solar system).
+Surveys are grouped by types. The top combobox allows to filter the listed
+surveys according to a given type (Deep Sky or Solar System).
 
 You can toggle the visibility of a survey by checking the box on the left
 of the survey name in the list.  (Note that as of v0.18.0, only a single deep
-key survey can be rendered at once, so make sure that you only select one in
+sky survey can be rendered at a time, so it makes no sense to select more than one in
 the list!) Once a survey is visible you should be able to see its loading
 status in the loading bar area of the sky view.
 
-Deep sky surveys will be rendered on top of the sky view, while solar system
+Deep sky surveys will be rendered aligned with the sky view, while solar system
 surveys automatically map on the proper body.
 
 
@@ -671,14 +671,14 @@ \section{The Object Search Window}
 \section{The Astronomical Calculations Window}
 \label{sec:gui:AstroCalc}
 
-\newFeature{v0.15.0} This window provides advanced functionality, some of which is still in an experimental phase. 
+This window \newFeature{v0.15.0} provides advanced functionality, some of which is still in an experimental phase. 
 You can call it by pressing \key{F10} or the button \guibutton{0.6}{btd_astrocalc.png} on the left menu bar. 
 The Astronomical Calculations window shows six tabs with different functionality.
 
 \subsection{The Positions Tab}
 \label{sec:gui:AstroCalc:Positions}
 
-\newFeature{v0.16.0} This tab shows J2000.0 or horizontal positions, magnitudes and additional parameters 
+This tab \newFeature{v0.16.0} shows J2000.0 or horizontal positions, magnitudes and additional parameters 
 (e.g.\ surface brightness for deep-sky objects or angular separation for double stars) for various 
 lists of celestial objects above the horizon at the simulated time, filtered by magnitude. 
 Double-clicking on an entry brings the object into focus (Figure~\ref{fig:gui:AstroCalc:Positions}). 

guide/ch_introduction.tex

@@ -66,7 +66,7 @@ \section{Historical notes}
 \item[Timothy Reaves] ocular plugin
 \item[Bogdan Marinov] GUI, telescope control, other plugins
 \item[Diego Marcos] SVMT plugin
-\item[Guillaume Ch\'ereau] display, optimization, Qt upgrades
+\item[Guillaume Ch\'ereau] display, optimization, Qt upgrades, HiPS surveys
 \item[Alexander Wolf] maintainer, DSO catalogs, user guide, general development
 \item[Georg Zotti] astronomical computations, Scenery 3D and ArchaeoLines plugins, general development, user guide, user support
 \item[Marcos Cardinot] MeteorShowers plugin

guide/ch_surveys.tex

@@ -1,45 +1,45 @@
 
 \chapter{Surveys}
 \label{ch:surveys}
+\chapterauthor*{Guillaume Chéreau}
 
 \section{Introduction}
 \label{sec:surveys:introduction}
 
 
-A sky survey is a map of the sky stored as a hierarchical set of a potentially
+A \indexterm{sky survey} \newFeature{v0.18.0} is a map of the sky stored as a hierarchical set of a potentially
 large number of smaller images (called tiles).  The advantage compared to a
-regular texture is that we can render only the visible tiles of an image at the
+regular texture is that we need to render only the visible tiles of a potentially gigantic image at the
 lowest resolution needed.  This is particularly interesting for rendering
 online images that can be stored on a server, while the client only has
 to download the parts he currently uses.
 
 Since version 0.18.0, Stellarium added some preliminary support for loading and
-rendering online surveys in the Hierarchical Progressive Surveys (HiPS) format,
-developed by the International Virtual Observatory Alliance.
-A full description of the format can be found on the IVOA website:
-\url{http://www.ivoa.net/documents/HiPS/20170519/REC-HIPS-1.0-20170519.pdf}
+rendering online surveys in the \indexterm{Hierarchical Progressive Surveys} (HiPS) format,
+developed by the \indexterm{International Virtual Observatory Alliance}.
+A full description of the format can be found on the IVOA website\footnote{%
+\url{http://www.ivoa.net/documents/HiPS/20170519/REC-HIPS-1.0-20170519.pdf}}.
 
 \section{Hipslist file and default surveys}
 \label{sec:surveys:hipslistFile}
 
 Hipslist files are text files used to describe catalogs of HiPS surveys.  The
 full specification is part of the HiPS format, and looks like that:
 
-\begin{configfile}
+\begin{configfileScr}
 # Example of a hipslist file.
 # Date: 2018-03-19
 
 hips_service_url  = https://data.stellarium.org/surveys/callisto
 hips_release_date = 2018-03-18T14:01Z
 hips_status       = public mirror clonableOnce
-\end{configfile}
+\end{configfileScr}
 
 As of v0.18.0, by default Stellarium tries to load HiPS from two sources:
 \url{http://alaskybis.unistra.fr/hipslist} and
 \url{https://data.stellarium.org/surveys/hipslist}.
-
 This can be changed with the hips/sources options in the configuration
-file.  For example:
+file (see also section~\ref{sec:config.ini:hips}).  For example:
 
 \begin{configfile}
 [hips]