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, 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>
+