NAMEweatherrc - configuration file format for the weather(1) utility
DESCRIPTIONThe 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.
PARAMETERSThese 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: //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: //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 FORMATThe 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.
EXAMPLESFollowing 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
AUTHORSpecification and manual written by Jeremy Stanley <email@example.com>. March 15, 2010 WEATHERRC(5)