NAME
weatherrc - configuration file format for the weather(1) utility
DESCRIPTION
The weatherrc file format is intended to specify a set of macros by
which to group a METAR station ID for current conditions data with a
city/state combination for a forecast, but many of the other
command-line options and flags for the weather utility can be specified
as well. The file is organized as an INI-format config, with the alias
name in [] brackets and the associated parameter/value pairs on
following lines. Parameters and their values as separated by = or :
characters. Multi-word values do not need quoting.
PARAMETERS
These parameters are supported...
alert include local alert notices
atypes alert notification types to display
aurl alert URL (including %atype% and %zone%)
city the city name (ex: Raleigh Durham)
conditions
output current conditions (possible values are False and True or
0 and 1)
flines maximum number of forecast lines to show (integer value, 0 means
unlimited)
forecast
include a local forecast (possible values are False and True or
0 and 1)
furl forecast URL (ex: http://forecast.org/%st%/%city%.txt)
headers
the conditions headers to display (ex: temperature,wind)
id the METAR station ID (ex: KRDU)
imperial
filter/convert for US/UK units
metric filter/convert for metric units
murl METAR URL (ex: http://metar.org/%id%.txt)
quiet skip preambles and don’t indent (possible values are False and
True or 0 and 1)
st the state abbreviation (ex: NC)
verbose
show full decoded feeds (possible values are False and True or 0
and 1)
zones alert zones (ex: nc/ncc183,nc/ncz041)
URL FORMAT
The placeholders %city% and %st% in the furl URL and %id% in the murl
URL will be replaced with the city, st and id definitions respectively.
If the placeholder has all letters lowercased, the replacement will be
forced to all lowercase. If the placeholder has all letters uppercased,
the replacement will be forced to all uppercase. If the placeholder has
its first letter uppercased and the remainder lowercased, then all
words in the replacement will start with an uppercase letter and the
rest will be lowercase. If the placeholder has its last letter
uppercased and the remainder lowercased, then case will be preserved in
the replacement. Also, after replacement, any spaces in the resulting
URL will be converted to underscore characters prior to use.
EXAMPLES
Following is an example ~/.weatherrc defining the default settings to
be used when running the utility with no aliases specified, and a
couple definitions for aliases named home and work...
[default]
City = Asheville
Forecast = True
ID = KAVL
St = NC
[home]
City = Raleigh Durham
ID = KRDU
St = NC
[work]
City = Greensboro
ID = KGSO
St = NC
SEE ALSO
weather(1)
AUTHOR
Specification and manual written by Jeremy Stanley <fungi@yuggoth.org>.
March 15, 2010