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
-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
-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?
----
-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
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/
-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.
projects / weather.git / blobdiff