<?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.1.3">
  <!ENTITY manrevision "2.3">
  <!ENTITY date "January 2003">
  <!ENTITY applet "Weather Report">
]>
<!-- 
      (Do not remove this comment block.)
  Maintained by the GNOME Documentation Project
  http://developer.gnome.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; Applet Manual V&manrevision;</title>  	 
      <copyright>
		<year>2003</year>
		<holder>Sun Microsystems</holder>    	 
      </copyright>
      <copyright>
		<year>2002</year>
		<holder>Sun Microsystems</holder>    	 
      </copyright>
      <copyright>
		<year>1999</year>  		
		<year>2000</year>
		<holder>Spiros Papadimitriou, 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>
		<publishername> GNOME 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>Sun </firstname>  		  
	<surname>GNOME Documentation Team</surname>            		  

            <affiliation>
		<orgname>Sun Microsystems</orgname>  			 
		<address><email>gdocteam@sun.com</email></address>  		  
            </affiliation>
              		
        </author>
           		
        <author>
	<firstname>Spiros</firstname>  		  
	<surname>Papadimitriou</surname>
             		  
            <affiliation>
		<orgname>GNOME Documentation Project</orgname>  			 
		<address><email>spapadim+@cs.cmu.edu</email> </address>  		  
            </affiliation>
              		
         </author>
           		
         <author>
	 <firstname>Dan</firstname>
	 <surname>Mueth</surname>  	
	  
	     <affiliation>
 		<orgname>GNOME Documentation Project</orgname>  			 
		<address><email>d-mueth@uchicago.edu</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>translator@gnome.org</email> </address> 
         	     </affiliation>
         	     <contrib>Latin translation</contrib>
                    </othercredit>
         -->
         	 
      </authorgroup>
      	 
      <revhistory>
         		
         <revision>
              	<revnumber>&applet; Applet Manual V&manrevision;</revnumber>  		
             	<date>&date;</date>  		  
            	<revdescription>
                 			 
		<para role="author">Sun GNOME Documentation Team <email>gdocteam@sun.com</email>
		</para>
                 			 
		<para role="publisher">
                  GNOME Documentation Project
                </para>
                 		  
            </revdescription>
              		
         </revision>

         <revision>
              	<revnumber>Weather Report Applet Manual V2.2</revnumber>  		
             	<date>August 2002</date>  		  
            	<revdescription>
                 			 
		<para role="author">Sun GNOME Documentation Team <email>gdocteam@sun.com</email>
		</para>
                 			 
		<para role="publisher">
                  GNOME Documentation Project
                </para>
                 		  
            </revdescription>
          </revision>  
         
         <revision>
              	<revnumber>Weather Report Applet Manual V2.1</revnumber>  		
             	<date>July 2002</date>  		  
            	<revdescription>
                 			 
		<para role="author">Sun GNOME Documentation Team <email>gdocteam@sun.com</email>
		</para>
                 			 
		<para role="publisher">
                  GNOME Documentation Project
                </para>
                 		  
            </revdescription>
              		
         </revision>
         
         <revision>
              	<revnumber>Weather Report Applet Manual V2.0</revnumber>  		
             	<date>March 2002</date>  		  
            	<revdescription>
                 			 
		<para role="author">Sun GNOME Documentation Team <email>gdocteam@sun.com</email>
		</para>
                 			 
		<para role="publisher">
                  GNOME Documentation Project
                </para>
                 		  
            </revdescription>
              		
         </revision>
           		
         <revision>
		<revnumber>GNOME Weather Applet</revnumber>  		  
		<date>2000</date>
             		  
            <revdescription>
                 			 
               <para role="author">
                  Spiros Papadimitriou 				
		  <email>spapadim+@cs.cmu.edu</email>
               </para>
                 			 
               <para role="author">
                  Dan Mueth 				
		  <email>d-mueth@uchicago.edu</email>
               </para>
               			 
               <para role="publisher">
                  GNOME 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:gnome-feedback" type="help">GNOME Feedback Page</ulink>. 
         </para>
         		 	 
      </legalnotice>
          
   </articleinfo>
       <indexterm>  	 
       <primary>Weather Report</primary>    
       </indexterm> 
   <!-- ============= Document Body ============================= -->
   <!-- ============= Introduction ============================== -->
   <sect1 id="gweather-introduction">
      <title>Introduction</title>
      <!-- ==== Figure ============================================= -->
      	 
      <figure id="weather-applet-fig">
	<title>&applet; Applet</title>  		
         <screenshot>             		  
            <mediaobject>                 			 
               <imageobject>
                  <imagedata fileref="figures/gweather_applet.png" format="PNG"/>                  			 
               </imageobject>
               <textobject>
                  <phrase>Shows Weather Report applet. Contains a weather icon and current temperature</phrase> 			 
               </textobject>
            </mediaobject>
         </screenshot>
      </figure>
       
      <!-- ==== End of Figure ======================================= -->
      <para>
         The <application>&applet;</application> applet downloads weather information
          from the U.S National Weather Service (NWS) servers, including the Interactive
         Weather Information Network (IWIN). You can use <application>&applet;</application> to display current
         weather information and weather forecasts on your computer. 
      </para>
      <para>
         To add <application>&applet;</application> to a panel, right-click on the
         panel, then choose 
         <menuchoice>
            <guimenu>Add to Panel</guimenu> 
            <guisubmenu>Accessories</guisubmenu> 
            <guimenuitem>&applet;</guimenuitem>
         </menuchoice>.</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. For more information about how to specify 
            a proxy server, see <xref linkend="gweather-set-proxy"/>.        
         </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. For
               example, an icon of the sun represents sunny weather conditions. To
               view a text description of the general weather conditions, point to
               the applet to display a tooltip.
            </para>
         </listitem>
         <listitem>
            <para>
               The current temperature.
            </para>
         </listitem>
      </itemizedlist>
      
   </sect1>
   <!-- ============= Usage ===================================== -->
   <sect1 id="gweather-usage">
      <title>Usage</title>
      <sect2 id="gweather-change-location">
         <title>To View Weather Information for a Particular Location</title>
         <para>
            When you add the <application>&applet;</application> applet to a panel
            for the first time, the applet 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 applet.
               </para>
            </listitem>
            <listitem>
               <para>
                  Choose <guimenuitem>Preferences</guimenuitem> from the applet popup
                  menu. The applet displays the <guilabel>Weather Preferences</guilabel> dialog.
                  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 applet retrieves the weather information
                   for the new location, the tooltip "Updating" is displayed when
                  you point to the applet.
               </para>
            </listitem>
            <listitem>
               <para>
                  Click <guibutton>Close</guibutton> to close the <guilabel>Weather
                  Preferences</guilabel> dialog.
               </para>
            </listitem>
         </orderedlist>
      </sect2>
      <sect2 id="gweather-update">
         <title>To Update the Weather Information</title>
         <para>
            To update the weather information that the applet displays in the panel,
            right-click on the applet, then choose <guimenuitem>Update</guimenuitem>.
         </para>
         <para>
            You can configure the applet to automatically update the information
            at regular intervals. See <xref linkend="gweather-configure"/> for more
            information about how to configure the applet. 
         </para>
      </sect2>
      <sect2 id="gweather-detailed">
         <title>To View Detailed Weather Information</title>
         <para>
            To view detailed weather information, right-click on the applet, then
            choose <guimenuitem>Forecast</guimenuitem>. The applet displays the <guilabel>Forecast</guilabel>
            dialog. The <guilabel>Forecast</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>
         </itemizedlist>
         <sect3 id="gweather-current-conditions">
            <title>Current conditions</title>
            <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>
                              Location
                           </para>
                        </entry>
                        <entry colname="col2">
                           <para>
                              The location to which the current weather conditions
                              apply.
                           </para>
                        </entry>
                     </row>
                     <row valign="top">
                        <entry colname="col1">
                           <para>
                              Update
                           </para>
                        </entry>
                        <entry colname="col2">
                           <para>
                              The 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>
                              The general weather conditions.
                           </para>
                        </entry>
                     </row>
                     <row valign="top">
                        <entry colname="col1">
                           <para>
                              Sky
                           </para>
                        </entry>
                        <entry colname="col2">
                           <para>
                              The general sky conditions.
                           </para>
                        </entry>
                     </row>
                     <row valign="top">
                        <entry colname="col1">
                           <para>
                              Temperature
                           </para>
                        </entry>
                        <entry colname="col2">
                           <para>
                              The current temperature.
                           </para>
                        </entry>
                     </row>
                     <row valign="top">
                        <entry colname="col1">
                           <para>
                              Dew point
                           </para>
                        </entry>
                        <entry colname="col2">
                           <para>
                              The temperature at which dew forms.
                           </para>
                        </entry>
                     </row>
                     <row valign="top">
                        <entry colname="col1">
                           <para>
                              Humidity
                           </para>
                        </entry>
                        <entry colname="col2">
                           <para>
                              The percentage of moisture in the atmosphere.
                           </para>
                        </entry>
                     </row>
                     <row valign="top">
                        <entry colname="col1">
                           <para>
                              Wind
                           </para>
                        </entry>
                        <entry colname="col2">
                           <para>
                              The direction and speed of the wind.
                           </para>
                        </entry>
                     </row>
                     <row valign="top">
                        <entry colname="col1">
                           <para>
                              Pressure
                           </para>
                        </entry>
                        <entry colname="col2">
                           <para>
                              The atmospheric pressure in inches of mercury. 
                           </para>
                        </entry>
                     </row>
                     <row valign="top">
                        <entry colname="col1">
                           <para>
                              Visibility
                           </para>
                        </entry>
                        <entry colname="col2">
                           <para>
                              The range of vision as determined by the light and
                              atmosphere conditions.
                           </para>
                        </entry>
                     </row>
                  </tbody>
               </tgroup>
            </informaltable>
         </sect3>
         <sect3 id="gweather-forecast">
            <title>Forecast</title>
            <para>
               The <guilabel>Forecast</guilabel> tabbed section displays a forecast
               for the location for the coming days, usually the next five days. 
            </para>
            <note>
               <para>
                  Forecasts are only available for some locations in the U.S.A.
               </para>
            </note>
         </sect3>
         <sect3 id="gweather-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. See <xref linkend="gweather-configure"/>
               for more  information about how to configure the applet to display
               radar maps. <application>&applet;</application>  downloads the radar
               maps from www.weather.com. If the radar map is not available from
               www.weather.com, the applet displays a question mark. To go to the
               www.weather.com web site, click on the <guibutton>Visit Weather.com</guibutton>
                button.
            </para>
         </sect3>
      </sect2>
   </sect1>
   <!-- ============= Preferences ================================== -->
   <sect1 id="gweather-settings">
      <title>Preferences</title>
      
      <sect2 id="gweather-set-proxy">
      <title>To Set a Proxy Server</title>
      <para>If your computer is located behind a firewall you must use a proxy server to run 
      <application>&applet;</application> successfully. 
      To configure GNOME to use a proxy server, choose 
      <menuchoice>
      <guimenu>Applications</guimenu>
      <guisubmenu>Desktop Preferences</guisubmenu> 
      <guimenuitem>Network Proxy</guimenuitem>
      </menuchoice>.</para>
      </sect2>
      
      <sect2 id="gweather-configure">
      <title>To Configure &applet;</title>
      <para>
         To configure <application>&applet;</application>, right-click
         on the applet, then choose <guimenuitem>Preferences</guimenuitem>. The <guilabel>Weather Preferences</guilabel> dialog contains
         the following tabbed sections:
      </para>
      <itemizedlist>
         <listitem>
            <para>
               <link linkend="gweather-location">Location</link>
            </para>
         </listitem>
         <listitem>
            <para>
               <link linkend="gweather-general">General</link>
            </para>
         </listitem>
      </itemizedlist>
            
      
      <sect3 id="gweather-location">
         <title>Location</title>
         <para>
            The <guilabel>Location</guilabel> tabbed section enables you to select
            the location for which you want to display the current and forecast weather
            conditions. See <xref linkend="gweather-change-location"/> for information
            about how to select a location.
         </para>
      </sect3>
      
      <sect3 id="gweather-general">
         <title>General</title>
           <variablelist>
               <varlistentry>
                  <term><guilabel>Automatically update every xx minutes</guilabel>
                  </term>
                  <listitem>
                     <para>
                        Select this option to enable the applet to automatically
                        retrieve updated information from the weather server at regular
                        intervals. Use the spin box to specify  the interval in minutes
                        at which the applet retrieves updated information from the
                         weather server. 
                     </para>
                     <para>
                        Default: selected, 30 minutes.
                     </para>
                  </listitem>
               </varlistentry>
               <varlistentry>
                  <term><guilabel>Use metric system units</guilabel> </term>
                  <listitem>
                     <para>
                        Select this option to use Celsius and metric units of measurement
                        instead of Fahrenheit and imperial units of measurement in
                        the applet. The way in which this  option affects the measurement
                        units displayed in the applet is as follows:
                     </para>
                     <informaltable>
                        <tgroup cols="3">
                           <colspec colname="COLSPEC0" colwidth="1.00*"/><colspec
                           colname="col1"/><colspec colname="col2"/>
                           <thead>
                              <row valign="top">
                                 <entry colname="COLSPEC0">
                                    <para>
                                       Measurement unit displayed for...
                                    </para>
                                 </entry>
                                 <entry colname="col1">
                                    <para>
                                       <guilabel>Use metric system units</guilabel>
                                       option not selected
                                    </para>
                                 </entry>
                                 <entry colname="col2">
                                    <para>
                                       <guilabel>Use metric system units</guilabel>
                                       option selected
                                    </para>
                                 </entry>
                              </row>
                           </thead>
                           <tbody>
                              <row valign="top">
                                 <entry colname="COLSPEC0">
                                    <para>
                                       Temperature and dew point
                                    </para>
                                 </entry>
                                 <entry colname="col1">
                                    <para>
                                       degrees Fahrenheit
                                    </para>
                                 </entry>
                                 <entry colname="col2">
                                    <para>
                                       degrees Celsius
                                    </para>
                                 </entry>
                              </row>
                              <row valign="top">
                                 <entry colname="COLSPEC0">
                                    <para>
                                       Wind speed
                                    </para>
                                 </entry>
                                 <entry colname="col1">
                                    <para>
                                       miles per hour (mph)
                                    </para>
                                 </entry>
                                 <entry colname="col2">
                                    <para>
                                       kilometers per hour (kph)
                                    </para>
                                 </entry>
                              </row>
                              <row valign="top">
                                 <entry colname="COLSPEC0">
                                    <para>
                                       Pressure
                                    </para>
                                 </entry>
                                 <entry colname="col1">
                                    <para>
                                       inches of mercury (inHg)
                                    </para>
                                 </entry>
                                 <entry colname="col2">
                                    <para>
                                       millimeters of mercury (mmHg)
                                    </para>
                                 </entry>
                              </row>
                              <row valign="top">
                                 <entry colname="COLSPEC0">
                                    <para>
                                       Visibility
                                    </para>
                                 </entry>
                                 <entry colname="col1">
                                    <para>
                                       miles
                                    </para>
                                 </entry>
                                 <entry colname="col2">
                                    <para>
                                       kilometers
                                    </para>
                                 </entry>
                              </row>
                           </tbody>
                        </tgroup>
                     </informaltable>
                     <para>
                        Default: unselected.
                     </para>
                  </listitem>
               </varlistentry>
               <varlistentry>
                  <term><guilabel>Enable radar map</guilabel> </term>
                  <listitem>
                     <para>
                        Select this option to enable the applet to display radar
                        maps in a <guilabel>Radar map</guilabel>
                        tabbed section of the <guilabel>Forecast</guilabel> dialog.                   
                     </para>
                     <para>
                        Default: unselected.
                     </para>
                  </listitem>
               </varlistentry>
               <varlistentry>
                  <term><guilabel>Use custom address for radar map</guilabel> </term>
                  <listitem>
                     <para>
                        By default, <application>&applet;</application> downloads the radar
                        maps from www.weather.com. Select this option to display radar maps from 
                        an alternative Internet address. Type the address in the 
                        <guilabel>Address</guilabel> text box.
                     </para>
                     <para>
                        Default: unselected.
                     </para>
                  </listitem>
               </varlistentry>
            </variablelist>
      </sect3>
      </sect2>
   </sect1>
</article>
