Prerequisites
---------------------------------------------------------------------------

* Python >= 2.4 (http://python.org/)
* urlgrabber >= 3.1.0 (http://linux.duke.edu/projects/urlgrabber/)
* feedparser >= 4.1 (http://www.feedparser.org/)
* newt >= 0.51 (https://fedorahosted.org/newt/)
* pycrypto >= 2.0.1 (http://www.amk.ca/python/code/crypto/)

NOTE: clive can still run without the following modules:
    * sqlite3 (new in Python 2.5)
        - if not found, all URL cache features are disabled
    * newt
        - if not found, all newt req. features are disabled
    * feedparser
        - if not found, feed parsing is disabled
    * pycrypto
        - if not found, all encrypted login password features are disabled


Installation: All POSIX (Linux/BSD/UNIX-like OSes)
---------------------------------------------------------------------------

Typically:
    % tar xvjf clive-$release.tar.bz2
    % cd clive-$release
    % ./configure
As root:    
    % make install

FreeBSD:
    % cd /usr/ports/lang/python25 && make install clean
    % cd /usr/ports/databases/py-sqlite3 && make install clean
    % cd /usr/ports/www/py-urlgrabber && make install clean
    % cd /usr/ports/textproc/py-feedparser && make install clean
    % cd /usr/ports/devel/libslang && make config (enable UTF8) && make install
    % cd /usr/ports/devel/newt && make WITH_PYTHON=yes install clean
    % cd /usr/ports/www/py-urlgrabber && make install clean
    % cd /usr/ports/security/py-pycrypto && make install clean

Debian/Ubuntu:
    % sudo apt-get install python python-urlgrabber \
        python-feedparser python-newt python-crypto


Without installing
---------------------------------------------------------------------------

Assuming the tarball has been extracted and the prerequisite modules
have already been installed:
    % ./build.py

The above builds the binaries to $top_srcdir/dist subdir. After this,
you can call "run.py" as you would normally call "clive":
    % ./run.py [OPTION].. [URL]..
For example:
    % ./run.py -NC URL

If you are making any changes to the source code, be sure to:
    % make install
And after this run the program again by calling "run.py".


Troubleshooting: ImportError: No module named clive.main
---------------------------------------------------------------------------

If clive returns this error after installation, make sure the environment
variable PYTHONPATH points to the proper site-packages directory,
for example:
    /usr/local/lib/python2.5/site-packages

Note that this may also be an indication of improper use of the --prefix
and/or invalid Python installation.
