[kde-doc-english] [kstars] doc: Made a separate documentation page for each configuration tab (i.e. Catalogs, Satellites, Colors, Indi, Ekos)
Raphael Cojocaru
raphael.cojocaru at yahoo.com
Fri Jul 15 18:50:19 UTC 2016
Git commit 6ac389c81de73b71d3f78df47fc74816c5498e79 by Raphael Cojocaru.
Committed on 15/07/2016 at 18:50.
Pushed by raphaelc into branch 'master'.
Made a separate documentation page for each configuration tab (i.e. Catalogs, Satellites, Colors, Indi, Ekos)
A +- -- doc/advanced_tab.png
A +- -- doc/colors_tab.png
M +314 -142 doc/config.docbook
A +- -- doc/ekos_tab.png
A +- -- doc/guides_tab.png
A +- -- doc/indi_tab.png
A +- -- doc/satellites_tab.png
A +- -- doc/solarsystem_tab.png
A +- -- doc/supernovae_tab.png
http://commits.kde.org/kstars/6ac389c81de73b71d3f78df47fc74816c5498e79
diff --git a/doc/advanced_tab.png b/doc/advanced_tab.png
new file mode 100644
index 0000000..568499b
Binary files /dev/null and b/doc/advanced_tab.png differ
diff --git a/doc/colors_tab.png b/doc/colors_tab.png
new file mode 100644
index 0000000..1f80d81
Binary files /dev/null and b/doc/colors_tab.png differ
diff --git a/doc/config.docbook b/doc/config.docbook
index 3e9d3aa..0e74d84 100644
--- a/doc/config.docbook
+++ b/doc/config.docbook
@@ -141,8 +141,7 @@ The window is depicted below:
</para>
<para>
-The <guilabel>Configure &kstars;</guilabel> window is divided into ten
-pages:
+The <guilabel>Configure &kstars;</guilabel> window is divided into nine pages:
<guilabel>Catalogs</guilabel>, <guilabel>Solar System</guilabel>, <guilabel>Satellites</guilabel>,
<guilabel>Supernovae</guilabel>, <guilabel>Guides</guilabel>, <guilabel>Colors</guilabel>,
<guilabel>INDI</guilabel>, <guilabel>Ekos</guilabel> and <guilabel>Advanced</guilabel>.
@@ -152,81 +151,27 @@ pages:
<indexterm><primary>Configure &kstars; window</primary>
<secondary>Catalogs page</secondary></indexterm>
In the <guilabel>Catalogs</guilabel> page, you determine which object
-catalogs are displayed in the map. The <guilabel>Stars</guilabel> section
-also allows you to set the
-<quote>faint <link linkend="ai-magnitude">magnitude</link> limit</quote>
-for stars, and the <link linkend="ai-magnitude">magnitude</link> limit for
-displaying the names and/or magnitudes of stars. Below the stars section,
-the <guilabel>Deep-Sky Objects</guilabel> section controls the display of
-several non-stellar object catalogs. By default, the list includes the
-Messier, NGC and IC catalogs. You can add your own custom object catalogs
-by pressing the <guibutton>Import Catalog</guibutton> or <guilabel>Load Catalog</guilabel> button. For
-detailed instructions on preparing a catalog data file, see the
-<filename>README.customize</filename> file that ships with &kstars;. It is possible to define
-faint limits for sky objects for zoomed in and zoomed out states of the rendering. When
-the <guilabel>Show objects of unknown magnitude</guilabel> item is enabled, objects whose
-magnitudes are unknown, or not available to &kstars;, are drawn irrespective of the faint limits set.
+catalogs are displayed in the map along with several properties.
</para>
+
<para>
<indexterm><primary>Configure &kstars; window</primary>
<secondary>Solar System page</secondary></indexterm>
In the <guilabel>Solar System</guilabel> page, you can specify whether
-the Sun, Moon, planets, comets and asteroids are displayed, and
-whether the major bodies are drawn as colored circles or actual images.
-You can also toggle whether solar system bodies have name labels attached,
-and control how many of the comets and asteroids get name labels.
-There is an option to automatically attach a temporary <quote>orbit
-trail</quote> whenever a solar system body is tracked, and another to
-toggle whether the color of the orbit trail fades into the background
-sky color.
+the Sun, Moon, planets, comets and asteroids are displayed.
</para>
<!-- Satellites page: -->
<para>
<indexterm><primary>Configure &kstars; window</primary>
<secondary>Satellites page</secondary></indexterm>
-The <guilabel>Satellites</guilabel> page allows you to set the satellites view options. Firstly,
-you can see or hide the satellites on the skymap using <guilabel>Show satellites</guilabel> checkbox
-from the top <guilabel>View options</guilabel> section. By default, satellites are drawn as small
-light red filled circles with an optional dark red name label next to them. You can enable or disable
-these labels by checking or not the <guilabel>Show labels</guilabel> checkbox. It is located below
-the <guilabel>Show satellites</guilabel> checkbox, within the <guilabel>View options</guilabel> section.
-The colors of the dots representing satellites and their name labels can be easily customized using
-the <guilabel>Colors</guilabel> page from the same <guilabel>Configure &kstars;</guilabel> window.
-In addition, satellites can be drawn just like regular stars by checking the <guilabel>Draw satellites
-like stars</guilabel> checkbox. To display only the visible satellites from your current geographic location
-and time, select <guilabel>Show only visible satellites</guilabel>.
-&kstars; can draw artificial satellites from many predefined groups. Thus, you can select to display a particular
-group, multiple groups or partially select subgroups. Under each group, a list of individual satellites is
-presented. To select all satellites from a group, you need to check the group checkbox. You can also select
-only the satellites of interest in each group.
-The satellites orbital elements can be updated via the internet by pressing the <guibutton>Update TLEs</guibutton>
-button. Another way for updating the satellites orbital elements is to use the <menuchoice>
-<guisubmenu>Updates</guisubmenu><guimenuitem>Update satellites orbital elements</guimenuitem></menuchoice> in the
-<guimenu>Data</guimenu> menu. If you know the name of a desired satellite then you can use
-the search satellites method that &kstars; provides. You need to enter the name of satellite in the <guilabel>Search
-satellites</guilabel> text box and the list will be reduced only to its best matches.
-You can add new satellites to &kstars; default satellites set by editing the <filename>kstars/data/satellites.dat</filename> file.
-As each line of this file is a group of satellites, you need to add a new entry for your desired satellites group.
-An entry should have the following format: <userinput>Group Name;local_filename;url</userinput>.
-For example: <userinput>Iridium;iridium.tle;http://celestrak.com/NORAD/elements/iridium.txt</userinput>.
+The <guilabel>Satellites</guilabel> page allows you to set the satellites view options.
</para>
<!-- Supernovae page: -->
<para>
<indexterm><primary>Configure &kstars; window</primary>
<secondary>Supernovae page</secondary></indexterm>
-The <guilabel>Supernovae</guilabel> page allows you to decide if the supernovae are displayed or not by checking
-the <guilabel>Show supernovae</guilabel> checkbox. By default, supernovae are drawn as small light orange <quote>+</quote> mark.
-As for satellites, the color of supernovae can be easily customized using the <guilabel>Colors</guilabel> page.
-You can configure &kstars; to check for newly discovered supernovae on startup by checking the <guilabel>Check for
-Recent Supernovae on Startup</guilabel> checkbox. This way, &kstars; will be always up-to-date with the most recent
-supernovae. You can enable supernova alerts using the <guilabel>Enable Supernova alerts</guilabel> checkbox. Thus,
-&kstars; will automatically alert you every time it learns of a new supernova in the sky. You can set the magnitude
-limit for showing a supernova as well as magnitude limit for supernova alerts using the spin boxes control. The
-limiting magnitude is the faintest apparent magnitude of an skyobject that is visible with the naked-eye or a telescope.
-The list of recent supernovae can be updated via the internet by pressing the <guibutton>Update List of Recent
-Supernovae</guibutton> button. Another way for updating the supernovae list is to use the
-<menuchoice><guisubmenu>Updates</guisubmenu><guimenuitem>Update Recent Supernovae data</guimenuitem></menuchoice> item in the <guimenu>Data</guimenu> menu.
+The <guilabel>Supernovae</guilabel> page allows you to manage how supernovae are displayed by &kstars;.
</para>
<para>
@@ -234,52 +179,24 @@ Supernovae</guibutton> button. Another way for updating the supernovae list is t
<secondary>Guides page</secondary></indexterm>
The <guilabel>Guides</guilabel> page lets you toggle whether non-objects
are displayed (&ie;, constellation lines, constellation names, the
-Milky Way contour, the <link linkend="ai-cequator">celestial
-equator</link>, <link linkend="ai-ecliptic">the ecliptic</link>, <link
-linkend="ai-horizon">the horizon line</link>, and the opaque ground).
-You can also choose whether you would like to see Latin constellation
-names, <acronym>IAU</acronym>-standard three-letter abbreviations, or
-constellation names using your local language.
+Milky Way contour).
</para>
+
<para>
<indexterm><primary>Configure &kstars; window</primary>
<secondary>Colors page</secondary></indexterm>
<indexterm><primary>Color Schemes</primary>
<secondary>Customizing</secondary></indexterm>
The <guilabel>Colors</guilabel> page allows you to set the color scheme,
-and to define custom color schemes. The tab is split into two panels:
-</para>
-<para>
-The left panel shows a list of all display items with adjustable
-colors. Click on any item to bring up a color selection window to
-adjust its color. Below the list is the <guilabel>Star Color
-Mode</guilabel> selection box. By default, &kstars; draws stars with
-a <link linkend="ai-colorandtemp">realistic color</link> tint according
-to the spectral type of the star. However, you may also choose to draw
-the stars as solid white, black or red circles. If you are using the
-realistic star colors, you can set the saturation level of the star
-colors with the <guilabel>Star Color Intensity</guilabel> spinbox.
-</para>
-<para>
-The right panel lists the defined color schemes. There are four
-predefined schemes: the <guilabel>Default Colors</guilabel> scheme,
-<guilabel>Star Chart</guilabel>, which uses black stars on a white
-background, <guilabel>Night Vision</guilabel>, which uses only shades
-of red in order to protect dark-adapted vision, and <guilabel>Moonless
-Night</guilabel>, a more realistic, dark theme. Additionally,
-you can save the current color settings as a custom scheme by clicking
-the <guibutton>Save Current Colors</guibutton> button. It will prompt
-you for a name for the new scheme, and then your scheme will appear in
-the list in all future &kstars; sessions. To remove a custom scheme,
-simply highlight it in the list, and press the <guibutton>Remove Color
-Scheme</guibutton> button.
+and to define new custom color schemes.
</para>
+
<para>For detailed explanation of the options on the <guilabel>INDI</guilabel>
page see the <link linkend="indi-configure">Configure INDI</link> section.
</para>
-<para>For detailed explanation of the options on the <guilabel>Ekos</guilabel>
-page see the <link linkend="indi-configure">Configure Ekos</link> section.
+<para>For detailed explanation of <guilabel>Ekos</guilabel> astrophotography suite,
+see the official <ulink url="http://www.indilib.org/about/ekos.html">Ekos</ulink> page.
</para>
<para>
@@ -287,53 +204,6 @@ page see the <link linkend="indi-configure">Configure Ekos</link> section.
<secondary>Advanced page</secondary></indexterm>
The <guilabel>Advanced</guilabel> page provides fine-grained control
over the more subtle behaviors of &kstars;.
-</para><para>
-<indexterm><primary>Atmospheric Refraction</primary></indexterm>
-The <guilabel>Correct for atmospheric refraction</guilabel> checkbox
-controls whether the positions of objects are corrected for the effects
-of the atmosphere. Because the atmosphere is a spherical shell, light from
-outer space is <quote>bent</quote> as it passes through the atmosphere to
-our telescopes or eyes on the Earth's surface. The effect is largest for
-objects near the horizon, and actually changes the predicted rise or set
-times of objects by a few minutes. In fact, when you <quote>see</quote> a
-sunset, the Sun's actual position is already well below the horizon;
-atmospheric refraction makes it seem as if the Sun is still in the sky.
-Note that atmospheric refraction is never applied if you are using
-<guilabel>Equatorial coordinates</guilabel>.
-</para><para>
-<indexterm><primary>Animated Slewing</primary></indexterm>
-The <guilabel>Use animated slewing</guilabel> checkbox controls how the
-display changes when a new focus position is selected in the map. By
-default, you will see the sky drift or <quote>slew</quote> to the new
-position; if you uncheck this option, then the display will instead
-<quote>snap</quote> immediately to the new focus position.
-</para><para>
-<indexterm><primary>Objects in the Sky</primary>
-<secondary>Labeling</secondary>
-<tertiary>Automatic</tertiary>
-</indexterm>
-If the <guilabel>Attach label to centered object</guilabel> checkbox is
-selected, then a name label will automatically be attached to an object
-when it is being tracked by the program. The label will be removed when
-the object is no longer being tracked. Note that you can also manually
-attach a persistent name label to any object with its <link
-linkend="popup-menu">popup menu</link>.
-</para><para>
-<indexterm><primary>Objects in the Sky</primary>
-<secondary>Hiding</secondary></indexterm>
-There are three situations when &kstars; must redraw the sky display very
-rapidly: when a new focus position is selected (and <guilabel>Use
-animated slewing</guilabel> is checked), when the sky is dragged with the
-mouse, and when the time step is large. In these situations, the positions
-of all objects must be recomputed as rapidly as possible, which can put
-a large load on the <abbrev>CPU</abbrev>. If the <abbrev>CPU</abbrev>
-cannot keep up with the demand, then the display will seem sluggish or jerky.
-To mitigate this, &kstars; will hide certain objects during these rapid-redraw
-situations, as long as the <guilabel>Hide objects while moving</guilabel>
-checkbox is selected. The timestep threshold above which objects will be
-hidden is determined by the <guilabel>Also hide if time step larger
-than:</guilabel> timestep-spinbox. You can specify the objects that should
-be hidden in the <guilabel>Configure Hidden Objects</guilabel> group box.
</para>
</sect1>
@@ -705,6 +575,308 @@ magnitudes are unknown, or not available to &kstars;, are drawn irrespective of
</para>
</sect1>
+<sect1 id="solar_system">
+<title>Solar System</title>
+<para>
+<screenshot>
+<screeninfo>Solar System Window</screeninfo>
+<mediaobject>
+ <imageobject>
+ <imagedata fileref="solarsystem_tab.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>Solar System Window</phrase>
+ </textobject>
+</mediaobject>
+</screenshot>
+<para>
+<indexterm><primary>Configure &kstars; window</primary>
+<secondary>Solar System page</secondary></indexterm>
+In the <guilabel>Solar System</guilabel> page, you can specify whether
+the Sun, Moon, planets, comets and asteroids are displayed, and
+whether the major bodies are drawn as colored circles or actual images.
+You can also toggle whether solar system bodies have name labels attached,
+and control how many of the comets and asteroids get name labels.
+There is an option to automatically attach a temporary <quote>orbit
+trail</quote> whenever a solar system body is tracked, and another to
+toggle whether the color of the orbit trail fades into the background
+sky color.
+</para>
+</para>
+</sect1>
+
+<sect1 id="satellites">
+<title>Satellites</title>
+<para>
+<screenshot>
+<screeninfo>Satellites Window</screeninfo>
+<mediaobject>
+ <imageobject>
+ <imagedata fileref="satellites_tab.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>Satellites Window</phrase>
+ </textobject>
+</mediaobject>
+</screenshot>
+<para>
+<indexterm><primary>Configure &kstars; window</primary>
+<secondary>Satellites page</secondary></indexterm>
+The <guilabel>Satellites</guilabel> page allows you to set the satellites view options. Firstly,
+you can see or hide the satellites on the skymap using <guilabel>Show satellites</guilabel> checkbox
+from the top <guilabel>View options</guilabel> section. By default, satellites are drawn as small
+light red filled circles with an optional dark red name label next to them. You can enable or disable
+these labels by checking or not the <guilabel>Show labels</guilabel> checkbox. It is located below
+the <guilabel>Show satellites</guilabel> checkbox, within the <guilabel>View options</guilabel> section.
+The colors of the dots representing satellites and their name labels can be easily customized using
+the <guilabel>Colors</guilabel> page from the same <guilabel>Configure &kstars;</guilabel> window.
+In addition, satellites can be drawn just like regular stars by checking the <guilabel>Draw satellites
+like stars</guilabel> checkbox. To display only the visible satellites from your current geographic location
+and time, select <guilabel>Show only visible satellites</guilabel>.
+&kstars; can draw artificial satellites from many predefined groups. Thus, you can select to display a particular
+group, multiple groups or partially select subgroups. Under each group, a list of individual satellites is
+presented. To select all satellites from a group, you need to check the group checkbox. You can also select
+only the satellites of interest in each group.
+The satellites orbital elements can be updated via the internet by pressing the <guibutton>Update TLEs</guibutton>
+button. Another way for updating the satellites orbital elements is to use the <menuchoice>
+<guisubmenu>Updates</guisubmenu><guimenuitem>Update satellites orbital elements</guimenuitem></menuchoice> in the
+<guimenu>Data</guimenu> menu. If you know the name of a desired satellite then you can use
+the search satellites method that &kstars; provides. You need to enter the name of satellite in the <guilabel>Search
+satellites</guilabel> text box and the list will be reduced only to its best matches.
+You can add new satellites to &kstars; default satellites set by editing the <filename>kstars/data/satellites.dat</filename> file.
+As each line of this file is a group of satellites, you need to add a new entry for your desired satellites group.
+An entry should have the following format: <userinput>Group Name;local_filename;url</userinput>.
+For example: <userinput>Iridium;iridium.tle;http://celestrak.com/NORAD/elements/iridium.txt</userinput>.
+</para>
+</para>
+</sect1>
+
+<sect1 id="supernovae">
+<title>Supernovae</title>
+<para>
+<screenshot>
+<screeninfo>Supernovae Window</screeninfo>
+<mediaobject>
+ <imageobject>
+ <imagedata fileref="supernovae_tab.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>Supernovae Window</phrase>
+ </textobject>
+</mediaobject>
+</screenshot>
+<para>
+<indexterm><primary>Configure &kstars; window</primary>
+<secondary>Supernovae page</secondary></indexterm>
+The <guilabel>Supernovae</guilabel> page allows you to decide if the supernovae are displayed or not by checking
+the <guilabel>Show supernovae</guilabel> checkbox. By default, supernovae are drawn as small light orange <quote>+</quote> mark.
+As for satellites, the color of supernovae can be easily customized using the <guilabel>Colors</guilabel> page.
+You can configure &kstars; to check for newly discovered supernovae on startup by checking the <guilabel>Check for
+Recent Supernovae on Startup</guilabel> checkbox. This way, &kstars; will be always up-to-date with the most recent
+supernovae. You can enable supernova alerts using the <guilabel>Enable Supernova alerts</guilabel> checkbox. Thus,
+&kstars; will automatically alert you every time it learns of a new supernova in the sky. You can set the magnitude
+limit for showing a supernova as well as magnitude limit for supernova alerts using the spin boxes control. The
+limiting magnitude is the faintest apparent magnitude of an skyobject that is visible with the naked-eye or a telescope.
+The list of recent supernovae can be updated via the internet by pressing the <guibutton>Update List of Recent
+Supernovae</guibutton> button. Another way for updating the supernovae list is to use the
+<menuchoice><guisubmenu>Updates</guisubmenu><guimenuitem>Update Recent Supernovae data</guimenuitem></menuchoice> item in the <guimenu>Data</guimenu> menu.
+</para>
+</para>
+</sect1>
+
+<sect1 id="guides">
+<title>Guides</title>
+<para>
+<screenshot>
+<screeninfo>Guides Window</screeninfo>
+<mediaobject>
+ <imageobject>
+ <imagedata fileref="guides_tab.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>Guides Window</phrase>
+ </textobject>
+</mediaobject>
+</screenshot>
+<para>
+<indexterm><primary>Configure &kstars; window</primary>
+<secondary>Guides page</secondary></indexterm>
+The <guilabel>Guides</guilabel> page lets you toggle whether non-objects
+are displayed (&ie;, constellation lines, constellation names, the
+Milky Way contour, the <link linkend="ai-cequator">celestial
+equator</link>, <link linkend="ai-ecliptic">the ecliptic</link>, <link
+linkend="ai-horizon">the horizon line</link>, and the opaque ground).
+You can also choose whether you would like to see Latin constellation
+names, <acronym>IAU</acronym>-standard three-letter abbreviations, or
+constellation names using your local language.
+</para>
+</para>
+</sect1>
+
+<sect1 id="colors">
+<title>Colors</title>
+<para>
+<screenshot>
+<screeninfo>Colors Window</screeninfo>
+<mediaobject>
+ <imageobject>
+ <imagedata fileref="colors_tab.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>Colors Window</phrase>
+ </textobject>
+</mediaobject>
+</screenshot>
+<para>
+<indexterm><primary>Configure &kstars; window</primary>
+<secondary>Colors page</secondary></indexterm>
+<indexterm><primary>Color Schemes</primary>
+<secondary>Customizing</secondary></indexterm>
+The <guilabel>Colors</guilabel> page allows you to set the color scheme,
+and to define custom color schemes. The tab is split into two panels:
+</para>
+<para>
+The left panel shows a list of all display items with adjustable
+colors. Click on any item to bring up a color selection window to
+adjust its color. Below the list is the <guilabel>Star Color
+Mode</guilabel> selection box. By default, &kstars; draws stars with
+a <link linkend="ai-colorandtemp">realistic color</link> tint according
+to the spectral type of the star. However, you may also choose to draw
+the stars as solid white, black or red circles. If you are using the
+realistic star colors, you can set the saturation level of the star
+colors with the <guilabel>Star Color Intensity</guilabel> spinbox.
+</para>
+<para>
+The right panel lists the defined color schemes. There are four
+predefined schemes: the <guilabel>Default Colors</guilabel> scheme,
+<guilabel>Star Chart</guilabel>, which uses black stars on a white
+background, <guilabel>Night Vision</guilabel>, which uses only shades
+of red in order to protect dark-adapted vision, and <guilabel>Moonless
+Night</guilabel>, a more realistic, dark theme. Additionally,
+you can save the current color settings as a custom scheme by clicking
+the <guibutton>Save Current Colors</guibutton> button. It will prompt
+you for a name for the new scheme, and then your scheme will appear in
+the list in all future &kstars; sessions. To remove a custom scheme,
+simply highlight it in the list, and press the <guibutton>Remove Color
+Scheme</guibutton> button.
+</para>
+</para>
+</sect1>
+
+<sect1 id="indi_tab">
+<title>INDI</title>
+<para>
+<screenshot>
+<screeninfo>INDI Window</screeninfo>
+<mediaobject>
+ <imageobject>
+ <imagedata fileref="indi_tab.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>INDI Window</phrase>
+ </textobject>
+</mediaobject>
+</screenshot>
+<para>For detailed explanation of the options on the <guilabel>INDI</guilabel>
+page see the <link linkend="indi-configure">Configure INDI</link> section.
+</para>
+</para>
+</sect1>
+
+<sect1 id="ekos">
+<title>Ekos</title>
+<para>
+<screenshot>
+<screeninfo>Ekos Window</screeninfo>
+<mediaobject>
+ <imageobject>
+ <imagedata fileref="ekos_tab.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>Ekos Window</phrase>
+ </textobject>
+</mediaobject>
+</screenshot>
+<para>
+Ekos is an astrophotography suite, a complete astrophotography solution that can control
+all INDI devices including numerous telescopes, CCDs, DSLRs, focusers, filters, and a lot more.
+Ekos supports highly accurate tracking using online and offline astrometry solver, autofocus
+and autoguiding capabilities, and capture of single or multiple images using the powerful
+built in sequence manager. For detailed explanation of <guilabel>Ekos</guilabel>,
+see the official <ulink url="http://www.indilib.org/about/ekos.html">Ekos</ulink> page.
+</para>
+</para>
+</sect1>
+
+<sect1 id="advanced">
+<title>Advanced</title>
+<para>
+<screenshot>
+<screeninfo>Advanced Window</screeninfo>
+<mediaobject>
+ <imageobject>
+ <imagedata fileref="advanced_tab.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>Advanced Window</phrase>
+ </textobject>
+</mediaobject>
+</screenshot>
+<para>
+<indexterm><primary>Configure &kstars; window</primary>
+<secondary>Advanced page</secondary></indexterm>
+The <guilabel>Advanced</guilabel> page provides fine-grained control
+over the more subtle behaviors of &kstars;.
+</para><para>
+<indexterm><primary>Atmospheric Refraction</primary></indexterm>
+The <guilabel>Correct for atmospheric refraction</guilabel> checkbox
+controls whether the positions of objects are corrected for the effects
+of the atmosphere. Because the atmosphere is a spherical shell, light from
+outer space is <quote>bent</quote> as it passes through the atmosphere to
+our telescopes or eyes on the Earth's surface. The effect is largest for
+objects near the horizon, and actually changes the predicted rise or set
+times of objects by a few minutes. In fact, when you <quote>see</quote> a
+sunset, the Sun's actual position is already well below the horizon;
+atmospheric refraction makes it seem as if the Sun is still in the sky.
+Note that atmospheric refraction is never applied if you are using
+<guilabel>Equatorial coordinates</guilabel>.
+</para><para>
+<indexterm><primary>Animated Slewing</primary></indexterm>
+The <guilabel>Use animated slewing</guilabel> checkbox controls how the
+display changes when a new focus position is selected in the map. By
+default, you will see the sky drift or <quote>slew</quote> to the new
+position; if you uncheck this option, then the display will instead
+<quote>snap</quote> immediately to the new focus position.
+</para><para>
+<indexterm><primary>Objects in the Sky</primary>
+<secondary>Labeling</secondary>
+<tertiary>Automatic</tertiary>
+</indexterm>
+If the <guilabel>Attach label to centered object</guilabel> checkbox is
+selected, then a name label will automatically be attached to an object
+when it is being tracked by the program. The label will be removed when
+the object is no longer being tracked. Note that you can also manually
+attach a persistent name label to any object with its <link
+linkend="popup-menu">popup menu</link>.
+</para><para>
+<indexterm><primary>Objects in the Sky</primary>
+<secondary>Hiding</secondary></indexterm>
+There are three situations when &kstars; must redraw the sky display very
+rapidly: when a new focus position is selected (and <guilabel>Use
+animated slewing</guilabel> is checked), when the sky is dragged with the
+mouse, and when the time step is large. In these situations, the positions
+of all objects must be recomputed as rapidly as possible, which can put
+a large load on the <abbrev>CPU</abbrev>. If the <abbrev>CPU</abbrev>
+cannot keep up with the demand, then the display will seem sluggish or jerky.
+To mitigate this, &kstars; will hide certain objects during these rapid-redraw
+situations, as long as the <guilabel>Hide objects while moving</guilabel>
+checkbox is selected. The timestep threshold above which objects will be
+hidden is determined by the <guilabel>Also hide if time step larger
+than:</guilabel> timestep-spinbox. You can specify the objects that should
+be hidden in the <guilabel>Configure Hidden Objects</guilabel> group box.
+</para>
+</para>
+</sect1>
<sect1 id="customize">
<title>Customizing the Display</title>
diff --git a/doc/ekos_tab.png b/doc/ekos_tab.png
new file mode 100644
index 0000000..b9c3cd6
Binary files /dev/null and b/doc/ekos_tab.png differ
diff --git a/doc/guides_tab.png b/doc/guides_tab.png
new file mode 100644
index 0000000..5a43f96
Binary files /dev/null and b/doc/guides_tab.png differ
diff --git a/doc/indi_tab.png b/doc/indi_tab.png
new file mode 100644
index 0000000..658d286
Binary files /dev/null and b/doc/indi_tab.png differ
diff --git a/doc/satellites_tab.png b/doc/satellites_tab.png
new file mode 100644
index 0000000..fac975e
Binary files /dev/null and b/doc/satellites_tab.png differ
diff --git a/doc/solarsystem_tab.png b/doc/solarsystem_tab.png
new file mode 100644
index 0000000..ecd98b3
Binary files /dev/null and b/doc/solarsystem_tab.png differ
diff --git a/doc/supernovae_tab.png b/doc/supernovae_tab.png
new file mode 100644
index 0000000..91b7d29
Binary files /dev/null and b/doc/supernovae_tab.png differ
More information about the kde-doc-english
mailing list