<chapter id="commands">
<title>Command Reference</title>

<sect1 id="kstars-menus">
  <title>Menu Commands</title> <!-- updated for 4.9, some items ar missing-->
<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>D</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu>
<guimenuitem>Download New Data...</guimenuitem>
</menuchoice></term>
<listitem><para>Open the <guilabel>Get Hot New Stuff</guilabel> 
dialog to download additional data for &kstars;.
</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 Viewer 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>
<!-- not in 4.7
<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>
<guimenu>File</guimenu>
<guimenuitem>Printing Wizard</guimenuitem>
</menuchoice></term>
<listitem><para>Starts a wizard to configure capturing sky objects images using telescope and printing the results as a good looking printout for further use or catalogization.
</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>
<!--FIXME missing Advance one step backward in time &lt;-->
<varlistentry>
<term><menuchoice>
<guimenu>Time</guimenu>
<guimenuitem>Stop Clock</guimenuitem>
</menuchoice></term>
<listitem><para>Toggle whether time passes</para></listitem>
</varlistentry>
<!--FIXME missing Advance one step forward in time &gt;-->
</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 Coordinates 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>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><keycombo action="simul">&Ctrl;<keycap>+</keycap></keycombo></shortcut>
<guimenu>View</guimenu>
<guimenuitem>Zoom in</guimenuitem>
</menuchoice></term>
<listitem><para>Zooms view in</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul">&Ctrl;<keycap>-</keycap></keycombo></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>Switch to star globe view / Switch to horizontal view</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>

<!--FIXME Projection with 6 subitems are missing -->

</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>
<!-- in 4.7 this is a page in the settings dialog
<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>

<!--FIXME missing
Sky Calendar...
Observing List... Ctrl+L

-->
<!-- removed after 4.9 see http://commits.kde.org/kstars/c8dd5af7bff7f738ce2b6ab68bdb46e9125bde7d
<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>

 <!--FIXME missing Ekos...-->
<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; &DBus; 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>
<!--FIXME missing
Flags
  -->
</variablelist>
</sect2>

<sect2 id="datamenu">
<title>Data Menu</title>

<variablelist>
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>D</keycap></keycombo>
</shortcut>
<guimenu>Data</guimenu>
<guimenuitem>Download New Data...</guimenuitem>
</menuchoice></term>
<listitem><para>Open the <guilabel>Get Hot New Stuff</guilabel> 
dialog to download additional data for &kstars;.
</para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Data</guimenu>
<guisubmenu>Updates</guisubmenu>
</menuchoice></term>
<listitem><para>This submenu can be used to update various object data, namely asteroid and comet orbit elements as well as recent supernovae data from internet. The data will be downloaded for the current user account only. If you use &kstars; from different account you should download them for every account separately.
</para>
<para>&kstars; tries to download recent supernovae list automatically by default. You can switch the download off using <guilabel>Supernovae</guilabel> page of &kstars; Settings window.</para>
</listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="observationmenu">
<title>Observation Menu</title>

<variablelist>
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>L</keycap></keycombo>
</shortcut>
<guimenu>Observation</guimenu>
<guimenuitem>Observation Planner</guimenuitem>
</menuchoice></term>
<listitem><para>Open the <link linkend="tool-obsplanner">Observation Planner</link> 
tool</para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>2</keycap></keycombo>
</shortcut>
<guimenu>Observation</guimenu>
<guimenuitem>Execute the session Plan</guimenuitem>
</menuchoice></term>
<listitem><para>Opens <link linkend="tool-obsplanner">session plan wizard</link> or execute the planned session.</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>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>Show Time Box</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>Show Focus Box</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>Show Location Box</guimenuitem>
</menuchoice></term>
<listitem><para>Toggle display of the Location Info Box
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guisubmenu>Toolbars Shown</guisubmenu>
</menuchoice></term>
<listitem><para>Toggle display of the Main and View Toolbar
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guisubmenu>Statusbar</guisubmenu>
<guimenuitem>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>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>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, or HST WFPC2), or you may define
your own symbols (or modify existing symbols) using the
<guimenuitem>Edit FOV Symbols...</guimenuitem> item.
</para></listitem>
</varlistentry>
<!-- missing
Switch to OpenGL backend
Define Equipment Ctrl+0
Add Observer Ctrl+1
  -->
<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>

<!-- Startup Wizard missing-->
 
</variablelist>

<para>
Additionally &kstars; has the common &kde; <guimenu>Settings</guimenu> and <guimenu>Help</guimenu>
menu items, for more information read the sections about the
<ulink url="help:/fundamentals/ui.html#menus-settings">Settings Menu</ulink> and
<ulink url="help:/fundamentals/ui.html#menus-help">Help Menu</ulink>
of the &kde; Fundamentals.
</para>

</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 &amp; 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>: Enter "angular distance
mode".  In this mode, a dotted line is drawn from the first target object
to the current mouse position.  When you click with the &RMB; on a second
object, this  will display the angular distance between the two
objects near the second object.  You can press the &Esc; key to
exit angular distance mode without measuring an angle.
</para></listitem>
</varlistentry>

<!-- Starhop from here missing-->

<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>
<!-- missing
Add to Observing Wishlist
Add Trail
Print XPlanet view
  -->
<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>

</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>
<!-- not in 4.7
<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>L</keycap></keycombo></term>
<listitem><para>Run a &kstars; <link linkend="tool-obsplanner">Observation Planner</link></para></listitem>
</varlistentry>

<varlistentry>
<term><keycombo action="simul">&Ctrl;<keycap>R</keycap></keycombo></term>
<listitem><para>Run a &kstars; &DBus; 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 &Shift; key, then the action is 
performed on the centered object instead.</para>

<variablelist>
<varlistentry>
<term><keycap>C</keycap></term>
<listitem><para>Center and Track on the selected object</para></listitem>
</varlistentry>

<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 Coordinates Manually</guilabel> tool,
for specifying RA/Dec or Az/Alt coordinates on which to center</para></listitem>
</varlistentry>

<varlistentry>
<term><keycap>[</keycap></term>
<listitem><para>Start an Angular Distance measurement at the current mouse 
cursor position.  The angular distance between start and end points is displayed 
at the endpoint.</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>

</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>
