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)