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

NAME

       weather - command-line tool to obtain weather conditions and forecasts

SYNOPSIS

       weather [ options ] [ alias [ alias [...] ] ]

DESCRIPTION

       This  utility  is  intended  to provide quick access to current weather
       conditions and forecasts. Presently, it is capable  of  providing  data
       for  localities  throughout  the United States of America by retrieving
       and processing METAR data from the  National  Oceanic  and  Atmospheric
       Administration   and  forecasts  from  the  National  Weather  Service.
       Behavior can be determined by command-line options and specification of
       zero  or  more  aliases.  Aliases  are defined in weatherrc files, as a
       convenient means of grouping option combinations together using a short
       name.   Specifying  multiple  aliases  on  the  command line causes the
       utility to output data for each, as if it  had  been  invoked  multiple
       times.  If  no  alias  is specified, then an alias of "default" is used
       (assuming it has been defined)  or  the  built-in  default  values  are
       chosen (if it has not).

OPTIONS

       A summary of options is included below.

       --version
              show program's version number and exit

       -h, --help
              show a help message and exit

       -a, --alert
              include local alert notices

       --atypes=ATYPES
              alert notification types to display

       --aurl=AURL
              alert URL (including %atype% and %zone%)

       -c CITY, --city=CITY
              the city name (ex: "Raleigh Durham")

       --flines=FLINES
              maximum number of forecast lines to show

       -f, --forecast
              include a local forecast

       --furl=FURL
              forecast URL (including %city% and %st%)

       --headers=HEADERS
              the conditions headers to display

       -i ID, --id=ID
              the METAR station ID (ex: KRDU)

       --imperial
              filter/convert for US/UK units

       -l, --list
              print a list of configured aliases

       -m, --metric
              filter/convert for metric units

       --murl=MURL
              METAR URL (including %id%)

       -n, --no-conditions
              disable output of current conditions (forces -f)

       -o, --omit-forecast
              omit the local forecast (cancels -f)

       --quiet
              skip preambles and don't indent

       -s ST, --st=ST
              the state abbreviation (ex: NC)

       -v, --verbose
              show full decoded feeds (cancels -q)

       -z ZONES, --zones=ZONES
              alert zones (ex: nc/ncc183,nc/ncz041)

FILES

       weather  may  additionally obtain configuration data from a system-wide
       configuration  file,  a  per-user  configuration  file,  and  a   local
       directory configuration file. The file format and configuration options
       are described in weatherrc(5).  They are aggregated  in  the  following
       order:

       /etc/weatherrc
              the system-wide configuration

       ~/.weatherrc
              the per-user configuration (can be used to override the above)

       ./weatherrc
              the  local  directory configuration (can be used to override the
              above)

EXAMPLES

       weather
              View output for the  defined  default  alias,  or  the  built-in
              default  values  if  there  is  no  default alias defined in the
              configuration files.

       weather -i kavl
              Display current conditions at the KAVL METAR station.

       weather -n -c asheville -s nc
              See a forecast for the Asheville, NC area.

       weather -fv gso
              Get the full decoded METAR for the station associated  with  the
              gso  alias,  and the forecast data for the city/state associated
              with the gso alias, without filtering or fancy formatting.

       weather home work
              Show current conditions for both the home and  work  aliases  in
              that order.

SEE ALSO

       weatherrc(5)

AUTHOR

       Utility and manual written by Jeremy Stanley <fungi@yuggoth.org>.

                                March 15, 2010                      WEATHER(1)