Imported from archive.
[weather.git] / INSTALL
1 BASIC UNIX INSTALLATION INSTRUCTIONS FOR THE WEATHER UTILITY
2
3
4 PREREQUISITES
5
6 You need the Python interpreter installed somewhere in your path
7 (most modern UNIX derivatives come with one already). The weather
8 executable assumes your Python interpreter is /usr/bin/python so you
9 may need to edit the #! line if that is not the case. If you need
10 Python for some reason, it can be obtained from
11 http://www.python.org/ (but chances are your operating system at
12 least provides some sort of native package for it, which you should
13 probably install in whatever means is recommended by your OS
14 vendor/distributor).
15
16
17 INSTALLING THE UTILITY
18
19 The file named weather should be made executable and put somewhere
20 in your path (/usr/local/bin/ or ~/bin/ for example). Similarly,
21 weather.py needs to be somewhere in Python's include path. You can
22 see your Python interpreter's default include path by running:
23
24    python -c "import sys ; print sys.path"
25
26
27 CONFIGURATION
28
29 The weatherrc file should go in /etc/ or you can save it in your
30 home directory as a dotfile (~/.weatherrc) to support user-specific
31 alias configuration and overrides of the global /etc/weatherrc file.
32
33
34 MANUALS
35
36 Optionally, the weather.1 and weatherrc.5 files can be placed in
37 sane locations for TROFF/NROFF manual files on your system (for
38 example, /usr/local/share/man/ or ~/man/).
39