Imported from archive.
[weather.git] / FAQ
1 FREQUENTLY ASKED QUESTIONS ABOUT THE WEATHER UTILITY
2
3 Copyright (c) 2006 Jeremy Stanley <fungi@yuggoth.org>, all rights reserved.
4 Licensed per terms in the LICENSE file distributed with this software.
5
6
7 Table of Contents:
8
9 1. Can I help?
10 2. How do I figure out my local METAR station ID?
11 3. How do I figure out my local city name and state abbreviation?
12 4. I live outside the USA--can this be made to work for me
13    anyway?
14 5. Why do I get the wrong forecast when specifying -i or --id?
15
16
17 1. Can I help?
18  
19 Sure! Bug reports and feature suggestions are always welcome, but
20 fixes and patches are of course preferred. Contact
21 fungi@yuggoth.org if desired, but please read this FAQ and the
22 included manuals for weather(1) and weatherrc(5) before asking
23 questions that might be answered therein. One big way anyone can
24 help is to provide me with some additional mappings of METAR
25 station ID, city name and state abbreviation for inclusion in the
26 default /etc/weatherrc file.
27
28
29 2. How do I figure out my local METAR station ID?
30
31 The list of stations is found at
32 http://weather.noaa.gov/data/nsd_cccc.gz (it's thousands of lines
33 long, so I recommend keyword searching in your browser or using
34 grep(1) to find what you're looking for).
35
36
37 3. How do I figure out my local city name and state abbreviation?
38
39 The forecasts can be located starting from
40 http://weather.noaa.gov/pub/data/forecasts/city/ (choose the
41 state abbreviation to get to a list of cities in that state).
42
43
44 4. I live outside the USA--can this be made to work for me
45 anyway?
46
47 If you have any recommendations for similar forecast data in
48 other countries, I will be happy to try and find a way to
49 integrate it into the weather utility, but I suspect that some
50 serious modification would be necessary given that the data is
51 likely to be published in a non-English language, requiring some
52 additional input from speakers of that language for how to handle
53 filtering and formatting of the text.
54
55
56 5. Why do I get the wrong forecast when specifying -i or --id?
57
58 The -i or --id switch (or the id parameter in an alias definition),
59 only tells weather(1) what current conditions to retrieve. If you
60 specify -f or --forecast on the command line (or forecast=True in
61 an alias) without providing a city name and state abbreviation
62 (-c/--city and -s/--st, or city and st in an alias), you will
63 instead see the forecast for the built-in default location (or the
64 city and st defined in the default alias, if you have one). See
65 question 3 above for information on figuring out what city name and
66 state abbreviation to use, and the manual for weatherrc(5) for
67 information on defining aliases.
68