Provided by: weather-util_1.4-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...

       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)