             /^^\                          
       /^^^^     ^^\                      /^^^^^^^\
  /^^^^             ^^^^^\            /^^^         ^^^^^^^^\
 |    XWinWeather 1.0.0   |       /^^^                      ^^^\
  \______________________/       |  Copyright 1998 by           |
                                 |            Kevin MacDonald   |
                                 |  kmacdo01@student.vill.edu   |
                                  \____________________________/


___________________________________________________________________________
INTRODUCTION

XWinWeather gives you a graphical way of obtaining the weather for up to
30 cities.  It automatically updates itself every 30 minutes, and it is
easy to configure to work with several cities. 

___________________________________________________________________________
REQUIREMENTS

This being the source version, you will need to download and install the
qt development library from www.troll.no.  You also need to have g++ or
some other c++ compiler.  gcc should work, although it has not been
tested.

___________________________________________________________________________
INSTALLATION

First, you will have to untar tmake, which is in this
directory, and build it.  Once you have done the stuff above, you will have to 
untar QdbtTabular-0.31 which is also in this directory and use tmake to
make the library.   

Next, you will have to change things in the Makefile to point to the
correct directories such as the QTDIR (qt library directory) and the
QDBTDIR (qdbttabular directory).  I have some defaults set that should
work provided you use the standard installation procedures for both qt and
QdbtTabular. After this you will have to add the qt library to your
LD_LIBRARY_PATH using a command like:
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/qt/lib

then do the same thing with the QdbtTabular library with something like:

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/path/to/QdbtTabular/lib


After this go ahead and type:
 
make;make install 

to make the file and install it intstall in the INSTALLDIR in the
Makefile.

To use it you will have to have the LD_LIBRARY_PATHS set like they are
above, and then just type xweath.

__________________________________________________________________________
USAGE

The usage is pretty straight-forward.  Type xweath to run the program.  
If you want to update immediately, right click and do an Update Now.
Otherwise the weather will automatically update itself every half hour.

If you would like to see a detailed, extended forecast, double-click on
the row that you would like to see the forcast for.

If you want to change what cities are viewed, right click and go to
Add/Remove cities, and when you're finished click done, at that point it
will automatically update all of the cities.

___________________________________________________________________________
This program is free software; you can redistribute it under the terms of
the GNU Gereral Public License as published by the Free Software
Foundation.

This program is distributed with hopes 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 Gerneral Public License for
more details.

You can receive a copy of the GNU General Public License by writing to the
Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139 USA.
