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/kdetoys@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

3 files changed, 209 insertions, 0 deletions

diff --git a/doc/kmoon/Makefile.am b/doc/kmoon/Makefile.am
new file mode 100644
index 0000000..085981d
--- /dev/null
+++ b/doc/kmoon/Makefile.am
@@ -0,0 +1,4 @@
+
+KDE_LANG = en
+KDE_DOCS = AUTO
+
diff --git a/doc/kmoon/carlosmail b/doc/kmoon/carlosmail
new file mode 100644
index 0000000..760845b
--- /dev/null
+++ b/doc/kmoon/carlosmail
@@ -0,0 +1,74 @@
+From [email protected]  Fri Oct 20 23:12:11 2000
+Return-Path: <[email protected]>
+Delivered-To: [email protected]
+Received: (qmail 22568 invoked by uid 1055); 20 Oct 2000 21:12:11 -0000
+Delivered-To: [email protected]
+Received: (qmail 22489 invoked from network); 20 Oct 2000 21:12:07 -0000
+Received: from nova.ov.ufrj.br ([email protected])
+  by max.tat.physik.uni-tuebingen.de with SMTP; 20 Oct 2000 21:12:07 -0000
+Received: from localhost (localhost [[UNIX: localhost]])
+        by nova.ov.ufrj.br (8.9.3/8.9.3) id TAA09140
+        for [email protected]; Fri, 20 Oct 2000 19:14:00 -0200
+From: Carlos Roberto Raba<E7>a <[email protected]>
+Reply-To: [email protected]
+Organization: Observatorio do Valongo - UFRJ
+To: Stephan Kulow <[email protected]>
+Subject: Re: Moon tool
+Date: Fri, 20 Oct 2000 17:10:39 -0200
+X-Mailer: KMail [version 1.0.29]
+Content-Type: text/plain
+References: <[email protected]> <[email protected]>
+In-Reply-To: <[email protected]>
+MIME-Version: 1.0
+Message-Id: <[email protected]>
+Content-Transfer-Encoding: 8bit
+Status: O
+X-Status:
+
+Stephan,
+ 
+> In KDE2 I implemented free choice view angle, so I could also slide
+> it some degrees off to see it like I see it here :)
+ 
+It is nice to hear that! Unfortunately, I still use KDE 1.1.2.... By the way,
+when is the final release o 2.0?
+ 
+> But if you're an expert, I would like your advise on the correct
+> terms. Where on the earth you see the moon in the the default view
+> you can see on web pages etc.?
+ 
+As you know, the moon keeps always the same face turned to earth (the so called
+near side). This is a composition of its period of orbital motion and rotation:
+they are approximately the same. The moon's orbit is inclined with respect to
+the equator by (only) 5 degrees, and for our purposes, keeps the polar
+orientation in the sky unchanged. This means that the angle that you
+see the moon in the sky changes by a composition of two factors only: 1)
+latitude of the observer, and 2) time of the day that you look at the moon. If
+you look at the moon over many hours, the change of orientation in the sky is
+moon's orbital plane is close to the equator (as I said before) the discussion
+of orientation looses any meaning. At these positions, the passage by the
+meridian happens very close to the top of your head. So, I can be facing east
+and move my head up to see the moon, or I can be facing west and move my head
+up. Which rotation should I addopt? That is why I told you to use 0 or 180
+degrees. Otherwise, you would need to incorporate in your code many otherif he
+relations, including the latitude of the observer.he will see the first quarter
+moon as a C and the last quater moon as a D (see
+> The current kmoon uses the pictures of this site:l) when the moon is over
+> http://timbeauchamp.tripod.com/moon/, but a (german) colleague ofes over his
+> yours pointed out that the images are mirrored horizontally, son is reversed.
+> we corrected that (the larger craters appear on the left ontor. Since the
+> the moon I see in the sky, while they are right on the web).
+ 
+My colleague is correct. The east-west sides in the pictures are wrong, so you
+should flip them sideways. For an observer in the northern hemisthere this is
+all you need to do. For an observer in the southern hemisphere, you need to
+rotate this new set of images by 180 degrees. Keep in mind that in the sky if
+north is up east is to the left, if south is up east is to the right. You can
+easily see this if you lay down ;-/ on the floor with you head/legs pointing to
+the north/south line. Now, try to point your left arm to the geographic
+east while facing up.
+ 
+I hope this helps you. If you like more info, it will be a pleasure to
+help. Best wishes,
+ 
+Carlos
diff --git a/doc/kmoon/index.docbook b/doc/kmoon/index.docbook
new file mode 100644
index 0000000..5debf5c
--- /dev/null
+++ b/doc/kmoon/index.docbook
@@ -0,0 +1,131 @@
+<?xml version="1.0" ?>
+<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
+  <!ENTITY kappname "&kmoon;">
+  <!ENTITY package "kdetoys">
+  <!ENTITY % English "INCLUDE">
+  <!ENTITY % addindex "IGNORE">
+]>
+
+<book lang="&language;">
+
+<bookinfo>
+<title>The &kmoon; Handbook</title>
+
+<authorgroup>
+<author>
+<personname>
+<firstname>Pam</firstname>
+<othername></othername>
+<surname>Roberts</surname>
+</personname>
+<email>[email protected]</email>
+</author>
+</authorgroup>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+
+<copyright>
+<year>2003</year>
+<holder>Pam Roberts</holder>
+</copyright>
+<!-- Translators: put here the copyright notice of the translation -->
+<legalnotice>&FDLNotice;</legalnotice>
+
+<date>2003-09-16</date>
+<releaseinfo>1.0</releaseinfo>
+
+<abstract>
+<para>
+&kmoon; is an applet that shows the current phase of the moon.
+</para>
+</abstract>
+
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>kdetoys</keyword>
+<keyword>kmoon</keyword>
+<keyword>moon phase</keyword>
+</keywordset>
+
+</bookinfo>
+
+<chapter id="using">
+<title>Using &kmoon;</title>
+<para>&kmoon; is a little applet that docks into the System Tray and shows an 
+image of the current phase of the moon. Hovering the mouse cursor over the  
+image brings up a tooltip to display more information.</para>
+
+<para>&kmoon; can be added to the panel by &RMB; clicking on an empty space
+on the panel and choosing <menuchoice><guimenu>Add to
+Panel</guimenu><guisubmenu>Applet</guisubmenu><guimenuitem>Moon Phase
+Display</guimenuitem></menuchoice>.  If you can't find an empty space, you
+can access the panel menu from an &RMB; click on any existing applet or
+icon.</para>
+
+<para>To close &kmoon; <mousebutton>right</mousebutton> click on the applet
+handle beside the image and choose <guimenuitem>Quit</guimenuitem>.</para>
+
+<sect1 id="settings">
+<title>Settings</title>
+<para>If you <mousebutton>right</mousebutton> click on the image and choose 
+<guimenuitem>Settings...</guimenuitem> a small dialog box will appear that 
+lets you adjust the image to suit the latitude and hemisphere you are living 
+in.</para>
+</sect1>
+
+</chapter>
+
+<chapter id="credits">
+
+<title>Credits and License</title>
+
+<para>
+&kmoon;
+</para>
+<para>
+Program copyright 1998,2000 &Stephan.Kulow; &Stephan.Kulow.mail;
+</para>
+<para>
+Contributors:
+<itemizedlist>
+<listitem><para>Lunar code by Chris Osburn <email>[email protected]</email></para>
+</listitem>
+<listitem><para>Moon graphics by Tom Beauchamp <email>[email protected]</email></para>
+</listitem>
+</itemizedlist>
+</para>
+
+<para>
+Documentation copyright 2003 Pam Roberts <email>[email protected]</email>
+</para>
+
+<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
+
+&underFDL;              
+&underGPL;        	
+
+</chapter>
+<appendix id="installation">
+<title>Installation</title>
+
+<para>&kmoon; is part of &kde;'s &package; package.</para>
+<para>Most &Linux; / &UNIX; distributions that include &kde; will include &package; as an option to be installed if the user wishes.</para>
+<para>&kmoon; and the &package; package may also be compiled from source code. 
+Visit <ulink url="http://www.kde.org"> http://www.kde.org</ulink> for instructions on how to download, compile and install &kde; programs.</para>
+
+</appendix>
+
+&documentation.index; 
+</book>
+
+<!--
+Local Variables:
+mode: xml
+sgml-minimize-attributes:nil
+sgml-general-insert-case:lower
+sgml-indent-step:0
+sgml-indent-data:nil
+End:
+
+vim:tabstop=2:shiftwidth=2:expandtab 
+-->
+