Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdeedu@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 1192 insertions, 0 deletions

diff --git a/doc/kstars/commands.docbook b/doc/kstars/commands.docbook
new file mode 100644
index 00000000..0efacac9
--- /dev/null
+++ b/doc/kstars/commands.docbook
@@ -0,0 +1,1192 @@
+<chapter id="commands">
+<title>Command Reference</title>
+
+<sect1 id="kstars-menus">
+<title>Menu Commands</title>
+<indexterm><primary>Commands</primary><secondary>Menu</secondary></indexterm>
+
+<sect2 id="filemenu">
+<title><guimenu>File</guimenu> Menu</title>
+
+<variablelist>
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
+</shortcut>
+<guimenu>File</guimenu>
+<guimenuitem>New Window</guimenuitem>
+</menuchoice></term>
+<listitem><para>Open another &kstars; window
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>W</keycap></keycombo>
+</shortcut>
+<guimenu>File</guimenu>
+<guimenuitem>Close Window</guimenuitem>
+</menuchoice></term>
+<listitem><para>Close &kstars; window
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>D</keycap></keycombo>
+</shortcut>
+<guimenu>File</guimenu>
+<guimenuitem>Download Data...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Open the <guilabel>Download Extra Data</guilabel> tool
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo>
+</shortcut>
+<guimenu>File</guimenu>
+<guimenuitem>Open FITS...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Open a FITS image in the FITS Editor tool
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>I</keycap></keycombo>
+</shortcut>
+<guimenu>File</guimenu>
+<guimenuitem>Save Sky Image...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Create image on disk from current display
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>R</keycap></keycombo>
+</shortcut>
+<guimenu>File</guimenu>
+<guimenuitem>Run Script...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Run the specified KStars script
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo>
+</shortcut>
+<guimenu>File</guimenu>
+<guimenuitem>Print...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Send the current sky map to the printer (or to a
+PostScript/PDF file)
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
+</shortcut>
+<guimenu>File</guimenu>
+<guimenuitem>Quit</guimenuitem>
+</menuchoice></term>
+<listitem><para>Quit &kstars;
+</para></listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+
+<sect2 id="timemenu">
+<title><guimenu>Time</guimenu> Menu</title>
+
+<variablelist>
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>E</keycap></keycombo>
+</shortcut>
+<guimenu>Time</guimenu>
+<guimenuitem>Set Time to Now</guimenuitem>
+</menuchoice></term>
+<listitem><para>Sync time to system clock</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo>
+</shortcut>
+<guimenu>Time</guimenu>
+<guimenuitem>Set Time...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Set time and date</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Time</guimenu>
+<guimenuitem>Start/Stop Clock</guimenuitem>
+</menuchoice></term>
+<listitem><para>Toggle whether time passes</para></listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+
+<sect2 id="pointmenu">
+<title><guimenu>Pointing</guimenu> Menu</title>
+
+<variablelist>
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycap>Z</keycap>
+</shortcut>
+<guimenu>Pointing</guimenu>
+<guimenuitem>Zenith</guimenuitem>
+</menuchoice></term>
+<listitem><para>Center the display at the
+<link linkend="ai-zenith">Zenith</link> point (straight up)
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycap>N</keycap>
+</shortcut>
+<guimenu>Pointing</guimenu>
+<guimenuitem>North</guimenuitem>
+</menuchoice></term>
+<listitem><para>Center the display above the North point on the
+horizon</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycap>E</keycap>
+</shortcut>
+<guimenu>Pointing</guimenu>
+<guimenuitem>East</guimenuitem>
+</menuchoice></term>
+<listitem><para>Center the display above the East point on the
+horizon</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycap>S</keycap>
+</shortcut>
+<guimenu>Pointing</guimenu>
+<guimenuitem>South</guimenuitem>
+</menuchoice></term>
+<listitem><para>Center the display above the South point on the
+horizon</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycap>W</keycap>
+</shortcut>
+<guimenu>Pointing</guimenu>
+<guimenuitem>West</guimenuitem>
+</menuchoice></term>
+<listitem><para>Center the display above the West point on the
+horizon</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>M</keycap></keycombo>
+</shortcut>
+<guimenu>Pointing</guimenu>
+<guimenuitem>Set Focus Manually...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Center the display on specific
+<link linkend="ai-skycoords">sky coordinates</link>
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo>
+</shortcut>
+<guimenu>Pointing</guimenu>
+<guimenuitem>Find Object</guimenuitem>
+</menuchoice></term>
+<listitem><para>Locate an object by name using the
+<link linkend="findobjects">Find Object Window</link></para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>T</keycap></keycombo>
+</shortcut>
+<guimenu>Pointing</guimenu>
+<guimenuitem>Engage/Stop Tracking</guimenuitem>
+</menuchoice></term>
+<listitem><para>Toggle tracking on/off.  While tracking,
+the display will remain centered on the current position or
+object.</para></listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+
+<sect2 id="viewmenu">
+<title><guimenu>View</guimenu> Menu</title>
+
+<variablelist>
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycap>+</keycap>
+</shortcut>
+<guimenu>View</guimenu>
+<guimenuitem>Zoom in</guimenuitem>
+</menuchoice></term>
+<listitem><para>Zooms view in</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycap>-</keycap>
+</shortcut>
+<guimenu>View</guimenu>
+<guimenuitem>Zoom out</guimenuitem>
+</menuchoice></term>
+<listitem><para>Zooms view out</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo>
+</shortcut>
+<guimenu>View</guimenu>
+<guimenuitem>Default Zoom</guimenuitem>
+</menuchoice></term>
+<listitem><para>Restore the default Zoom setting</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo>
+</shortcut>
+<guimenu>View</guimenu>
+<guimenuitem>Zoom to Angular Size...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Zoom to specified field-of-view angle</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;&Shift;<keycap>F</keycap></keycombo>
+</shortcut>
+<guimenu>View</guimenu>
+<guimenuitem>Full Screen Mode</guimenuitem>
+</menuchoice></term>
+<listitem><para>Toggle full-screen mode</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycap>Space</keycap>
+</shortcut>
+<guimenu>View</guimenu>
+<guimenuitem>Horizontal/Equatorial Coordinates</guimenuitem>
+</menuchoice></term>
+<listitem><para>Toggle between the
+<link linkend="horizontal">Horizontal</link> and
+<link linkend="equatorial">Equatorial</link>
+<link linkend="ai-skycoords">Coordinate Systems</link></para></listitem>
+</varlistentry>
+</variablelist>
+</sect2>
+
+<sect2 id="devicemenu">
+<title><guimenu>Devices</guimenu> Menu</title>
+
+<variablelist>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Devices</guimenu>
+<guimenuitem>Telescope Wizard...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Opens the <guilabel>Telescope Wizard</guilabel>, which
+provides a step-by-step guide to help you connect to your telescope and
+control it with &kstars;.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Devices</guimenu>
+<guimenuitem>Device Manager</guimenuitem>
+</menuchoice></term>
+<listitem><para>Opens up the device manager, which allows you to start/shutdown device drivers and connect to remote INDI servers.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Devices</guimenu>
+<guimenuitem>INDI Control Panel</guimenuitem>
+</menuchoice></term>
+<listitem><para>Opens up INDI Control Panel, which allows you to control all the features supported by a device.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Devices</guimenu>
+<guimenuitem>Capture Image Sequence...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Acquire images from a CCD camera or webcam device</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Devices</guimenu>
+<guimenuitem>Configure INDI</guimenuitem>
+</menuchoice></term>
+<listitem><para>Opens up a dialog to configure INDI-related features such as automatic device updates.</para></listitem>
+</varlistentry>
+
+</variablelist>
+</sect2>
+
+<sect2 id="toolmenu">
+<title><guimenu>Tools</guimenu> Menu</title>
+
+<variablelist>
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo>
+</shortcut>
+<guimenu>Tools</guimenu>
+<guimenuitem>Calculator...</guimenuitem>
+</menuchoice></term>
+<listitem>
+<para>
+Opens the <link linkend="tool-calculator">AstroCalculator</link> Tool,
+which provides full access to many of the mathematical functions used by
+&kstars;.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry> 
+<term><menuchoice> 
+<shortcut> 
+<keycombo action="simul">&Ctrl;<keycap>L</keycap></keycombo> 
+</shortcut> 
+<guimenu>Tools</guimenu> 
+<guimenuitem>Observing List...</guimenuitem> 
+</menuchoice></term> 
+<listitem> 
+<para>Opens the <link linkend="tool-observinglist">Observing List</link>
+Tool, which provide convenient access to some common functions for a list of
+objects chosen by you.</para>
+</listitem> 
+</varlistentry> 
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo>
+</shortcut>
+<guimenu>Tools</guimenu>
+<guimenuitem>AAVSO Light Curves...</guimenuitem>
+</menuchoice></term>
+<listitem>
+<para>
+Opens the <link linkend="tool-aavso">AAVSO Light Curve Generator</link>
+Tool, which allows you to download a light curve for any variable
+star from the American Association of Variable Star Observers.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo>
+</shortcut>
+<guimenu>Tools</guimenu>
+<guimenuitem>Altitude vs. Time...</guimenuitem>
+</menuchoice></term>
+<listitem>
+<para>
+Opens the <link linkend="tool-altvstime">Altitude vs. Time</link> Tool, which
+can plot curves representing the altitude of any object as a
+function of time.  This is useful for planning observing
+sessions.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>U</keycap></keycombo>
+</shortcut>
+<guimenu>Tools</guimenu>
+<guimenuitem>What's Up Tonight...</guimenuitem>
+</menuchoice></term>
+<listitem>
+<para>
+Opens the <link linkend="tool-whatsup">What's Up Tonight</link> Tool,
+which presents a summary of the objects which are observable
+from your location on a given date.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>B</keycap></keycombo>
+</shortcut>
+<guimenu>Tools</guimenu>
+<guimenuitem>Script Builder...</guimenuitem>
+</menuchoice></term>
+<listitem>
+<para>
+Opens the <link linkend="tool-scriptbuilder">Script Builder</link> Tool,
+which provides a GUI interface for building &kstars; DCOP scripts.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>Y</keycap></keycombo>
+</shortcut>
+<guimenu>Tools</guimenu>
+<guimenuitem>Solar System...</guimenuitem>
+</menuchoice></term>
+<listitem>
+<para>
+Opens the <link linkend="tool-solarsys">Solar System Viewer</link>,
+which displays an overhead view of the solar system on the
+current simulation date.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>J</keycap></keycombo>
+</shortcut>
+<guimenu>Tools</guimenu>
+<guimenuitem>Jupiter's Moons...</guimenuitem>
+</menuchoice></term>
+<listitem>
+<para>
+Opens the <link linkend="tool-jmoons">Jupiter Moons Tool</link>,
+which displays the positions of Jupiter's four brightest
+moons as a function of time.
+</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+</sect2>
+
+<sect2 id="settingmenu">
+<title><guimenu>Settings</guimenu> Menu</title>
+
+<variablelist>
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guisubmenu>Info Boxes</guisubmenu>
+<guimenuitem>Hide/Show Info Boxes</guimenuitem>
+</menuchoice></term>
+<listitem><para>Toggle display of all three Info Boxes
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guisubmenu>Info Boxes</guisubmenu>
+<guimenuitem>Hide/Show Time</guimenuitem>
+</menuchoice></term>
+<listitem><para>Toggle display of the Time Info Box
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guisubmenu>Info Boxes</guisubmenu>
+<guimenuitem>Hide/Show Focus</guimenuitem>
+</menuchoice></term>
+<listitem><para>Toggle display of the Focus Info Box
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guisubmenu>Info Boxes</guisubmenu>
+<guimenuitem>Hide/Show Location</guimenuitem>
+</menuchoice></term>
+<listitem><para>Toggle display of the Location Info Box
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guisubmenu>Toolbars</guisubmenu>
+<guimenuitem>Hide/Show Main Toolbar</guimenuitem>
+</menuchoice></term>
+<listitem><para>Toggle display of the Main Toolbar
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guisubmenu>Toolbars</guisubmenu>
+<guimenuitem>Hide/Show View Toolbar</guimenuitem>
+</menuchoice></term>
+<listitem><para>Toggle display of the View Toolbar
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guisubmenu>Statusbar</guisubmenu>
+<guimenuitem>Hide/Show Statusbar</guimenuitem>
+</menuchoice></term>
+<listitem><para>Toggle display of the Statusbar
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guisubmenu>Statusbar</guisubmenu>
+<guimenuitem>Hide/Show Az/Alt field</guimenuitem>
+</menuchoice></term>
+<listitem><para>Toggle display of the mouse cursor's horizontal
+coordinates in the statusbar
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guisubmenu>Statusbar</guisubmenu>
+<guimenuitem>Hide/Show RA/Dec field</guimenuitem>
+</menuchoice></term>
+<listitem><para>Toggle display of the mouse cursor's horizontal
+coordinates in the statusbar
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guisubmenu>Color Schemes</guisubmenu>
+</menuchoice></term>
+<listitem><para>
+This submenu contains all of the defined color schemes, including your
+custom schemes.  Select any item to set that color scheme.
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guisubmenu>FOV Symbols</guisubmenu>
+</menuchoice></term>
+<listitem><para>
+This submenu lists the available field-of-view (FOV) Symbols.
+The FOV Symbol is drawn at the center of the display.  You
+may choose from the list of predefined symbols (No symbol,
+7x35 Binoculars, One degree, HST WFPC2 or 30m at 1.3cm), or you may define
+your own symbols (or modify existing symbols) using the
+<guimenuitem>Edit FOV symbols...</guimenuitem> item.
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>G</keycap></keycombo>
+</shortcut>
+<guimenu>Settings</guimenu>
+<guimenuitem>Geographic...</guimenuitem>
+</menuchoice></term>
+<listitem>
+<para>
+Select a new <link linkend="setgeo">geographic
+location</link>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Configure &kstars;...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Modify <link linkend="config">configuration
+options</link></para></listitem>
+</varlistentry>
+
+<varlistentry> 
+<term><menuchoice> 
+<guimenu>Settings</guimenu> 
+<guimenuitem>Startup Wizard...</guimenuitem> 
+</menuchoice></term> 
+<listitem><para>Opens the <link linkend="startwizard">Setup Wizard</link>, 
+which allows you to easily set your geographic location and download some 
+extra data files.</para></listitem> 
+</varlistentry> 
+
+
+</variablelist>
+</sect2>
+
+<sect2 id="helpmenu">
+<title><guimenu>Help</guimenu> Menu</title>
+
+&help.menu.documentation;
+
+</sect2>
+
+<sect2 id="popup-menu">
+<title>Popup Menu</title>
+<indexterm><primary>Popup Menu</primary><secondary>Description</secondary></indexterm>
+
+<para>
+The <mousebutton>right</mousebutton> click popup menu is
+context-sensitive, meaning its content varies depending on what kind of
+object you click on.  We list all possible popup menu items here, with
+the relevant object type [in brackets].</para>
+
+<variablelist>
+<varlistentry>
+<term>[All]</term>
+<listitem><para>
+Identification and type:  The top one to three lines are devoted to the
+name(s) of the object, and its type.  For stars, the Spectral Type
+is also shown here.
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>[All]</term>
+<listitem><para>
+Rise, Transit, and Set times for the object on the current simulation
+date are shown on the next three lines.
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>[All]</term>
+<listitem><para>
+<guimenuitem>Center and Track</guimenuitem>: Center the display
+on this location, and engage tracking.  Equivalent to double-clicking.
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>[All]</term>
+<listitem><para>
+<guimenuitem>Angular Distance To...</guimenuitem>: In this mode,
+a dotted line is drawn from the first target object
+to the current mouse position.  When you invoke the popup menu of a second
+object, this item will read <guilabel>Compute Angular Distance</guilabel>.
+Selecting this item will display the angular distance between the two
+objects in the statusbar.  You can press the <keycap>Esc</keycap> key to
+exit angular distance mode without measuring an angle.
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>[All]</term>
+<listitem><para>
+<guimenuitem>Details</guimenuitem>: Open the
+<link linkend="tool-details">Object Details window</link> for this object.
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>[All]</term>
+<listitem><para>
+<guimenuitem>Attach Label</guimenuitem>: Attach a permanent name label
+to the object.  If the object already has a label attached, this item
+will read <guilabel>Remove Label</guilabel>.
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>[All]</term>
+<listitem><para>
+<guimenuitem>Show ... Image</guimenuitem>: download an image of the
+object from the internet, and display it in the Image Viewer tool.
+The "..." text is replaced by a short description of the image's
+source.  An object may have multiple image links available in its
+popup menu.
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>[All]</term>
+<listitem><para>
+<guimenuitem>... Page</guimenuitem>: Display a webpage about the object
+in your default web browser.  The "..." text is replaced by a short
+description of the page.  An object may have multiple web links available
+in its popup menu.
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>[All Named Objects]</term>
+<listitem><para>
+<indexterm><primary>Objects in the Sky</primary>
+<secondary>Internet Links</secondary>
+<tertiary>Customizing</tertiary></indexterm>
+<guimenuitem>Add Link...</guimenuitem>: This allows you to add your own
+custom links to the popup menu of any object.  It opens a small window
+in which you enter the &URL; of the link, and the text you want to
+appear in the popup menu.  There is also a pair of radio buttons which
+allow you to specify whether the &URL; is an image or an
+<acronym>HTML</acronym> document, so &kstars; knows whether to launch
+the web browser or the image viewer.  You can use this to add links to
+files on your local disk, so this feature could be used to attach
+observing logs or other custom information to objects in &kstars;.
+Your custom links are automatically loaded whenever &kstars; starts up,
+and they are stored in the folder <filename
+class="directory">~/.kde/share/apps/kstars/</filename>, in files
+<filename>myimage_url.dat</filename> and
+<filename>myinfo_url.dat</filename>.  If you build an extensive list
+of custom links, consider submitting them to us, we would like to
+include them in the next version of &kstars;!
+</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+</sect1>
+
+<sect1 id="kstars-keys">
+<title>Keyboard Commands</title>
+<indexterm><primary>Commands</primary>
+<secondary>Keyboard</secondary></indexterm>
+
+<sect2 id="nav-keys">
+<title>Navigation Keys</title>
+<indexterm><primary>Navigation Controls</primary>
+<secondary>Keyboard</secondary></indexterm>
+
+<variablelist>
+<varlistentry><term>Arrow Keys</term>
+<listitem><para>
+Use the arrow keys to pan the display.  Holding down the &Shift;
+key doubles the scrolling speed.
+</para></listitem></varlistentry>
+
+<varlistentry>
+<term><keycap>+</keycap> / <keycap>-</keycap></term>
+<listitem><para>Zoom In/Out</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo></term>
+<listitem><para>Restore the default Zoom setting</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycombo action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo></term>
+<listitem><para>Zoom to specified field-of-view angle</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>0&ndash;9</term>
+<listitem><para>Center Display on a major Solar System body:
+<itemizedlist>
+<listitem><para>0: Sun</para></listitem>
+<listitem><para>1: Mercury</para></listitem>
+<listitem><para>2: Venus</para></listitem>
+<listitem><para>3: Moon</para></listitem>
+<listitem><para>4: Mars</para></listitem>
+<listitem><para>5: Jupiter</para></listitem>
+<listitem><para>6: Saturn</para></listitem>
+<listitem><para>7: Uranus</para></listitem>
+<listitem><para>8: Neptune</para></listitem>
+<listitem><para>9: Pluto</para></listitem>
+</itemizedlist>
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycap>Z</keycap></term>
+<listitem><para>Center the display at the <link linkend="ai-zenith">Zenith</link>
+Point (straight up)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycap>N</keycap></term>
+<listitem><para>Center the display above the North point on the  horizon</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycap>E</keycap></term>
+<listitem><para>Center the display above the East point on the  horizon</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycap>S</keycap></term>
+<listitem><para>Center the display above the South point on the horizon</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycap>W</keycap></term>
+<listitem><para>Center the display above the West point on the  horizon</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycombo action="simul">&Ctrl;<keycap>T</keycap></keycombo></term>
+<listitem><para>Toggle tracking mode</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycap>&lt;</keycap></term>
+<listitem><para>Advance the simulation clock backwards by one time step</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycap>&gt;</keycap></term>
+<listitem><para>Advance the simulation clock forwards by one time step</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+</sect2>
+
+<sect2 id="menu-keys">
+<title>Menu Shortcuts</title>
+<indexterm><primary>Commands</primary>
+<secondary>Menu</secondary>
+<tertiary>Keyboard Shortcuts</tertiary>
+</indexterm>
+
+<variablelist>
+<varlistentry>
+<term><keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo></term>
+<listitem><para>Open a new &kstars; window</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycombo action="simul">&Ctrl;<keycap>W</keycap></keycombo></term>
+<listitem><para>Close a &kstars; window</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycombo action="simul">&Ctrl;<keycap>D</keycap></keycombo></term>
+<listitem><para>Download extra data</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo></term>
+<listitem><para>Open a FITS image in the FITS Editor</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycombo action="simul">&Ctrl;<keycap>I</keycap></keycombo></term>
+<listitem><para>Export sky image to a file</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycombo action="simul">&Ctrl;<keycap>R</keycap></keycombo></term>
+<listitem><para>Run a &kstars; DCOP script</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo></term>
+<listitem><para>Print the current sky map</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo></term>
+<listitem><para>Quit &kstars;</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycombo action="simul">&Ctrl;<keycap>E</keycap></keycombo></term>
+<listitem><para>Sync the simulation clock with the current system time</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo></term>
+<listitem><para>Set the simulation clock to a specified Time and Date</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycombo action="simul">&Ctrl;&Shift;<keycap>F</keycap></keycombo></term>
+<listitem><para>Toggle full-screen mode</para></listitem>
+</varlistentry>
+
+<varlistentry><term><keycap>Space</keycap></term>
+<listitem><para>Toggle between the
+<link linkend="horizontal">Horizontal</link> and
+<link linkend="equatorial">Equatorial</link>
+<link linkend="ai-skycoords">Coordinate Systems</link>
+</para></listitem></varlistentry>
+
+<varlistentry>
+<term><keycap>F1</keycap></term>
+<listitem><para>Open the &kstars; Handbook</para></listitem>
+</varlistentry>
+</variablelist>
+</sect2>
+
+
+<sect2 id="object-actions">
+<title>Actions for the Selected Object</title>
+<indexterm><primary>Objects in the Sky</primary>
+<secondary>Keyboard Actions</secondary></indexterm>
+
+<para>Each of the following keystrokes performs an action on the 
+<firstterm>selected object</firstterm>.  The selected object is the last 
+object which was clicked on (identified in the status bar).  Alternatively, 
+if you hold down the <keycap>Shift</keycap> key, then the action is 
+performed on the centered object instead.</para>
+
+<!-- FIXME: this feature does not exist yet; to be added after feature thaw
+<variablelist>
+<varlistentry>
+<term><keycap>C</keycap></term>
+<listitem><para>Center and Track on the selected object</para></listitem>
+</varlistentry>
+-->
+<variablelist>
+<varlistentry>
+<term><keycap>D</keycap></term>
+<listitem><para>Open the Details window for the selected object</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycap>L</keycap></term>
+<listitem><para>Toggle a name label for the selected object</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycap>O</keycap></term>
+<listitem><para>Add the selected object to the observing list</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycap>P</keycap></term>
+<listitem><para>Open the selected object's popup menu</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycap>T</keycap></term>
+<listitem><para>Toggle a trail on the selected object (solar system bodies only)</para></listitem>
+</varlistentry>
+
+</variablelist>
+</sect2>
+
+<sect2 id="tools-keys">
+<title>Tools Shortcuts</title>
+
+<variablelist>
+<varlistentry>
+<term><keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo></term>
+<listitem><para>Open the <link linkend="findobjects">Find Object window</link>,
+for specifying a sky object on which to center</para></listitem>
+</varlistentry>
+
+<varlistentry><term><keycombo action="simul">&Ctrl;<keycap>M</keycap></keycombo>
+</term>
+<listitem><para>Open the <guilabel>Set Focus Manually...</guilabel> tool,
+for specifying RA/Dec or Az/Alt coordinates on which to center</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycap>[</keycap> / <keycap>]</keycap></term>
+<listitem><para>Start/End an Angular Distance measurement at the current mouse 
+cursor position.  The angular distance between start and end points is displayed 
+in the statusbar.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycombo action="simul">&Ctrl;<keycap>G</keycap></keycombo></term>
+<listitem><para>Open the <link linkend="setgeo">Set Geographic Location</link> 
+window</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo></term>
+<listitem><para>Open the <link linkend="tool-calculator">AstroCalculator</link> 
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo></term>
+<listitem><para>Open the <link linkend="tool-aavso">AAVSO Lightcurve Generator</link>
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo></term>
+<listitem><para>Open the <link linkend="tool-altvstime">Altitude vs. Time</link> 
+tool</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycombo action="simul">&Ctrl;<keycap>U</keycap></keycombo></term>
+<listitem><para>Open the <link linkend="tool-whatsup">What's Up Tonight?</link> 
+tool</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycombo action="simul">&Ctrl;<keycap>B</keycap></keycombo></term>
+<listitem><para>Open the <link linkend="tool-scriptbuilder">Script Builder</link> 
+tool</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycombo action="simul">&Ctrl;<keycap>Y</keycap></keycombo></term>
+<listitem><para>Open the <link linkend="tool-solarsys">Solar System Viewer</link> 
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycombo action="simul">&Ctrl;<keycap>J</keycap></keycombo></term>
+<listitem><para>Open the <link linkend="tool-jmoons">Jupiter Moons</link> 
+tool</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycombo action="simul">&Ctrl;<keycap>L</keycap></keycombo></term>
+<listitem><para>Open the <link linkend="tool-observinglist">Observing List</link> 
+tool</para></listitem>
+</varlistentry>
+
+</variablelist>
+</sect2>
+</sect1>
+
+<sect1 id="kstars-mouse">
+<title>Mouse Commands</title>
+<indexterm><primary>Commands</primary>
+<secondary>Mouse</secondary></indexterm>
+<indexterm><primary>Navigation Controls</primary>
+<secondary>Mouse</secondary></indexterm>
+
+<variablelist>
+<varlistentry><term>Moving the mouse</term>
+<listitem><para>
+The sky coordinates (RA/Dec and Az/Alt) of the mouse cursor are updated
+in the status bar
+</para></listitem>
+</varlistentry>
+
+<varlistentry><term>"Hovering" the mouse</term>
+<listitem><para>
+A temporary name label is attached to the object nearest to the mouse cursor.
+</para></listitem>
+</varlistentry>
+
+<varlistentry><term>Left-clicking</term>
+<listitem>
+<para>
+<indexterm><primary>Objects in the Sky</primary>
+<secondary>Identifying</secondary></indexterm>
+The object nearest the mouse click is identified in the
+status bar.
+</para></listitem>
+</varlistentry>
+
+<varlistentry><term>Double-clicking</term>
+<listitem>
+<para>
+<indexterm><primary>Objects in the Sky</primary>
+<secondary>Centering</secondary></indexterm>
+Center and track on the location or object
+nearest the mouse click.  Double-clicking on an Info Box will
+<quote>shade</quote> it to show/hide extra information.
+</para></listitem>
+</varlistentry>
+
+<varlistentry><term>Right-clicking</term>
+<listitem>
+<para>
+<indexterm><primary>Objects in the Sky</primary>
+<secondary>Invoking Popup Menu for</secondary></indexterm>
+Open the <link linkend="popup-menu">popup menu</link> for the
+location or object nearest the mouse cursor.
+</para></listitem>
+</varlistentry>
+
+<varlistentry><term>Scrolling the mouse wheel</term>
+<listitem><para>Zoom the display in or out.  If you do not
+have a mouse wheel, you can hold the middle mouse button and
+drag vertically.
+</para></listitem>
+</varlistentry>
+
+<varlistentry><term>Click-and-dragging</term>
+<listitem><para>
+	<variablelist>
+	<varlistentry><term>Dragging the sky map</term>
+	<listitem><para>Pan the display, following the drag motion.
+	</para></listitem></varlistentry>
+
+	<varlistentry><term>&Ctrl;+dragging the sky map</term>
+	<listitem><para>Define a rectangle in the map.  When the
+	mouse button is released, the display is zoomed in to match the
+	field-of-view to the bounds of the rectangle.
+	</para></listitem></varlistentry>
+
+	<varlistentry><term>Dragging an Info Box</term>
+	<listitem><para>The Info Box is repositioned in the map.  Info
+	Boxes will <quote>stick</quote> to window edges, so that they
+	remain on the edge when the window is resized.
+	</para></listitem></varlistentry>
+	</variablelist>
+</para></listitem>
+</varlistentry>
+</variablelist>
+
+</sect1>
+</chapter>