weatherrc(5)

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...

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)

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)

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>.

July 13, 2008 WEATHERRC(5)