--  README for bbweather 0.1 Beta - a tool which displays the current 
--  weather conditions in a decorated X11-Window.

--  Copyright (c) 2001 by Jan Schaumann

--  based on bbdate:
--  Copyright (c) 1998 by John Kennis
--  parts Copyright (c) 1997,1998 by Brad Hughes.

--  This program is free software; you can redistribute it and/or modify
--  it under the terms of the GNU General Public License as published by
--  the Free Software Foundation; either version 2 of the License, or
--  (at your option) any later version.
--
--  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
--  GNU General Public License for more details.
--
--  You should have received a copy of the GNU General Public License
--  along with this program; if not, write to the Free Software
--  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
--
-- (See the included file COPYING / GPL-2.0)
--

This Tool displays the current weather conditions in an decorated window,
simulating the look of the Blackbox toolbar (Blackbox is a Windowmanager for
X11).  This tool is heavily based on "bbdate" by John Kennis, almost 90% of
the code (rough guess ;) were taken over unaltered.  Furthermore, bbweather
was inspired by wmWeather by Michael G. Henderson, from where I grabbed the
perl-script that fetches the weather-conditions from your local station.

This is version 0.l Beta of bbweather, it is my first stab at a
bbtools-related application and currently does not offer many configuration
options.  In the future, other options will be included.

To use bbweather, you will need to know the station-ID of a weather-station to
grab the information from.  You can find out which stations are near you at
http://www.nws.noaa.gov/oso/siteloc.shtml

Once you determined the proper station, you need to run the perl-script
"GrabWeather" with that ID as the first command-line parameter.  Since you
probably want to stay updated on the weather conditions, you might consider
adding an entry to your crontab:

0 * * * * /path/to/GrabWeather StationID

This will create a directory called ".wmWeatherReports" in your $HOME in which
it will place the data-files.  You can then run bbweather:

bbweather StationID

If you prefer celsius over fahrenheit, pass the "-m" or the "--metric" option:

bbweather -m StationID

If you left-click on bbweather, it will display detailed weather information
in an xmessage much like wmWeather.

In the future, other options may become available that let you choose what to
display - currently bbweather displays the temperature and the relative
humidity.


Thanks to:
	John Kennis <j.m.b.m.kennis@ele.tue.nl>
		For writing bbdate, from which roughly 90% of the code for this little
		tool are.
	Michael G. Henderson <mghenderson@lanl.gov>
		For writing wmWeather, which inspired this tool, and which provided
		the perl-script to generate the weather file
	Brad Hughes  <bhughes@tcac.net>
		For writing the Blackbox Windowmanager (and with this a great deal 
		of the code for this application).
