README for PHP Weather
Copyright (C) 2000--2002 Martin Geisler <gimpster@gimpster.com>
Licensed under the GNU GPL. See the file COPYING for details.


What is PHP Weather?
--------------------

PHP Weather is designed to make it easy for you to show the current
weather on your webpage. All over the world airports make a so-called
METAR-report once an hour. A METAR report is an aviation weather
report to be used primarily by airplanes. The report contains data, in
a shorthand form, about temperature, wind speed and direction,
cloud-coverage and much more. PHP Weather converts this format into
both empirical and metric units, caches the data in an XML file or a
MySQL, Postgres, Oracle 8, or DBM database for fast retrieval, and
makes easy availably in PHP scripts.


Installation
------------

See the file INSTALL for instructions on installation of PHP Weather
on your webserver.

Features
--------
Here is a list of the features PHP Weather provides:

  o Shows the current weather in natual language.
  o Supports several languages. If you language isn't there, then
    please write a translation.
  o Displays matching icons for the most common weather phenomena.
  o Caches the result to increase performance.
  o Can be use with WAP-phones. Example-page included.

Please see http://phpweather.net/docs/1.x/index.php for full details
and examples.


How to report problems
----------------------

If you encounter problems with PHP Weather, or just want to suggest a
new feature, then please don't hesitate to submit a new bug report or
feature request at SourceForge:

  http://sourceforge.net/tracker/?group_id=23245

You can also join the mailinglist and ask questions there:

  <phpweather-devel@lists.sourceforge.net>

You have to be subscribed to be able to post messages to it. To
subscribe, go to this page:

  http://lists.sourceforge.net/lists/listinfo/phpweather-devel

Please remember to include the METAR (the raw, coded weather report)
you're having problems with when you send a message. Without it, we
can't really help you.

You can always get the newest version at

  http://www.sourceforge.net/projects/phpweather/

Enjoy! - Martin Geisler <gimpster@gimpster.com>
