Imported from archive.

[weather.git] / FAQ

diff --git a/FAQ b/FAQ
index 9a26624..d8cc569 100644 (file)
--- a/FAQ
+++ b/FAQ
@@ -1,7 +1,19 @@
 FREQUENTLY ASKED QUESTIONS ABOUT THE WEATHER UTILITY
 
-Copyright (c) 2006 Jeremy Stanley <fungi@yuggoth.org>, all rights reserved.
-Licensed per terms in the LICENSE file distributed with this software.
+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.
+
+
+Table of Contents:
+
+1. Can I help?
+2. How do I figure out my local METAR station ID?
+3. How do I figure out my local city name and state abbreviation?
+4. I live outside the USA--can this be made to work for me
+   anyway?
+5. Why do I get the wrong forecast when specifying -i or --id?
 
 
 1. Can I help?
@@ -34,8 +46,10 @@ state abbreviation to get to a list of cities in that state).
 4. I live outside the USA--can this be made to work for me
 anyway?
 
-If you have any recommendations for similar forecast data in
-other countries, I will be happy to try and find a way to
+METAR station IDs can be found for cities and airports worldwide,
+but forecast data is harder to come by. If you have any
+recommendations of forecast data for other countries available in a
+format like NOAA's, I will be happy to try and find a way to
 integrate it into the weather utility, but I suspect that some
 serious modification would be necessary given that the data is
 likely to be published in a non-English language, requiring some
@@ -43,29 +57,15 @@ additional input from speakers of that language for how to handle
 filtering and formatting of the text.
 
 
-5. I get a warning when using apt-get to install on Debian Etch
-or later...
-
-If you're getting a warning from apt-get update like:
-
-   W: GPG error: http://fungi.yuggoth.org ./ Release: The
-      following signatures couldn't be verified because the
-      public key is not available: NO_PUBKEY 29ABF7441FB84657
-
-...it means my PGP key is not recognized by apt-get. Since this
-isn't an official Debian package repository, the Release.gpg
-file can't be signed by a key on the default keyring. To add my
-personal key to the list of trusted package repository Release
-signers, run (as root):
-
-   finger fungi@yuggoth.org | apt-key add -
-
-...or if you want to be a little paranoid, retrieve it from a
-public keyserver instead (all one line):
-
-   wget -O- "http://subkeys.pgp.net:11371/pks
-   /lookup?op=get&search=0x29ABF7441FB84657" | apt-key add -
-
-Though if you're really, truly paranoid, you'll re-write the
-program from scratch anyway, right?
+5. Why do I get the wrong forecast when specifying -i or --id?
 
+The -i or --id switch (or the id parameter in an alias definition),
+only tells weather(1) what current conditions to retrieve. If you
+specify -f or --forecast on the command line (or forecast=True in
+an alias) without providing a city name and state abbreviation
+(-c/--city and -s/--st, or city and st in an alias) and are seeing
+an actual forecast, then you probably have a default city and state
+abbreviation set in your config. See question 3 above for
+information on figuring out what city name and state abbreviation
+to use, and the manual for weatherrc(5) for information on defining
+aliases.