[education/kstars] doc: Lastest changes

[Antoni Bella Pérez]

Git commit 7991d68f606c08752ef741b0a1036ecde81232e5 by Antoni Bella Pérez.
Committed on 26/07/2021 at 16:36.
Pushed by mutlaqja into branch 'master'.

Lastest changes

M  +3    -3    doc/altvstime.docbook
M  +1    -1    doc/eyepieceview.docbook
M  +7    -7    doc/scriptbuilder.docbook
M  +1    -1    doc/solarsys.docbook
M  +8    -9    doc/wut.docbook

https://invent.kde.org/education/kstars/commit/7991d68f606c08752ef741b0a1036ecde81232e5

diff --git a/doc/altvstime.docbook b/doc/altvstime.docbook
index 58c9f3b30..855ebd842 100644
--- a/doc/altvstime.docbook
+++ b/doc/altvstime.docbook
@@ -30,15 +30,15 @@ in this region are below the horizon.
 <para>
 There are a few ways to add curves to the plot.  The simplest way to
 add the curve of an existing object is to simply type its name in the
-<guilabel>Name</guilabel> input field, and press Enter, or the
+<guilabel>Name:</guilabel> input field, and press Enter, or the
 <guibutton>Plot</guibutton> button.  If the text you enter is found in
 the object database, the object's curve is added to the graph.  You
-can also press the <guibutton>Find Object</guibutton> button to open the
+can also press the <guibutton>Find Object...</guibutton> button to open the
 <link linkend="findobjects">Find Object Window</link> to select an
 object from the list of known objects.  If you want to add a point
 that does not exist in the object database, simply enter a name for
 the point, and then fill in the coordinates in the
-<guilabel>RA</guilabel> and <guilabel>Dec</guilabel> input fields.
+<guilabel>RA:</guilabel> and <guilabel>Dec:</guilabel> input fields.
 Then press the <guibutton>Plot</guibutton> button to add the curve for
 your custom object to the plot (note that you have to pick a name that
 does not already exist in the object database for this to work).
diff --git a/doc/eyepieceview.docbook b/doc/eyepieceview.docbook
index 1a23b8438..12b71be86 100644
--- a/doc/eyepieceview.docbook
+++ b/doc/eyepieceview.docbook
@@ -36,7 +36,7 @@ This tool simulates how an object looks through your eyepiece. In addition to re
 </itemizedlist>
 </para>
 
-<para>When the tool is first invoked, it will prompt a dialog to select the desired FOV to render the view. To compare the rendered view against a real sky image, click the <guibutton>Fetch DSS image</guibutton> button to download a DSS image. You can manually adjust the view to match your eyepiece using the rotation slider, the <guilabel>invert view</guilabel> and <guilabel>flip view</guilabel> check boxes. Alternatively, you can use a pre-calculated amount of rotation by using one of the <guilabel>Presets</guilabel> that is tailored for different optical systems.</para>
+<para>When the tool is first invoked, it will prompt a dialog to select the desired FOV to render the view. To compare the rendered view against a real sky image, click the <guibutton>Fetch DSS image</guibutton> button to download a DSS image. You can manually adjust the view to match your eyepiece using the rotation slider, the <guilabel>Invert view</guilabel> and <guilabel>Flip view</guilabel> check boxes. Alternatively, you can use a pre-calculated amount of rotation by using one item of the <guilabel>Preset:</guilabel> dropdown box that is tailored for different optical systems.</para>
 
 <screenshot>
 <screeninfo>
diff --git a/doc/scriptbuilder.docbook b/doc/scriptbuilder.docbook
index 4ef30ea34..6adc8505a 100644
--- a/doc/scriptbuilder.docbook
+++ b/doc/scriptbuilder.docbook
@@ -58,7 +58,7 @@ requires.
 </para><para>
 Along the top of the window, there is a row of buttons which operate
 on the script as a whole.  From left to right, they are:
-<guibutton>New Script</guibutton>, <guibutton>Open Script</guibutton>,
+<guibutton>New Script</guibutton>, <guibutton>Open Script...</guibutton>,
 <guibutton>Save Script</guibutton>, <guibutton>Save Script
 As...</guibutton>, and <guibutton>Test Script</guibutton>.  The
 function of these buttons should be obvious, except perhaps the last
@@ -98,9 +98,9 @@ will now contain a combobox labeled <quote>Dir</quote>, short for
 direction.  This is the direction in which the display should
 be pointed.  The combobox contains only the cardinal compass points,
 not the Moon or any other objects.  You can either enter
-<quote>Moon</quote> in the box manually, or press the
-<guibutton>Object</guibutton> button to use the <guilabel>Find
-Object</guilabel> window to select the Moon from the list of named
+<quote>Moon</quote> in the box manually, or press the <guibutton>Object...</guibutton>
+button to use the <guilabel>Find Object...</guilabel>
+window to select the Moon from the list of named
 objects.  Note that, as usual, centering on an object automatically
 engages object-tracking mode, so there is no need to add the
 <firstterm>setTracking</firstterm> function after lookToward.
@@ -137,7 +137,7 @@ options which can be adjusted by changeViewOption.  Since we know
 we want the UseAltAz option, we could simply select it from the
 combobox.  However, the list is quite long, and there is no
 explanation of what each item is for.  It therefore may be easier to
-press the <guibutton>Browse Tree</guibutton> button, which will open
+press the <guibutton>Browse Tree...</guibutton> button, which will open
 a window containing a tree view of the available options, organized by
 topic.  In addition, each item has a short explanation of what the
 option does, and the data type of the option's value.  We find
@@ -167,8 +167,8 @@ script file with any text editor.
 Now that we have a completed script, we can run it in a couple of ways.
 From a console prompt, you can simply execute the script as long as an
 instance of &kstars; is currently running.  Alternatively, you can execute
-the script from within &kstars; using the <guimenuitem>Run
-Script...</guimenuitem> item in the <guimenu>File</guimenu> menu.
+the script from within &kstars; using the <menuchoice><guimenu>File</guimenu>
+<guimenuitem>Run Script...</guimenuitem></menuchoice> menu item.
 </para>
 </sect2>
 </sect1>
diff --git a/doc/solarsys.docbook b/doc/solarsys.docbook
index 1f942a8a8..1cbcc3689 100644
--- a/doc/solarsys.docbook
+++ b/doc/solarsys.docbook
@@ -28,7 +28,7 @@ with a name label.  The display can be zoomed in and out with
 the <keycap>+</keycap> and <keycap>-</keycap> keys, and the
 display can be recentered with the arrow keys, or by
 double-clicking anywhere in the window with the mouse.  You can
-also center on a planet with the <keycap>0–9</keycap> keys
+also center on a planet with the <keycap>0</keycap>–<keycap>9</keycap> keys
 (<keycap>0</keycap> is the Sun; <keycap>9</keycap> is Pluto).
 If you center on a planet, it will be tracked as time passes in
 the tool.
diff --git a/doc/wut.docbook b/doc/wut.docbook
index 8a51dc158..feeb2abc2 100644
--- a/doc/wut.docbook
+++ b/doc/wut.docbook
@@ -23,8 +23,8 @@ The <quote>What's up Tonight?</quote> (WUT) tool displays a list of
 objects that will be visible at night from any location, on any date.
 By default, the Date and Location are taken from the current settings
 in the main window, but you can change either value using the
-<guibutton>Change Date</guibutton> and <guibutton>Change
-Location</guibutton> buttons at the top of the WUT window.
+<guibutton>Change Date...</guibutton> and <guibutton>Change Location...</guibutton>
+buttons at the top of the WUT window.
 </para>
 <para>
 The WUT tool also displays a short almanac of data for the selected
@@ -34,19 +34,18 @@ the night, and the Moon's illumination fraction.
 <para>
 Below the almanac is where the object information is displayed.  The
 objects are organized into type categories.  Select an object type
-in the box labeled <guilabel>Select a Category</guilabel>, and all
+in the box labeled <guilabel>Select a category:</guilabel>, and all
 objects of that type which are above the horizon on the selected
 night will be displayed in the box labeled <guilabel>Matching
-Objects</guilabel>.  For example, in the screenshot, the
+objects:</guilabel>.  For example, in the screenshot, the
 <guilabel>Planets</guilabel> category has been selected, and three
 planets which are up on the selected night are displayed (Mars,
 Jupiter and Saturn).  When an object in the list is selected,
 its rise, set and transit times are displayed in the lower-right
 panel (&ie; Mars rises at 17:13, transits at 21:46 and sets at 02:16).
-In addition, you can press the <guibutton>Object
-Details...</guibutton> button to open the <link
-linkend="tool-details">Object Details window</link> for that
-object.
+In addition, you can press the <guibutton>Object Details...</guibutton>
+button to open the <link linkend="tool-details">Object Details window</link>
+for that object.
 </para>
 <para>
 By default, the WUT will display objects which are above the horizon
@@ -56,7 +55,7 @@ You can choose to show objects which are up between midnight and dawn
 time tonight</quote>) using the combobox near the top of the window.
 You can also choose to see only those objects that are brighter than a
 magnitude by setting a minimum magnitude using the <guilabel>Show objects
-brighter than magnitude</guilabel> spinbox. You may center the selected object
+brighter than magnitude:</guilabel> spinbox. You may center the selected object
 in the Sky Map or add it to Wish List by pressing the
 <guibutton>Center Object</guibutton> or <guibutton>Add to List</guibutton> button.
 </para>