Provided by: weather-util_1.5-1_all bug

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                             WEATHERRC(5)