X-Git-Url: https://www.yuggoth.org/gitweb?p=weather.git;a=blobdiff_plain;f=INSTALL;h=da831b6dbd34bd424152fb79371d61c6c2a6ba6d;hp=91809039f1af4e052363077905039a75a9af5277;hb=8349654b7c627448b1e56c2943234895724d7857;hpb=155d8574dfe4715cdf1e62afcc95cf8b871bf0e7

diff --git a/INSTALL b/INSTALL
index 9180903..da831b6 100644
--- a/INSTALL
+++ b/INSTALL
@@ -1,17 +1,38 @@
 BASIC UNIX INSTALLATION INSTRUCTIONS FOR THE WEATHER UTILITY
 
+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.
+
 
 PREREQUISITES
 
 You need the Python interpreter installed somewhere in your path
-(most modern UNIX derivatives come with one already). The weather
-executable assumes your Python interpreter is /usr/bin/python so you
-may need to edit the #! line if that is not the case. If you need
-Python for some reason, it can be obtained from
-http://www.python.org/ (but chances are your operating system at
-least provides some sort of native package for it, which you should
-probably install in whatever means is recommended by your OS
-vendor/distributor).
+(most modern UNIX derivatives come with one already). If you need to
+get Python, it can be obtained from http://www.python.org/ (but
+chances are your operating system at least provides some sort of
+native package for it, which you should probably install in whatever
+means is recommended by your OS vendor/distributor).
+
+
+RUNNING IN PLACE
+
+An easy way to try it out is to unpack the tarball and change to the
+resulting directory:
+
+   tar xzf weather-*.tar.gz
+   cd weather
+   ./weather --version
+   ./weather --help
+   man ./weather.1
+   man ./weatherrc.5
+   ./weather --forecast --no-conditions --city=charlotte --st=nc
+   ./weather ord sea
+
+...and so on. The weather utility, included Python module and
+documentation are all fully functional when kept together in one
+directory, if somewhat inconvenient.
 
 
 INSTALLING THE UTILITY
@@ -36,4 +57,3 @@ MANUALS
 Optionally, the weather.1 and weatherrc.5 files can be placed in
 sane locations for TROFF/NROFF manual files on your system (for
 example, /usr/local/share/man/ or ~/man/).
-