Title: Installing Lamson Into Virtualenv With Pip

The best way to install Lamson in a virtualenv is using the "pip
tool":http://pip.openplans.org/ to install it. This will automatically fetch
the code from bazaar, install it inside the virtualenv and fetch any missing
dependencies.

First, if you haven't already, you'll need to install pip. Make sure 
you've activated the virtualenv:

. bin/activate

from the root of the virtualenv, and then run:

easy_install -U pip

If you have bazaar installed on your machine, then just do:

pip install -e bzr+http://bazaar.launchpad.net/~zedshaw/lamson/development/#egg lamson

This'll install the development version of lamson into a src/lamson 
directory (src/ will be created if it doesn't exist). It will also 
install all of Lamson's dependencies into the virtualenv. If you 
want to update to the latest development version of Lamson, run:

cd src/lamson
bzr pull

This will fetch the latest bazaar tip from Launchpad.

If you don't have bazaar installed and don't want to install it, you 
can grab the latest release of Lamson like this:

pip install -F http://launchpad.net/lamson/trunk/0.9-pre2/+download/lamson-0.9-pre2.tar.gz

Remember though that if you do install it like this you'll need to 
manually update it by visiting Launchpad, finding the latest tarball 
URL and `pip install`ing it.


h2. Credits

These instructions were donated to Lamson by "Zachary
Voase":http://disturbyte.github.com but "contact me":/contact.html for
suggested improvements.
