Imported from archive.

* Release 1.4.

* (all): Updated the copyright years for 2008 on some of the files
in the current release and added a copyright statement to any files
previously lacking one.

* LICENSE: Replaced the previous BSD-like license with the one used
by the OpenBSD project (modeled after the Internet Software
Consortium's, a two-clause BSD license removing language made
unnecessary by the Berne convention); this new license is
functionally identical to the old one, just more terse and openly
recognized.

* weather: Clarified function parameters in calls from the wrapper
script to ease future ABI changes in the underlying module.

* weather, weather.py: Some extra comments were added to the source,
indentation style was updated from tab characters to three-space,
and lines longer than 79 columns were refactored or otherwise split.

* weather.1, weather.5, weather.py: Added an flines option to allow
the maximum number of forecast output lines to be shortened. Added
furl and murl options to allow overriding of the default current
conditions and forecast data retrieval URLs. Added a headers option
to allow overriding the default list of header names for current
conditions data filtering. Added a quiet option to suppress the
preamble lines and indentation for both current conditions and
forecast output.

* weather.py: Replaced the hardcoded fallback default METAR station
ID and forecast city/state abbreviation with error messages to
minimize confusion when necessary values are omitted. Adjusted a
couple of hard-coded error message strings to be consistent with the
output format of the option_parser module. Switched from urllib to
urllib2 for retrieving data, providing a simpler means to detect and
report retrieval errors. Upped the version to 1.4.
This commit is contained in:
Jeremy Stanley
2008-07-13 07:49:02 +00:00
parent eb249a0ae2
commit 8349654b7c
9 changed files with 434 additions and 263 deletions

View File

@@ -1,6 +1,8 @@
.TH WEATHER 1 "March 26, 2006" "" \" -*- nroff -*-
\" Copyright (c) 2006 Jeremy Stanley <fungi@yuggoth.org>, all rights reserved.
\" Licensed per terms in the LICENSE file distributed with this software.
.TH WEATHER 1 "July 13, 2008" "" \" -*- nroff -*-
\" Copyright (c) 2006-2008 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.
.SH NAME
weather \- command\-line tool to obtain weather conditions and forecasts
.SH SYNOPSIS
@@ -30,26 +32,41 @@ show a help message and exit
.B \-cCITY, \-\-city=CITY
the city name (ex: "Raleigh Durham")
.TP
.B \-\-flines=FLINES
maximum number of forecast lines to show
.TP
.B \-f, \-\-forecast
include a local forecast
.TP
.B \-\-furl=FURL
forecast URL (including %city% and %st%)
.TP
.B \-\-headers=HEADERS
the conditions headers to display
.TP
.B \-iID, \-\-id=ID
the METAR station ID (ex: KRDU)
.TP
.B \-l, \-\-list
print a list of configured aliases
.TP
.B \-\-murl=MURL
METAR URL (including %id%)
.TP
.B \-n, \-\-no\-conditions
disable output of current conditions (forces \-f)
.TP
.B \-o, \-\-omit\-forecast
omit the local forecast (cancels \-f)
.TP
.B \-\-quiet
skip preambles and don't indent
.TP
.B \-sST, \-\-st=ST
the state abbreviation (ex: NC)
.TP
.B \-v, \-\-verbose
show full decoded feeds
show full decoded feeds (cancels \-q)
.SH FILES
.B weather
may additionally obtain configuration data from a system\-wide