<HTML
><HEAD
><TITLE
>GNOME Weather Applet</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.54"></HEAD
><BODY
CLASS="ARTICLE"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="ARTICLE"
><DIV
CLASS="TITLEPAGE"
><H1
CLASS="TITLE"
><A
NAME="AEN2"
>GNOME Weather Applet</A
></H1
><P
CLASS="COPYRIGHT"
><A
HREF="ln7.html"
>Copyright</A
> &copy; 1999-2000 by <SPAN
CLASS="HOLDER"
>Spiros Papadimitriou and Dan Mueth</SPAN
></P
><HR
WIDTH="75%"
ALIGN="CENTER"
COLOR="#000000"
SIZE="1"></DIV
><DIV
CLASS="TOC"
><DL
><DT
><B
>Table of Contents</B
></DT
><DT
><A
HREF="index.html#GWEATHER"
>GNOME Weather Applet</A
></DT
></DL
></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="GWEATHER"
>GNOME Weather Applet</A
></H1
><P
>   <TT
CLASS="APPLICATION"
>GNOME Weather</TT
> applet, shown in <A
HREF="index.html#GWEATHERAPPLET-FIG"
>Figure 1</A
>, retrieves and displays various
   weather information. To add this applet to a <SPAN
CLASS="INTERFACE"
>Panel</SPAN
>, 
   right-click on the <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> and choose
   <B
CLASS="GUIMENU"
>Panel</B
>-&gt;<B
CLASS="GUISUBMENU"
>Add to panel</B
>-&gt;<B
CLASS="GUISUBMENU"
>Applet</B
>-&gt;<B
CLASS="GUISUBMENU"
>Utility</B
>-&gt;<B
CLASS="GUIMENUITEM"
>GNOME Weather</B
>.
  </P
><DIV
CLASS="FIGURE"
><A
NAME="GWEATHERAPPLET-FIG"
></A
><P
><IMG
SRC="gweather_applet.png"></P
><P
><B
>Figure 1. GNOME Weather Applet</B
></P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="GWEATHER-USAGE"
>Usage</A
></H2
><P
>    <TT
CLASS="APPLICATION"
>GNOME Weather</TT
> displays the current
    temperature and weather conditions in numeric and iconified form
    inside the applet.  For further information, double-click on the
    applet. This will open up the <SPAN
CLASS="INTERFACE"
>Weather Information
    Window</SPAN
>, shown in <A
HREF="index.html#GWEATHER-WEATHER-FIG"
>Figure 2</A
>. This displays the current weather
    information and either a one-day or five-day forecast.
   </P
><DIV
CLASS="FIGURE"
><A
NAME="GWEATHER-WEATHER-FIG"
></A
><P
><IMG
SRC="gweather_weather.png"></P
><P
><B
>Figure 2. Weather Information Window</B
></P
></DIV
><P
>    Right-clicking on the applet brings up a menu containing the
    following items:
    <P
></P
><UL
><LI
><P
>       <B
CLASS="GUIMENUITEM"
>Update</B
> &#8212;
       refreshes the weather information and display.
      </P
></LI
><LI
><P
>       <B
CLASS="GUIMENUITEM"
>Properties&#8230;</B
> &#8212;
       opens the <A
HREF="index.html#GWEATHER-PREFS"
>       <TT
CLASS="GUILABEL"
><B
>Properties</B
></TT
></A
> dialog.
      </P
></LI
><LI
><P
>       <B
CLASS="GUIMENUITEM"
>Help</B
> &#8212;
       displays this document.
      </P
></LI
><LI
><P
>       <B
CLASS="GUIMENUITEM"
>About&#8230;</B
> &#8212;
       shows basic information about <TT
CLASS="APPLICATION"
>GNOME Weather
       Applet</TT
>, inluding the applet's version and the
       author's name.
      </P
></LI
></UL
>
   </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="GWEATHER-PREFS"
>Customization</A
></H2
><P
>      You can customize <TT
CLASS="APPLICATION"
>GNOME Weather</TT
>
      applet by right-clicking on it and choosing
      <B
CLASS="GUIMENUITEM"
>Properties&#8230;</B
>. This will open the
      <SPAN
CLASS="INTERFACE"
>Properties</SPAN
> dialog(shown in <A
HREF="index.html#GWEATHER-SETTINGS-FIG"
>Figure 3</A
>), which allows you to
      change various settings.
    </P
><DIV
CLASS="FIGURE"
><A
NAME="GWEATHER-SETTINGS-FIG"
></A
><P
><IMG
SRC="gweather_settings.png"></P
><P
><B
>Figure 3. Properties dialog</B
></P
></DIV
><P
>     The properties in the <TT
CLASS="GUILABEL"
><B
>Basic</B
></TT
> tab are:
     <P
></P
><UL
><LI
><P
>        Update Interval &#8212; This option determines how often
        <TT
CLASS="APPLICATION"
>GNOME Weather</TT
> will connect 
        to the server(s) and retrieve weather information. Current
        conditions, forecast and radar map (if enabled) will be
        downloaded
       </P
><DIV
CLASS="NOTE"
><P
></P
><TABLE
CLASS="NOTE"
WIDTH="90%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="./stylesheet-images/note.png"
HSPACE="5"
ALT="Note"></TD
><TH
ALIGN="LEFT"
VALIGN="CENTER"
><B
>Note About Server Updates</B
></TH
></TR
><TR
><TD
>&nbsp;</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>         Note that the <TT
CLASS="GUILABEL"
><B
>Update Interval</B
></TT
> only
         determines how often your computer downloads information from
         the server(s).  The update time shown in the
         <SPAN
CLASS="INTERFACE"
>Current Conditions</SPAN
> tab (viewed by
         double-clicking on the applet) indicates when those
         measurements were  renewed on the server, rather than when
         they were last retrieved.
        </P
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="NOTE"
><P
></P
><TABLE
CLASS="NOTE"
WIDTH="90%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="./stylesheet-images/note.png"
HSPACE="5"
ALT="Note"></TD
><TH
ALIGN="LEFT"
VALIGN="CENTER"
><B
>Disabling Automatic Updates and Using Manual Updates</B
></TH
></TR
><TR
><TD
>&nbsp;</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>         You can disable automatic updates by unchecking the
         <TT
CLASS="GUILABEL"
><B
>Update enabled</B
></TT
> box.  On the other hand, you can
         also force <TT
CLASS="APPLICATION"
>GNOME Weather</TT
> to
         perform an update by choosing the corresponding option in the
         popup menu.  These two options are very useful if you have an
         intermitant internet connection, such as a laptop or modem
         provides.  
        </P
></TD
></TR
></TABLE
></DIV
></LI
><LI
><P
>        Update enabled &#8212; Select this if you would like
        <TT
CLASS="APPLICATION"
>GNOME Weather</TT
> to automatically
        download the latest weather information at the time interval
        specified by <TT
CLASS="GUILABEL"
><B
>Update</B
></TT
>.  Deselect this if
        you would only like weather updates to be done manually, by
        right-clicking on the applet and selecting
        <B
CLASS="GUIMENUITEM"
>Update</B
>.
       </P
></LI
><LI
><P
>        Use metric &#8212; By default <TT
CLASS="APPLICATION"
>GNOME
        Weather</TT
> uses the imperial system of
        units. Select this box to use metric units. The units used are shown in
        <A
HREF="index.html#TAB-UNITS"
>Table 1</A
>.
       </P
><DIV
CLASS="TABLE"
><A
NAME="TAB-UNITS"
></A
><P
><B
>Table 1. Measurement Units</B
></P
><TABLE
BORDER="1"
BGCOLOR="#E0E0E0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><THEAD
><TR
><TH
ALIGN="LEFT"
VALIGN="TOP"
>Quantity</TH
><TH
ALIGN="LEFT"
VALIGN="TOP"
>Metric</TH
><TH
ALIGN="LEFT"
VALIGN="TOP"
>Imperial</TH
></TR
></THEAD
><TBODY
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>Temperature</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>deg Celsius</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>deg Farenheit</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>Windspeed</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>km/h</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>mph</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>Pressure</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>mmHg</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>inHg</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>Visibility</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>km</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>miles</TD
></TR
></TBODY
></TABLE
></DIV
></LI
><LI
><P
>        Detailed Forecast &#8212; Select this if you would like
        <TT
CLASS="APPLICATION"
>GNOME Weather</TT
> to retrieve the
        full five day forecast for your particular area. Note that
        these forecasts may not be
        available for some locations. 
       </P
><P
>        The forecast retrieved when this
        button is not selected is a brief
        forecast for the broader area containing the selected location
        (usually the entire state) and typically is a 5-day forecast. 
       </P
><DIV
CLASS="NOTE"
><P
></P
><TABLE
CLASS="NOTE"
WIDTH="90%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="./stylesheet-images/note.png"
HSPACE="5"
ALT="Note"></TD
><TH
ALIGN="LEFT"
VALIGN="CENTER"
><B
>Forecast Availability</B
></TH
></TR
><TR
><TD
>&nbsp;</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>         Note that the detailed forecasts downloaded from IWIN are
         available only for US cities. 
        </P
></TD
></TR
></TABLE
></DIV
></LI
></UL
>
    </P
><P
>     The properties in the <TT
CLASS="GUILABEL"
><B
>Network</B
></TT
> tab should be
     used if your computer is located behind a firewall.  These
     properties are:
     <P
></P
><UL
><LI
><P
>        Use proxy &#8212; Select this button if your computer is
        behind a firewall and you must use an HTTP proxy to access the
        Web.
       </P
></LI
><LI
><P
>        Proxy host &#8212; Enter your proxy host IP address here (if
        you are using a HTTP proxy).
       </P
></LI
><LI
><P
>        Username &#8212; Enter your username here.
       </P
></LI
><LI
><P
>        Password &#8212; Enter your password here. (Note that this
        password will be saved in a private configuration file but
        will not be encrypted.)
       </P
></LI
></UL
>
    </P
><P
>     The <TT
CLASS="GUILABEL"
><B
>Location</B
></TT
> tab allows you to specify the
     geographic location that you would like <TT
CLASS="APPLICATION"
>GNOME
     Weather</TT
> applet to display the weather information
     for. Click on any plus (+) symbol to expand the tree or any minus
     (-) symbol to collapse a tree branch.  Select the city or region
     by clicking with the first mouse button.
    </P
><P
>     Locations are organized in a three-level hierarchy.  The top
     level contains broader geographical areas, the second contains
     sub-regions of these areas and the last contains the particular
     locations.  This hierarchy is essentially based on the way
     information is organized in the US NWS (National Weather
     Service), and that is the reason that the US and Canada appear on
     the topmost level.
    </P
><P
>  After you have made all the changes you want, click on
      <B
CLASS="GUIBUTTON"
>OK</B
> to apply the changes and close the
      <SPAN
CLASS="INTERFACE"
>Properties</SPAN
> dialog. To cancel the changes
      and return to previous values, click the
      <B
CLASS="GUIBUTTON"
>Cancel</B
> button.
    </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="GWEATHER-FURTHERINFO"
>Further Information</A
></H2
><P
>    <TT
CLASS="APPLICATION"
>GNOME Weather</TT
> has a homepage at <A
HREF="http://gweather.dhs.org/"
TARGET="_top"
>http://gweather.dhs.org/</A
>.
    Here you can find the latest <A
HREF="http://gweather.dhs.org/Locations"
TARGET="_top"
>Locations</A
> file,
    which is periodically updated with new cities, as sent in by
    users.  If your city is not included in the distribution, please
    send an email to Spiros Papadimitriou
    (<TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:spapadim+@cs.cmu.edu"
>spapadim+@cs.cmu.edu</A
>&#62;</TT
>)  with the necessary
    information and it will be included in the next release.
   </P
><P
>    You may also want to visit the homepage if you are curious to see
    <A
HREF="http://gweather.dhs.org/news.html"
TARGET="_top"
>what's new</A
>.
   </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="GWEATHER-BUGS"
>Known Bugs and Limitations</A
></H2
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="BLOCKING-IO"
>Blocking Input/Output</A
></H3
><P
>     Even though <TT
CLASS="APPLICATION"
>GNOME Weather</TT
> now uses
     non-blocking I/O to retrieve data from the network, there are
     still some steps that block execution.  Most notably,
     establishing a TCP connection to remote hosts is a blocking
     operation.  Because the NWS and IWIN web servers are often
     heavily loaded, this step may take a significant amount of time.
     While that happens, the application is unable to respond to CORBA
     requests from the <SPAN
CLASS="INTERFACE"
>Panel</SPAN
>.  In its current
     implementation, the <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> iterates through
     all applications and sends frequent CORBA requests (eg. for
     saving state).  If an applet cannot respond for any reason, then
     the <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> will block waiting for a
     response.
    </P
><P
>     While the <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> is blocked, it will not
     respond to any user (or application) requests.  For instance,
     <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> movement and
     <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> menus (the ones that appear upon a
     right click) will not work.  However, other applets in the
     <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> should work (unless they have made a
     CORBA request to the <SPAN
CLASS="INTERFACE"
>Panel</SPAN
>, eg. for
     querying <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> size).  As soon as the
     blocking operation in <TT
CLASS="APPLICATION"
>GNOME Weather</TT
>
     completes, things should return to normal (and user interface
     requests that were buffered will be executed).
    </P
><P
>     There is an experimental version of <TT
CLASS="APPLICATION"
>GNOME
     Weather</TT
> that uses a separate thread for HTTP
     processing, which may be incorporated  (temporarily) in the next
     release.  However, the final solution is
     <TT
CLASS="APPLICATION"
>gnome-vfs</TT
> which will  be part of GNOME
     2.0 and will offer cross-platform support for fully asynchronous
     I/O.
    </P
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="GWEATHER-FAQ"
>Frequently Asked Questions</A
></H2
><P
>    This is a list of frequently asked questions about
    <TT
CLASS="APPLICATION"
>GNOME Weather</TT
>.  For further information
    and updates, please visit the <A
HREF="http://gweather.dhs.org/"
TARGET="_top"
>GNOME Weather homepage</A
>.  If
    your question is still unresolved, you can email the author at
    <TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:spapadim+gweather@cs.cmu.edu"
>spapadim+gweather@cs.cmu.edu</A
>&#62;</TT
>.
   </P
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN183"
>Why does GNOME Weather freezes my Panel?</A
></H3
><P
>     This is due to the blocking nature of certain network operations
     (see also <A
HREF="index.html#BLOCKING-IO"
>the section called <I
>Blocking Input/Output</I
></A
>) and due to the way the
     <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> currently works.
    </P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN188"
>Why does location list appears empty?</A
></H3
><P
>     This is probably because the <TT
CLASS="FILENAME"
>Locations</TT
> file
     was not installed in the proper place.  This is usually because
     <TT
CLASS="APPLICATION"
>GNOME Weather</TT
> and GNOME were not
     configured in the same way.  The file containing the locations
     must be installed in the <TT
CLASS="FILENAME"
>gweather</TT
>
     subdirectory, under the gnome data directory.  You can find out
     the latter with the <TT
CLASS="USERINPUT"
><B
>gnome-config --datadir</B
></TT
>
     command.
    </P
><P
>     If you have compiled gnome-applets yourself, make sure that you
     have used <TT
CLASS="USERINPUT"
><B
>configure --prefix=`gnome-config --prefix`
     --sysconfdir=`gnome-config --sysconfdir`</B
></TT
>.  Binary
     RPMs assume a that the prefix and sysconfdir are
     <TT
CLASS="FILENAME"
>/usr</TT
> and <TT
CLASS="FILENAME"
>/etc</TT
>,
     respectively.  If you have compiled GNOME yourself with different
     options, you need to download and compile gnome-applets yourself.
    </P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN199"
>Why does GNOME Weather display a question mark and dashes
     for current conditions?</A
></H3
><P
>     This will happen if <TT
CLASS="APPLICATION"
>GNOME Weather</TT
>
     cannot access the NWS server for  any reason.  This may be
     because your network  connection is down, or the NWS server is
     down, or maybe the NWS server does not currently have any
     information about your location.
    </P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN203"
>Why does GNOME Weather say that a forecast is not
     available?</A
></H3
><P
>     If you have enabled detailed forecasts, then it is possible that
     one may not be available for your location.  In this case, try
     disabling detailed forecasts.
    </P
><P
>     Another possible reason is that the IWIN server is down and
     <TT
CLASS="APPLICATION"
>GNOME Weather</TT
> cannot retrieve forecast
     information.  The problem should go away as soon as the IWIN
     server is up  again.
    </P
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="GWEATHER-AUTHORS"
>Authors</A
></H2
><P
>    <TT
CLASS="APPLICATION"
>GNOME Weather</TT
> was written by Spiros
    Papadimitriou 
    (<TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:spapadim+@cs.cmu.edu"
>spapadim+@cs.cmu.edu</A
>&#62;</TT
>).  Please send all comments,
    suggestions, and bug 
    reports to the <A
HREF="http://bugs.gnome.org"
TARGET="_top"
>GNOME
    bug tracking database</A
>. (Instructions for submitting bug
    reports can be found <A
HREF="http://bugs.gnome.org/Reporting.html"
TARGET="_top"
>    on-line</A
>. If you are using
    GNOME 1.1 or later, you can also use <TT
CLASS="APPLICATION"
>Bug Report
    Tool</TT
> (<B
CLASS="COMMAND"
>bug-buddy</B
>), available in the
    <B
CLASS="GUISUBMENU"
>Utilities</B
> submenu of <B
CLASS="GUIMENU"
>Main
    Menu</B
>, for submitting bug reports.
   </P
><P
>    This manual was written by &#62;Spiros Papadimitriou
    (<TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:spapadim+@cs.cmu.edu"
>spapadim+@cs.cmu.edu</A
>&#62;</TT
>) and Dan Mueth
    (<TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:d-mueth@uchicago.edu"
>d-mueth@uchicago.edu</A
>&#62;</TT
>). Please send all comments and
    suggestions regarding this manual to the <A
HREF="http://www.gnome.org/gdp"
TARGET="_top"
>GNOME Documentation Project</A
> 
    by sending an email to <TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:docs@gnome.org"
>docs@gnome.org</A
>&#62;</TT
>. You can also
    submit comments online by using the <A
HREF="http://www.gnome.org/gdp/doctable/"
TARGET="_top"
>GNOME Documentation Status
    Table</A
>.
   </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="LICENSE"
>License</A
></H2
><P
>    This program is free software; you can redistribute it and/or
    modify it under the terms of the <I
CLASS="CITETITLE"
>GNU General Public
    License</I
> as published by the Free Software Foundation;
    either version 2 of the License, or (at your option) any later
    version.
   </P
><P
>    This program is distributed in the hope that it will be useful, but
    WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    <I
CLASS="CITETITLE"
>GNU General Public License</I
> for more details.
   </P
><P
>    A copy of the <I
CLASS="CITETITLE"
>GNU General Public License</I
> is
    included as an appendix to the <I
CLASS="CITETITLE"
>GNOME Users
    Guide</I
>.  You may also obtain a copy of the
    <I
CLASS="CITETITLE"
>GNU General Public License</I
> from the Free
    Software Foundation by visiting <A
HREF="http://www.fsf.org"
TARGET="_top"
>their Web site</A
> or by writing to
    <P
CLASS="ADDRESS"
>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Free&nbsp;Software&nbsp;Foundation,&nbsp;Inc.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<SPAN
CLASS="STREET"
>59 Temple Place</SPAN
>&nbsp;-&nbsp;Suite&nbsp;330<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<SPAN
CLASS="CITY"
>Boston</SPAN
>,&nbsp;<SPAN
CLASS="STATE"
>MA</SPAN
>&nbsp;<SPAN
CLASS="POSTCODE"
>02111-1307</SPAN
><br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<SPAN
CLASS="COUNTRY"
>USA</SPAN
><br>
&nbsp;&nbsp;&nbsp;&nbsp;</P
>
   </P
></DIV
></DIV
></DIV
></BODY
></HTML
>