summaryrefslogtreecommitdiffstats
path: root/doc/kstars/wut.docbook
diff options
context:
space:
mode:
authortoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
committertoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
commitce599e4f9f94b4eb00c1b5edb85bce5431ab3df2 (patch)
treed3bb9f5d25a2dc09ca81adecf39621d871534297 /doc/kstars/wut.docbook
downloadtdeedu-ce599e4f9f94b4eb00c1b5edb85bce5431ab3df2.tar.gz
tdeedu-ce599e4f9f94b4eb00c1b5edb85bce5431ab3df2.zip
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
Diffstat (limited to 'doc/kstars/wut.docbook')
-rw-r--r--doc/kstars/wut.docbook58
1 files changed, 58 insertions, 0 deletions
diff --git a/doc/kstars/wut.docbook b/doc/kstars/wut.docbook
new file mode 100644
index 00000000..90c03c60
--- /dev/null
+++ b/doc/kstars/wut.docbook
@@ -0,0 +1,58 @@
+<sect1 id="tool-whatsup">
+<title>What's Up Tonight? Tool</title>
+<indexterm><primary>Tools</primary>
+<secondary>What's Up Tonight? Tool</secondary>
+</indexterm>
+
+<screenshot>
+<screeninfo>
+The What's Up Tonight Tool
+</screeninfo>
+<mediaobject>
+ <imageobject>
+ <imagedata fileref="wut.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>What's Up Tonight?</phrase>
+ </textobject>
+</mediaobject>
+</screenshot>
+
+<para>
+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.
+</para>
+<para>
+The WUT tool also displays a short almanac of data for the selected
+date: the rise and set times for the Sun and moon, the duration of
+the night, and the Moon's illumination fraction.
+</para>
+<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>Choose 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
+<guilabel>Planets</guilabel> category has been selected, and four
+planets which are up on the selected night are displayed (Mars,
+Neptune, Pluto, and Uranus). When an object in the list is selected,
+its rise, set and transit times are displayed in the lower-right
+panel. 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
+between sunset and midnight (i.e., <quote>in the evening</quote>).
+You can choose to show objects which are up between midnight and dawn
+(<quote>in the morning</quote>), or between dusk and dawn (<quote>any
+time tonight</quote>) using the combobox near the top of the window.
+</para>
+</sect1>
+