Imported from archive.

* Initial release 1.0.

weather.1

@@ -0,0 +1,87 @@
+.TH WEATHER 1 "March 26, 2006"
+.SH NAME
+weather \- command\-line tool to obtain weather conditions and forecasts
+.SH SYNOPSIS
+.B weather [ options ] [ alias [ alias [...] ] ]
+.SH 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).
+.SH OPTIONS
+A summary of options is included below.
+.TP
+.B \-\-version
+show program's version number and exit
+.TP
+.B \-h, \-\-help
+show a help message and exit
+.TP
+.B \-cCITY, \-\-city=CITY
+the city name (ex: "Raleigh Durham")
+.TP
+.B \-f, \-\-forecast
+include a local forecast
+.TP
+.B \-iID, \-\-id=ID
+the METAR station ID (ex: KRDU)
+.TP
+.B \-l, \-\-list
+print a list of configured aliases
+.TP
+.B \-n, \-\-no\-conditions
+disable output of current conditions (implies \-\-forecast)
+.TP
+.B \-sST, \-\-st=ST
+the state abbreviation (ex: NC)
+.TP
+.B \-v, \-\-verbose
+show full decoded feeds
+.SH FILES
+.B 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
+.BR weatherrc (5) .
+They are aggregated in the following order:
+.TP
+.B /etc/weatherrc
+the system\-wide configuration
+.TP
+.B ~/.weatherrc
+the per\-user configuration (can be used to override the above)
+.TP
+.B ./.weatherrc
+the local directory configuration (can be used to override the above)
+.SH EXAMPLES
+.TP
+.B 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.
+.TP
+.B weather -i kavl
+Display current conditions at the KAVL METAR station.
+.TP
+.B weather -n -c asheville -s nc
+See a forecast for the Asheville, NC area.
+.TP
+.B 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.
+.TP
+.B weather home work
+Show current conditions for both the home and work aliases in that order.
+.SH SEE ALSO
+.BR weatherrc (5)
+.SH AUTHOR
+Utility and manual written by Jeremy Stanley <fungi@yuggoth.org>.