Salastil/weather
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Imported from archive.

Browse Source 
* Release 1.5.

* (all): Updated copyright notices for 2010.

* FAQ, INSTALL, LICENSE, README: Reformatted as ReStructuredText.

* FAQ: Updated to mention alternative sources for NOAA's stations
list, in case the recommended one is unavailable (thanks Celejar!).

* NEWS: Renamed to ChangeLog and refactored into GNU format.

* weather: Added some comment padding between the shebang line and
the copyright, so that distributions wishing to carry patches which
modify the interpreter path don't have to refresh them every year
when the copyright line changes in their context.

* weather, weather.1, weatherrc.5, weather.py: Added experimental
alert, atypes, aurl and zones options to support retrieval,
filtering and formatting of unexpired NWS severe weather advisories.

* weather.1, weatherrc.5: Minor cosmetic fixes to option
descriptions.

* weather.1, weatherrc.5, weather.py: Added imperial and metric
options to filter/convert display units (thanks to Andrew Carter for
this suggestion!).

* weather.py: Fixed a METAR parsing error which would trigger an
IndexError exception if the NWS didn't have a station description on
file (thanks to Celejar for reporting the bug!). Fixed METAR title
line parsing to look for human-readable city and state in the first
line--previous code stopped showing the city name after NWS made
slight format mods. Upped the version to 1.5.

* weatherrc: Additional PIE (Saint Petersburg, FL), PNC (Ponca City,
OK), and PNS (Pensacola, FL) aliases.
This commit is contained in:
Jeremy Stanley
2010-03-19 13:30:22 +00:00
parent 8349654b7c
commit 4d25a49d5a
9 changed files with 522 additions and 197 deletions
Download Patch File Download Diff File Expand all files Collapse all files

79
INSTALL
View File

@@ -1,28 +1,28 @@
BASIC UNIX INSTALLATION INSTRUCTIONS FOR THE WEATHER UTILITY
==============================================================
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.
:Copyright: (c) 2006-2010 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.
.. contents::
PREREQUISITES
Prerequisites
-------------
You need the Python interpreter installed somewhere in your path (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).
You need the Python interpreter installed somewhere in your path
(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:
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
cd weather-*
./weather --version
./weather --help
man ./weather.1
@@ -30,30 +30,27 @@ resulting directory:
./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.
...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
The file named weather should be made executable and put somewhere
in your path (/usr/local/bin/ or ~/bin/ for example). Similarly,
weather.py needs to be somewhere in Python's include path. You can
see your Python interpreter's default include path by running:
Installing the Utility
----------------------
The file named weather should be made executable and put somewhere in your path
(/usr/local/bin/ or ~/bin/ for example). Similarly, weather.py needs to be
somewhere in Python's include path. You can see your Python interpreter's
default include path by running::
python -c "import sys ; print sys.path"
Configuration
-------------
The weatherrc file should go in /etc/ or you can save it in your home directory
as a dotfile (~/.weatherrc) to support user-specific alias configuration and
overrides of the global /etc/weatherrc file.
CONFIGURATION
The weatherrc file should go in /etc/ or you can save it in your
home directory as a dotfile (~/.weatherrc) to support user-specific
alias configuration and overrides of the global /etc/weatherrc file.
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/).
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/).