**********************************************************************
NOTE: 2009-10-27 -- there have been reports of easy_install trying
to pull Cheetah 2.4.0 and failing.  If this occurs, download and
install version 2.2.2 (which is the current stable version):
 
http://pypi.python.org/packages/source/C/Cheetah/Cheetah-2.2.2.tar.gz#md5=e0d89113ab6bb0935d2b67395960264c
**********************************************************************
 
One-time setup for python:
 
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Unix (including cygwin):
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
1. Check to see if setuptools is installed.
    Execute this command:
        which easy_install
    
    If it returns something, it's installed skip to step #3.
 
 
2. Install Setup Tools:
    Extract the archive in ext and install the package
    sudo python setup.py install (no sudo needed for cygwin or windows)
 
    setuptools
        cd ext
        tar xfvz setuptools-0.6c9.tar.gz
        cd setuptools-0.6c9
        sudo python setup.py install
 
3. Install the dependencies
 
    easy_install pygments
    easy_install Cheetah
    easy_install simplejson
 
 
4. Make a copy of yuidoc/bin/example.sh and modify the paths to suit your needs.
 
 
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
DOS/Windows:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
1. Install Python
 
  * Use Python 2.4.3 as 2.5 generates warnings because the json parser has 
    not been updated yet:
 
        http://www.python.org/ftp/python/2.4.3/python-2.4.3.msi
 
  * Extract each of the archives with WinZIP and install as described in 
    the unix section.
 
  * Copy _namemapper.pyd to C:\Python24\Lib\site-packages\Cheetah
 
 
2,3. Same as above 
 
4. Add C:\python24 to your PATH
 
5. Copy yuidoc\bin\example.bat and modify the paths to suit your needs
 
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
See TAGS for a brief description of the supported tags.  Checking out the
source for the YUI library is a good way to get to know how it works. Ex:
http://developer.yahoo.com/yui/docs/Event.js.html
 
NOTE: This tool will generally work with code that has been commented for
jsdoc, with one exception:  you must have at least one @module block defined
somewhere in your source.  If you don't, the program will run but won't
generate anything.