Imported from archive.

[weather.git] / weatherrc.5

diff --git a/weatherrc.5 b/weatherrc.5
index 987ec34..e5be871 100644 (file)
--- a/weatherrc.5
+++ b/weatherrc.5
@@ -1,6 +1,8 @@
-.TH WEATHERRC 5 "March 26, 2006" "" \" -*- nroff -*-
-\" Copyright (c) 2006 Jeremy Stanley <fungi@yuggoth.org>, all rights reserved.
-\" Licensed per terms in the LICENSE file distributed with this software.
+.TH WEATHERRC 5 "July 13, 2008" "" \" -*- nroff -*-
+\" Copyright (c) 2006-2008 Jeremy Stanley <fungi@yuggoth.org>.
+\" Permission to use, copy, modify, and distribute this software is
+\" granted under terms provided in the LICENSE file distributed with
+\" this software.
 .SH NAME
 weatherrc \- configuration file format for the
 .BR weather (1)
@@ -20,20 +22,47 @@ These parameters are supported...
 .B city
 the city name (ex: Raleigh Durham)
 .TP
+.B conditions
+output current conditions (possible values are False and True or 0 and 1)
+.TP
+.B flines
+maximum number of forecast lines to show (integer value, 0 means unlimited)
+.TP
 .B forecast
 include a local forecast (possible values are False and True or 0 and 1)
 .TP
+.B furl
+forecast URL (ex: http://forecast.org/%st%/%city%.txt)
+.TP
+.B headers
+the conditions headers to display (ex: temperature,wind)
+.TP
 .B id
 the METAR station ID (ex: KRDU)
 .TP
-.B conditions
-output current conditions (possible values are False and True or 0 and 1)
+.B murl
+METAR URL (ex: http://metar.org/%id%.txt)
+.TP
+.B quiet
+skip preambles and don't indent (possible values are False and True or 0 and 1)
 .TP
 .B st
 the state abbreviation (ex: NC)
 .TP
 .B verbose
 show full decoded feeds (possible values are False and True or 0 and 1)
+.SH 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.
 .SH EXAMPLES
 Following is an example
 .B ~/.weatherrc