README

There should only be one running instance of this application. Please do not run it if you are not a Tor developer.

This version of Tor Weather runs on Django version 1.2. It is incompatible with
earlier versions of Django. If you are running Django v1.1, please download the
v1.1-compatible version of this package.
--------------------------------------------------------------------------------
INSTALLATION:
See /doc/INSTALL for details.

------------------------------------------------------------------------------
API:
To generate the Tor Weather API, install epydoc (http://epydoc.sourceforge.net/installing.html) and run the following command within weather: 

	$ epydoc . --config config/epydoc_config.py

Ignore the warnings; they should all pertain to Django-related documentation.
The HTML-formatted API will be in a directory named api/ in weather.

------------------------------------------------------------------------------
DESIGN DOCUMENTATION:
To generate HTML-formatted design documentation, run the following command from 
within doc/:

	$ rst2html --title="Tor Weather Design Documentation" design.txt design.html

To view the documentation, open doc/design.html. If you'd like to view the plaintext design doc instead, see doc/design.txt

-------------------------------------------------------------------------------
TESTING: (For developers)
Run the following command from within weather/:

	$ python manage.py test weatherapp

-------------------------------------------------------------------------------