Imported from archive.
[weather.git] / README
diff --git a/README b/README
index 8ed74c1..375fb08 100644 (file)
--- a/README
+++ b/README
@@ -2,35 +2,38 @@
  General Information About the Weather Utility
 ===============================================
 
  General Information About the Weather Utility
 ===============================================
 
-:Copyright: (c) 2006-2010 Jeremy Stanley <fungi@yuggoth.org>. Permission to
-            use, copy, modify, and distribute this software is granted under
-            terms provided in the LICENSE file distributed with this software.
+:Copyright: (c) 2006-2012 Jeremy Stanley <fungi@yuggoth.org>. Permission
+            to use, copy, modify, and distribute this software is
+            granted under terms provided in the LICENSE file distributed
+            with this software.
 
 .. contents::
 
 What?
 -----
 This command-line utility is intended to provide quick access to current
 
 .. contents::
 
 What?
 -----
 This command-line utility is intended to provide quick access to current
-weather conditions and forecasts. Presently, it is capable of returning data
-for localities throughout the USA by retrieving and formatting decoded METARs
-(Meteorological Aerodrome Reports) from NOAA (the USA National Oceanic and
-Atmospheric Administration) and forecasts from NWS (the USA National Weather
+weather conditions and forecasts. Presently, it is capable of returning
+data for localities throughout the USA and some select locations
+globally by retrieving and formatting decoded METARs (Meteorological
+Aerodrome Reports) from NOAA (the USA National Oceanic and Atmospheric
+Administration) and forecasts/alerts from NWS (the USA National Weather
 Service). The tool is written to function in the same spirit as other
 Service). The tool is written to function in the same spirit as other
-command-line informational utilities like cal(1), calendar(1) and dict(1). It
-can retrieve arbitrary weather data via specific command-line switches (station
-ID, city, state), or aliases can be configured system wide and on a per-user
-basis. It can be freely used and redistributed under the terms of a BSD-like
-License.
+command-line informational utilities like cal(1), calendar(1) and
+dict(1). It retrieves arbitrary weather data via precompiled
+correlations or custom-tailored aliases (system-wide or on a per-user
+basis). It can be freely used and redistributed under the terms of a
+BSD-like License.
 
 Why?
 ----
 
 Why?
 ----
-My girlfriend had a long commute to/from work and school, and often wanted to
-check the weather both for home and her office. Unfortunately, starting a Web
-browser, pulling up a weather site, entering multiple ZIP codes and waiting for
-them to load is time-consuming for the marginally-impatient. Since she tended
-to stay logged into a shell server most of the time, I figured I'd install a
-quick command-line tool to retrieve weather info for her commute, but to my
-surprise, a quick search turned up little that met my basic requirements:
+My girlfriend had a long commute to/from work and school, and often
+wanted to check the weather both for home and her office. Unfortunately,
+starting a Web browser, pulling up a weather site, entering multiple ZIP
+codes and waiting for them to load is time-consuming for the
+marginally-impatient. Since she tended to stay logged into a shell
+server most of the time, I figured I'd install a quick command-line tool
+to retrieve weather info for her commute. To my surprise, a quick search
+turned up little that met my basic requirements:
 
  * retrieve current data on-demand
  * provide both current conditions and short-term forecasts
 
  * retrieve current data on-demand
  * provide both current conditions and short-term forecasts
@@ -40,9 +43,10 @@ surprise, a quick search turned up little that met my basic requirements:
 
 Where?
 ------
 
 Where?
 ------
-A tarball for the most recent version of the weather utility can be had here:
+A tarball for the most recent version of the weather utility can be had
+here:
 
  * http://fungi.yuggoth.org/weather/src/
 
 
  * http://fungi.yuggoth.org/weather/src/
 
-Alternatively, Debian and Ubuntu users can install the weather-util package
-from any mirror.
+Alternatively, Debian and Ubuntu users can install the weather-util
+package from any mirror.