initial

16 files changed, 838 insertions, 0 deletions

diff --git a/mateweather/docs/C/figures/mateweather-details.png b/mateweather/docs/C/figures/mateweather-details.png
new file mode 100644
index 00000000..680e6bae
--- /dev/null
+++ b/mateweather/docs/C/figures/mateweather-details.png
diff --git a/mateweather/docs/C/figures/mateweather-menu-prefs.png b/mateweather/docs/C/figures/mateweather-menu-prefs.png
new file mode 100644
index 00000000..5e69f370
--- /dev/null
+++ b/mateweather/docs/C/figures/mateweather-menu-prefs.png
diff --git a/mateweather/docs/C/figures/mateweather-prefs-general.png b/mateweather/docs/C/figures/mateweather-prefs-general.png
new file mode 100644
index 00000000..5bdaff76
--- /dev/null
+++ b/mateweather/docs/C/figures/mateweather-prefs-general.png
diff --git a/mateweather/docs/C/figures/mateweather-prefs-locations.png b/mateweather/docs/C/figures/mateweather-prefs-locations.png
new file mode 100644
index 00000000..8a3d6fc5
--- /dev/null
+++ b/mateweather/docs/C/figures/mateweather-prefs-locations.png
diff --git a/mateweather/docs/C/figures/mateweather_applet.png b/mateweather/docs/C/figures/mateweather_applet.png
new file mode 100644
index 00000000..ad6373d7
--- /dev/null
+++ b/mateweather/docs/C/figures/mateweather_applet.png
diff --git a/mateweather/docs/C/figures/stock_weather-cloudy.png b/mateweather/docs/C/figures/stock_weather-cloudy.png
new file mode 100644
index 00000000..e54839bc
--- /dev/null
+++ b/mateweather/docs/C/figures/stock_weather-cloudy.png
diff --git a/mateweather/docs/C/figures/stock_weather-few-clouds.png b/mateweather/docs/C/figures/stock_weather-few-clouds.png
new file mode 100644
index 00000000..b355d5d3
--- /dev/null
+++ b/mateweather/docs/C/figures/stock_weather-few-clouds.png
diff --git a/mateweather/docs/C/figures/stock_weather-fog.png b/mateweather/docs/C/figures/stock_weather-fog.png
new file mode 100644
index 00000000..9e5e57e7
--- /dev/null
+++ b/mateweather/docs/C/figures/stock_weather-fog.png
diff --git a/mateweather/docs/C/figures/stock_weather-night-clear.png b/mateweather/docs/C/figures/stock_weather-night-clear.png
new file mode 100644
index 00000000..5a0e5f67
--- /dev/null
+++ b/mateweather/docs/C/figures/stock_weather-night-clear.png
diff --git a/mateweather/docs/C/figures/stock_weather-night-few-clouds.png b/mateweather/docs/C/figures/stock_weather-night-few-clouds.png
new file mode 100644
index 00000000..f8a18c0c
--- /dev/null
+++ b/mateweather/docs/C/figures/stock_weather-night-few-clouds.png
diff --git a/mateweather/docs/C/figures/stock_weather-showers.png b/mateweather/docs/C/figures/stock_weather-showers.png
new file mode 100644
index 00000000..3ce291f7
--- /dev/null
+++ b/mateweather/docs/C/figures/stock_weather-showers.png
diff --git a/mateweather/docs/C/figures/stock_weather-snow.png b/mateweather/docs/C/figures/stock_weather-snow.png
new file mode 100644
index 00000000..8a452486
--- /dev/null
+++ b/mateweather/docs/C/figures/stock_weather-snow.png
diff --git a/mateweather/docs/C/figures/stock_weather-storm.png b/mateweather/docs/C/figures/stock_weather-storm.png
new file mode 100644
index 00000000..dbbec6d7
--- /dev/null
+++ b/mateweather/docs/C/figures/stock_weather-storm.png
diff --git a/mateweather/docs/C/figures/stock_weather-sunny.png b/mateweather/docs/C/figures/stock_weather-sunny.png
new file mode 100644
index 00000000..35ac3494
--- /dev/null
+++ b/mateweather/docs/C/figures/stock_weather-sunny.png
diff --git a/mateweather/docs/C/legal.xml b/mateweather/docs/C/legal.xml
new file mode 100644
index 00000000..29f07269
--- /dev/null
+++ b/mateweather/docs/C/legal.xml
@@ -0,0 +1,76 @@
+   <legalnotice id="legalnotice">
+         <para>
+           Permission is granted to copy, distribute and/or modify this
+           document under the terms of the GNU Free Documentation
+           License (GFDL), Version 1.1 or any later version published
+           by the Free Software Foundation with no Invariant Sections,
+           no Front-Cover Texts, and no Back-Cover Texts.  You can find
+           a copy of the GFDL at this <ulink type="help"
+           url="ghelp:fdl">link</ulink> or in the file COPYING-DOCS
+           distributed with this manual.
+          </para>
+          <para> This manual is part of a collection of MATE manuals
+           distributed under the GFDL.  If you want to distribute this
+           manual separately from the collection, you can do so by
+           adding a copy of the license to the manual, as described in
+           section 6 of the license.
+         </para>
+ 
+         <para>
+           Many of the names used by companies to distinguish their
+           products and services are claimed as trademarks. Where those
+           names appear in any MATE documentation, and the members of
+           the MATE Documentation Project are made aware of those
+           trademarks, then the names are in capital letters or initial
+           capital letters.
+         </para>
+ 
+         <para>
+           DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED
+           UNDER  THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE
+           WITH THE FURTHER UNDERSTANDING THAT:
+ 
+           <orderedlist>
+                 <listitem>
+                   <para>DOCUMENT IS PROVIDED ON AN "AS IS" BASIS,
+                     WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR
+                     IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES
+                     THAT THE DOCUMENT OR MODIFIED VERSION OF THE
+                     DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR
+                     A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE
+                     RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE
+                     OF THE DOCUMENT OR MODIFIED VERSION OF THE
+                     DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR
+                     MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT,
+                     YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY
+                     CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY
+                     SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER
+                     OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS
+                     LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED
+                     VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER
+                     EXCEPT UNDER THIS DISCLAIMER; AND
+                   </para>
+                 </listitem>
+                 <listitem>
+                   <para>UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL
+                        THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE),
+                        CONTRACT, OR OTHERWISE, SHALL THE AUTHOR,
+                        INITIAL WRITER, ANY CONTRIBUTOR, OR ANY
+                        DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION
+                        OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH
+                        PARTIES, BE LIABLE TO ANY PERSON FOR ANY
+                        DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR
+                        CONSEQUENTIAL DAMAGES OF ANY CHARACTER
+                        INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS
+                        OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR
+                        MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR
+                        LOSSES ARISING OUT OF OR RELATING TO USE OF THE
+                        DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT,
+                        EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF
+                        THE POSSIBILITY OF SUCH DAMAGES.
+                   </para>
+                 </listitem>
+           </orderedlist>
+         </para>
+   </legalnotice>
+ 
\ No newline at end of file
diff --git a/mateweather/docs/C/mateweather.xml b/mateweather/docs/C/mateweather.xml
new file mode 100644
index 00000000..a951a482
--- /dev/null
+++ b/mateweather/docs/C/mateweather.xml
@@ -0,0 +1,762 @@
+<?xml version="1.0"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
+"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
+  <!ENTITY legal SYSTEM "legal.xml">
+  <!ENTITY appletversion "2.12">
+  <!ENTITY applet "Weather Report">
+]>
+<!-- 
+      (Do not remove this comment block.)
+  Maintained by the MATE Documentation Project
+  http://developer.mate.org/projects/gdp
+  Template version: 2.0 beta
+  Template last modified Feb 12, 2002
+-->
+<!-- =============Document Header ============================= -->
+<article id="index" lang="en">
+   <!-- please do not change the id; for translations, change lang to -->
+   <!-- appropriate code -->
+     
+   <articleinfo>
+      <title>&applet; Manual</title>
+      <abstract role="description">
+	<para>The &applet; Applet downloads weather information for a
+given location from the internet and displays the temperature and a
+symbol representing the current weather conditions in the panel. When
+clicked on, more information is given, such as the forecast, the time of
+sunrise and sunset, wind direction, pressure, and more. All units are
+customizable.</para>
+      </abstract>
+      <copyright>
+        <year>2005</year>
+	<holder>Davyd Madeley</holder>
+      </copyright>
+      <copyright>
+	<year>2004</year>
+	<holder>Angela Boyle</holder>
+      </copyright>
+      <copyright>
+		<year>2002</year>
+		<year>2003</year>
+		<year>2004</year>
+		<holder>Sun Microsystems</holder>    	 
+      </copyright>
+      <copyright>
+		<year>1999</year>  		
+		<year>2000</year>
+		<holder>Spiros Papadimitriou</holder>  	 
+      </copyright>
+      <copyright>
+		<year>1999</year>  		
+		<year>2000</year>
+		<holder>Dan Mueth</holder>  	 
+      </copyright>
+      <!-- translators: uncomment this:
+      
+        <copyright>
+         <year>2002</year>
+         <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
+        </copyright>
+      
+         -->
+      <!-- An address can be added to the publisher information.  If a role is 
+           not specified, the publisher/author is the same for all versions of the 
+           document.  -->
+      	 
+      <publisher role="maintainer">
+		<publishername> MATE Documentation Project </publishername>  	 
+      </publisher>
+        &legal;
+      <!-- This file  contains link to license for the documentation (GNU FDL), and 
+           other legal stuff such as "NO WARRANTY" statement. Please do not change 
+           any of this. -->
+      	 
+      <authorgroup>
+        <author>
+	  <firstname>Davyd</firstname><surname>Madeley</surname>
+	  <affiliation>
+	   <orgname>MATE Project</orgname>
+	   <address><email>[email protected]</email></address>
+	  </affiliation>
+	</author>
+	<author>
+	  <firstname>Angela</firstname>
+	  <surname>Boyle</surname>
+	</author>
+           		
+	<author>
+	<firstname>Sun </firstname>  		  
+	<surname>MATE Documentation Team</surname>            		  
+
+            <affiliation>
+		<orgname>Sun Microsystems</orgname>  			 
+            </affiliation>
+              		
+        </author>
+           		
+        <author>
+	<firstname>Spiros</firstname>  		  
+	<surname>Papadimitriou</surname>
+             		  
+            <affiliation>
+		<orgname>MATE Documentation Project</orgname>  			 
+		<address><email>[email protected]</email> </address>  		  
+            </affiliation>
+              		
+         </author>
+           		
+         <author>
+	 <firstname>Dan</firstname>
+	 <surname>Mueth</surname>  	
+	  
+	     <affiliation>
+ 		<orgname>MATE Documentation Project</orgname>  			 
+		<address><email>[email protected]</email> </address>  		  
+             </affiliation>
+              		
+         </author>
+               
+         <!-- This is appropriate place for other contributors: translators,
+                    maintainers,  etc. Commented out by default.
+                    <othercredit role="translator">
+         	     <firstname>Latin</firstname> 
+         	     <surname>Translator 1</surname> 
+         	     <affiliation> 
+         	       <orgname>Latin Translation Team</orgname> 
+         	       <address> <email>[email protected]</email> </address> 
+         	     </affiliation>
+         	     <contrib>Latin translation</contrib>
+                    </othercredit>
+         -->
+         	 
+      </authorgroup>
+	  
+	  <releaseinfo revision="2.26" role="review"/>
+      	 
+      <revhistory>
+        <revision>
+	  <revnumber>Version 2.12</revnumber>
+	  <date>March 2005</date>
+	  <revdescription>
+	    <para role="author">Davyd Madeley</para>
+	  </revdescription>
+	</revision>
+        <revision>
+	  <revnumber>Version 2.10</revnumber>
+	  <date>March 2005</date>
+	  <revdescription>
+	    <para role="author">Davyd Madeley</para>
+	  </revdescription>
+	</revision>
+	<revision>
+	  <revnumber>Version 2.8</revnumber>
+	  <date>September 2004</date>
+	  <revdescription>
+	    <para role="author">Angela Boyle</para>
+	    <para role="publisher">MATE Documentation Project</para>
+	  </revdescription>
+	</revision>
+        <revision>
+          <revnumber>&applet; Applet Manual V2.4</revnumber>  		
+          <date>February 2004</date>  		  
+          <revdescription>
+	    <para role="author">Sun MATE Documentation Team</para>
+	    <para role="publisher">MATE Documentation Project</para>
+          </revdescription>
+        </revision>
+        <revision>
+          <revnumber>Weather Report Applet Manual V2.3</revnumber>  		
+          <date>January 2003</date>  		  
+          <revdescription>
+	    <para role="author">Sun MATE Documentation Team</para>
+	    <para role="publisher">MATE Documentation Project</para>
+          </revdescription>
+        </revision>  
+        <revision>
+          <revnumber>Weather Report Applet Manual V2.2</revnumber>  		
+          <date>August 2002</date>  		  
+          <revdescription>
+	    <para role="author">Sun MATE Documentation Team</para>
+	    <para role="publisher">MATE Documentation Project</para>
+          </revdescription>
+        </revision>  
+        <revision>
+          <revnumber>Weather Report Applet Manual V2.1</revnumber>  		
+          <date>July 2002</date>  		  
+          <revdescription>
+	    <para role="author">Sun MATE Documentation Team</para>
+	    <para role="publisher">MATE Documentation Project</para>
+          </revdescription>
+        </revision>
+        <revision>
+          <revnumber>Weather Report Applet Manual V2.0</revnumber>  		
+          <date>March 2002</date>  		  
+          <revdescription>
+	    <para role="author">Sun MATE Documentation Team</para>
+	    <para role="publisher">MATE Documentation Project</para>
+          </revdescription>
+        </revision>
+        <revision>
+	  <revnumber>MATE Weather Applet</revnumber>  		  
+	  <date>2000</date>
+          <revdescription>
+            <para role="author">
+              Spiros Papadimitriou 				
+              <email>[email protected]</email>
+            </para>
+            <para role="author">
+              Dan Mueth 				
+	      <email>[email protected]</email>
+            </para>
+            <para role="publisher">
+              MATE Documentation Project
+            </para>
+          </revdescription>
+        </revision>
+      </revhistory>
+        	 
+      <releaseinfo>
+          This manual describes version &appletversion; of &applet;. 		
+      </releaseinfo>
+        	 
+      <legalnotice>
+         <title>Feedback</title>  		
+         <para>
+             To report a bug or make a suggestion regarding the &applet; applet or this manual, follow the directions in the <ulink url="ghelp:mate-feedback" type="help">MATE Feedback Page</ulink>. 
+         </para>
+         		 	 
+      </legalnotice>
+          
+   </articleinfo>
+       <indexterm>  	 
+       <primary>Weather Report</primary>    
+       </indexterm> 
+   <!-- ============= Document Body ============================= -->
+   <!-- ============= Introduction ============================== -->
+   <sect1 id="mateweather-introduction">
+      <title>Introduction</title>
+      <!-- ==== Figure ============================================= -->
+      	 
+      <figure id="weather-applet-fig">
+	<title>&applet;</title>  		
+         <screenshot>             		  
+            <mediaobject>                 			 
+               <imageobject>
+                  <imagedata fileref="figures/mateweather_applet.png" format="PNG"/>                  			 
+               </imageobject>
+               <textobject>
+                  <phrase>Shows &applet;. Contains a weather icon and current temperature</phrase> 			 
+               </textobject>
+            </mediaobject>
+         </screenshot>
+      </figure>
+       
+      <!-- ==== End of Figure ======================================= -->
+      <para>
+         The <application>&applet;</application> downloads weather information from the U.S National Weather Service (NWS) servers, including the Interactive Weather Information Network (IWIN) and other weather services. You can use <application>&applet;</application> to display current weather information and weather forecasts on your computer. 
+      </para>
+      <note id="proxies-note-1">
+         <para>
+            If your computer is located behind a firewall, you must use a proxy server to access the weather servers. To configure the MATE Desktop to use a proxy server, use your preference tools to specify the network proxy server for Internet connections.       
+         </para>
+      </note>   
+      <para>
+         <application>&applet;</application> displays the following information for the default location, or a location that you specify:
+      </para>
+      <itemizedlist>
+         <listitem>
+            <para>
+               A weather icon that represents the general weather conditions.
+	       See <xref linkend="mateweather-introduction-icons" />.
+            </para>
+         </listitem>
+         <listitem>
+            <para>
+               The current temperature.
+            </para>
+         </listitem>
+      </itemizedlist>
+
+    <sect2 id="mateweather-introduction-icons">
+     <title>Weather Icons on Panel</title>
+     <informaltable frame="all">
+      <tgroup cols="2" colsep="1" rowsep="1">
+       <colspec colname="COLSPEC0" colwidth="50*"/>
+       <colspec colname="COLSPEC1" colwidth="50*"/>
+       <thead>
+        <row valign="top">
+	 <entry colname="COLSPEC0"><para>Icon</para></entry>
+	 <entry colname="COLSPEC1"><para>Description</para></entry>
+	</row>
+       </thead>
+       <tbody>
+            <row valign="top">
+              <entry><para><inlinemediaobject><imageobject>
+	       <imagedata fileref="figures/stock_weather-sunny.png"
+	       		  format="PNG"/>
+	      </imageobject><textobject>
+	       <phrase>Stock Sunny</phrase>
+	      </textobject></inlinemediaobject>
+	      <inlinemediaobject><imageobject>
+	       <imagedata fileref="figures/stock_weather-night-clear.png"
+	       		  format="PNG"/>
+	      </imageobject><textobject>
+	       <phrase>Stock Night</phrase>
+	      </textobject></inlinemediaobject></para></entry>
+              <entry><para>
+                  It is clear and fine.
+                </para></entry>
+             </row>
+            <row valign="top">
+              <entry><para><inlinemediaobject><imageobject>
+	       <imagedata fileref="figures/stock_weather-few-clouds.png"
+	       		  format="PNG"/>
+	      </imageobject><textobject>
+	       <phrase>Stock Few Clouds</phrase>
+	      </textobject></inlinemediaobject>
+	      <inlinemediaobject><imageobject>
+	       <imagedata fileref="figures/stock_weather-night-few-clouds.png"
+	       		  format="PNG"/>
+	      </imageobject><textobject>
+	       <phrase>Stock Night Few Clouds</phrase>
+	      </textobject></inlinemediaobject></para></entry>
+              <entry><para>
+                  It is partly cloudy.
+                </para></entry>
+             </row>
+            <row valign="top">
+              <entry><para><inlinemediaobject><imageobject>
+	       <imagedata fileref="figures/stock_weather-cloudy.png"
+	       		  format="PNG"/>
+	      </imageobject><textobject>
+	       <phrase>Stock Cloudy</phrase>
+	      </textobject></inlinemediaobject></para></entry>
+              <entry><para>
+                  It is cloudy.
+                </para></entry>
+             </row>
+            <row valign="top">
+              <entry><para><inlinemediaobject><imageobject>
+	       <imagedata fileref="figures/stock_weather-fog.png"
+	       		  format="PNG"/>
+	      </imageobject><textobject>
+	       <phrase>Stock Fog</phrase>
+	      </textobject></inlinemediaobject></para></entry>
+              <entry><para>
+                  It is foggy or overcast.
+                </para></entry>
+             </row>
+            <row valign="top">
+              <entry><para><inlinemediaobject><imageobject>
+	       <imagedata fileref="figures/stock_weather-showers.png"
+	       		  format="PNG"/>
+	      </imageobject><textobject>
+	       <phrase>Stock Rain</phrase>
+	      </textobject></inlinemediaobject></para></entry>
+              <entry><para>
+                  It is rainy or wet.
+                </para></entry>
+             </row>
+            <row valign="top">
+              <entry><para><inlinemediaobject><imageobject>
+	       <imagedata fileref="figures/stock_weather-snow.png"
+	       		  format="PNG"/>
+	      </imageobject><textobject>
+	       <phrase>Stock Snow</phrase>
+	      </textobject></inlinemediaobject></para></entry>
+              <entry><para>
+                  It is snowing.
+                </para></entry>
+             </row>
+            <row valign="top">
+              <entry><para><inlinemediaobject><imageobject>
+	       <imagedata fileref="figures/stock_weather-storm.png"
+	       		  format="PNG"/>
+	      </imageobject><textobject>
+	       <phrase>Stock Storm</phrase>
+	      </textobject></inlinemediaobject></para></entry>
+              <entry><para>
+                  It is stormy.
+                </para></entry>
+             </row>
+       </tbody>
+      </tgroup>
+     </informaltable>
+    </sect2>
+
+    <sect2 id="mateweather-introduction-add">
+      <title>To Add &applet; to a Panel</title>
+      <para>To add <application>&applet;</application> to a panel,
+      right-click on the panel, then choose <guimenuitem>Add to
+      Panel</guimenuitem>.  Select <application>&applet;</application>
+      in the <application>Add to the panel</application> dialog, then
+      click <guibutton>OK</guibutton>.</para>
+    </sect2>
+
+      
+   </sect1>
+   <!-- ============= Usage ===================================== -->
+   <sect1 id="mateweather-usage">
+      <title>Preferences</title>
+      <para>
+       The preferences dialog is accessed by right-clicking on the &applet; in
+       the panel.
+      <figure id="weather-applet-menu-prefs">
+	<title>&applet; menu</title>
+         <screenshot>
+            <mediaobject>                 			 
+               <imageobject>
+                  <imagedata fileref="figures/mateweather-menu-prefs.png" format="PNG"/>                  			 
+               </imageobject>
+               <textobject>
+                  <phrase>Context menu</phrase>
+               </textobject>
+            </mediaobject>
+         </screenshot>
+      </figure>
+      </para>
+      <sect2 id="mateweather-change-location">
+         <title>Changing to Particular Location</title>
+      <figure id="weather-applet-prefs-locations-fig">
+	<title>Location Preferences</title>
+         <screenshot>
+            <mediaobject>                 			 
+               <imageobject>
+                  <imagedata fileref="figures/mateweather-prefs-locations.png" format="PNG"/>                  			 
+               </imageobject>
+               <textobject>
+                  <phrase>Location Preferences</phrase>
+               </textobject>
+            </mediaobject>
+         </screenshot>
+      </figure>
+         <para>
+            When you add the <application>&applet;</application> to a panel for
+	    the first time, the application displays the weather for Pittsburg, Pennsylvania by default. To display the weather for a different location, perform the following steps:
+         </para>
+         <orderedlist>
+            <listitem>
+               <para>
+                  Right-click on the application.
+               </para>
+            </listitem>
+            <listitem>
+               <para>
+                  Choose <guimenuitem>Preferences</guimenuitem> from the
+		  application popup menu. The application displays the <guilabel>Weather Preferences</guilabel> dialog.
+               </para>
+            </listitem>
+            <listitem>
+               <para>
+                  Select the <guilabel>Location</guilabel> tab. The <guilabel>Location</guilabel> tabbed section contains a list of geographical regions, subregions, and specific locations.
+               </para>
+            </listitem>
+            <listitem>
+               <para>
+                  Click on the arrow next to a region to display the subregions in the region.
+               </para>
+            </listitem>
+            <listitem>
+               <para>
+                  Click on the arrow next to a subregion to display the locations in the subregion.
+               </para>
+            </listitem>
+            <listitem>
+               <para>
+                  Click on a location. While the application retrieves the
+		  weather information for the new location, the tooltip
+		  "Updating" is displayed when you point to the icon.
+               </para>
+            </listitem>
+            <listitem>
+               <para>
+                  Click <guibutton>Close</guibutton> to close the <guilabel>Weather Preferences</guilabel> dialog.
+               </para>
+            </listitem>
+         </orderedlist>
+	 <para>
+	  You can already try searching by entering the name of your city into
+	  the <guilabel>Find</guilabel> field. Be aware that for cities close
+	  together, or for cities with no airport you may have to pick a nearby
+	  city in the region.
+	 </para>
+      </sect2>
+      <sect2 id="mateweather-update">
+         <title>Updating Weather Information</title>
+         <para>
+            To update the weather information that the &applet; displays in the
+	    panel, right-click on the icon, then choose <guimenuitem>Update</guimenuitem>.
+         </para>
+         <para>To automatically update the weather information at regular intervals, perform the following steps:</para>
+	    <orderedlist>
+                  <listitem><para>Go to the right-click menu and select <guimenuitem>Preferences</guimenuitem>.</para></listitem>
+                   <listitem><para>In the <guilabel>Weather Preferences</guilabel> dialog under the <guilabel>General</guilabel> tab, select the <guilabel>Automatically update every ... minutes</guilabel> option.</para></listitem>
+		<listitem><para>Use the spin box to specify the interval at
+		which the &applet; retrieves updated information from the weather server. The default is to check every thirty minutes.</para></listitem>
+                    <listitem><para>Click <guibutton>Close</guibutton> to close the <guilabel>Weather Preferences</guilabel> dialog.</para></listitem>
+	      </orderedlist>
+         </sect2>
+        <sect2 id="mateweather-metric"> 
+               <title>Changing Units</title>
+      <figure id="weather-applet-prefs-general-fig">
+	<title>General Preferences</title>
+         <screenshot>
+            <mediaobject>                 			 
+               <imageobject>
+                  <imagedata fileref="figures/mateweather-prefs-general.png" format="PNG"/>
+               </imageobject>
+               <textobject>
+                  <phrase>General Preferences</phrase>
+               </textobject>
+            </mediaobject>
+         </screenshot>
+      </figure>
+		     <para>
+                        Go to the right-click menu and select
+			<guimenuitem>Preferences</guimenuitem>. In the
+			<guilabel>Weather Preferences</guilabel> dialog under
+			the <guilabel>General</guilabel> tab, select the
+			units of measurement you want to use.
+                     </para>
+		     <para>
+		      A number of different measurements are available,
+		      including metric, imperial, SI and others. The choice
+		      <guilabel>Default</guilabel> will use what we think
+		      is the default for your region, based off your chosen
+		      locale.
+		     </para>
+          </sect2>
+         
+   </sect1>
+   <!-- ============= Preferences ================================== -->
+   <sect1 id="mateweather-settings">
+      <title>Details</title>
+
+         <para>
+            To view detailed weather information, right-click on the &applet;,
+	    then choose <guimenuitem>Details</guimenuitem>. The &applet; displays the <guilabel>Details</guilabel> dialog. The <guilabel>Details</guilabel> dialog contains the following default tabbed sections:
+         </para>
+         <itemizedlist>
+            <listitem>
+               <para>
+                  <guilabel>Current Conditions</guilabel>
+               </para>
+            </listitem>
+            <listitem>
+               <para>
+                  <guilabel>Forecast</guilabel>
+               </para>
+            </listitem>
+            <listitem>
+               <para>
+                  <guilabel>Radar Map (optional)</guilabel>
+               </para>
+            </listitem>
+         </itemizedlist>
+         <sect2 id="mateweather-current-conditions">
+            <title>Current Conditions</title>
+      <figure id="weather-applet-details-fig">
+	<title>&applet; Details</title>  		
+         <screenshot>             		  
+            <mediaobject>                 			 
+               <imageobject>
+                  <imagedata fileref="figures/mateweather-details.png" format="PNG"/>                  			 
+               </imageobject>
+               <textobject>
+                  <phrase>&applet; details</phrase>
+               </textobject>
+            </mediaobject>
+         </screenshot>
+      </figure>
+            <para>
+               The <guilabel>Current Conditions</guilabel> tabbed section displays the following information:
+            </para>
+            <informaltable>
+               <tgroup cols="2">
+                  <colspec colname="col1" colwidth="0.81*"/><colspec colname="col2"
+                  colwidth="1.19*"/>
+                  <tbody>
+                     <row valign="top">
+                        <entry colname="col1">
+                           <para>
+                              City
+                           </para>
+                        </entry>
+                        <entry colname="col2">
+                           <para>
+                              Location to which the current weather conditions apply.
+                           </para>
+                        </entry>
+                     </row>
+                     <row valign="top">
+                        <entry colname="col1">
+                           <para>
+                              Last update
+                           </para>
+                        </entry>
+                        <entry colname="col2">
+                           <para>
+                              Time at which the weather conditions were last updated on the weather server.
+                           </para>
+                        </entry>
+                     </row>
+                     <row valign="top">
+                        <entry colname="col1">
+                           <para>
+                              Conditions
+                           </para>
+                        </entry>
+                        <entry colname="col2">
+                           <para>
+                              General weather conditions.
+                           </para>
+                        </entry>
+                     </row>
+                     <row valign="top">
+                        <entry colname="col1">
+                           <para>
+                              Sky
+                           </para>
+                        </entry>
+                        <entry colname="col2">
+                           <para>
+                              General sky conditions.
+                           </para>
+                        </entry>
+                     </row>
+                     <row valign="top">
+                        <entry colname="col1">
+                           <para>
+                              Temperature
+                           </para>
+                        </entry>
+                        <entry colname="col2">
+                           <para>
+                              Current temperature.
+                           </para>
+                        </entry>
+                     </row>
+                     <row valign="top">
+                        <entry colname="col1">
+                           <para>
+                              Dew point
+                           </para>
+                        </entry>
+                        <entry colname="col2">
+                           <para>
+                              Temperature at which dew forms.
+                           </para>
+                        </entry>
+                     </row>
+                     <row valign="top">
+                        <entry colname="col1">
+                           <para>
+                              Humidity
+                           </para>
+                        </entry>
+                        <entry colname="col2">
+                           <para>
+                              Percentage of moisture in the atmosphere.
+                           </para>
+                        </entry>
+                     </row>
+                     <row valign="top">
+                        <entry colname="col1">
+                           <para>
+                              Wind
+                           </para>
+                        </entry>
+                        <entry colname="col2">
+                           <para>
+                              Direction and speed of the wind.
+                           </para>
+                        </entry>
+                     </row>
+                     <row valign="top">
+                        <entry colname="col1">
+                           <para>
+                              Pressure
+                           </para>
+                        </entry>
+                        <entry colname="col2">
+                           <para>
+                              Atmospheric pressure. 
+                           </para>
+                        </entry>
+                     </row>
+                     <row valign="top">
+                        <entry colname="col1">
+                           <para>
+                              Visibility
+                           </para>
+                        </entry>
+                        <entry colname="col2">
+                           <para>
+                              Range of vision as determined by the light and atmosphere conditions.
+                           </para>
+                        </entry>
+                     </row>
+		     <row valign="top">
+		      <entry colname="col1">
+		       <para>Sunrise</para>
+		      </entry>
+		      <entry colname="col2">
+		       <para>The calculated sunrise time for your location</para>
+		      </entry>
+		     </row>
+		     <row valign="top">
+		      <entry colname="col1">
+		       <para>Sunset</para>
+		      </entry>
+		      <entry>
+		       <para>The calculated sunset time for your location</para>
+		      </entry>
+		     </row>
+                  </tbody>
+               </tgroup>
+            </informaltable>
+
+	    <note><para>
+	     Sunrise and sunset times are calculated locally from
+	     latitude and longitude information stored on your computer. Some
+	     conditions, such as refraction of light through the air, are hard
+	     to model. Resultantly, the calculated values for sunrise and
+	     sunset may be off by up to 10 minutes.
+	    </para></note>
+         </sect2>
+         <sect2 id="mateweather-forecast">
+            <title>Forecast</title>
+            <para>
+               The <guilabel>Forecast</guilabel> tabbed section displays a forecast for the location for the immediate future, usually the next five days. 
+            </para>
+            <note>
+               <para>
+                  Forecasts are only available for some locations in the U.S.A,
+		  Australia and the United Kingdom.
+               </para>
+            </note>
+         </sect2>
+         <sect2 id="mateweather-radar-map">
+            <title>Radar Map</title>
+            <para>
+               By default, the <guilabel>Radar Map</guilabel> tabbed section is
+	       not displayed in the <guilabel>Forecast</guilabel> dialog.
+	       <application>&applet;</application>  downloads the radar maps
+	       from www.weather.com. If the radar map is not available from
+	       www.weather.com, &applet; displays a question mark. To go to the www.weather.com web site, click on the <guibutton>Visit Weather.com</guibutton> button.
+            </para>
+            <para>To enable the radar map, perform the following steps:
+	     <orderedlist>
+		<listitem><para>Go to the <guilabel>Weather Preferences</guilabel> dialog by selecting <guilabel>Preferences</guilabel> in the right-click menu.</para></listitem>
+ 		<listitem><para>In the <guilabel>General</guilabel> tab, select the <guilabel>Enable radar map</guilabel> option. </para></listitem>
+		<listitem><para>By default, <application>&applet;</application> downloads the radar maps from www.weather.com. Select the <guilabel>Use custom address for radar map</guilabel> option to display radar maps from an alternative Internet address. You must type the address in the <guilabel>Address</guilabel> text box.</para></listitem>
+	      </orderedlist>
+                     </para>
+	<note><para>
+	 Most locations do not define a default radar map, especially outside
+	 of the U.S.A. Many locations will require you to specify a custom URL,
+	 if you wish to have a radar map.
+	</para></note>
+      </sect2>
+   </sect1>
+</article>