#####
Intro
#####

==============================
Version and development status
==============================
You may have been surprised by the version number of httpforge. It does not
follow the usual scheme: 1.0 beta, 1.0, 1.1, etc. Instead, versions are
numbered with the release date: YY-mm-dd. For example, the current version is
11.02.01. Removing the notion of "beta", "realease candidate" et al. allows me
to focus on features and improvement instead of version naming.

So how could you know which version to use ? Use the latest, or your favorite
one... Simply avoid the ones that are known to have bugs.

If you wish to know the version of the installed httpforge, use the -v
option on any script::

  > httpforge -v
  11.02.01

==========
Installing
==========

Using setup.py
--------------
Download the distribution from the
`Python Package Index <http://pypi.python.org/pypi/httpforge/>`_, extract it and
go to the created directory (named httpforge-YY-mm-dd). Then run, as root,
the setup script::

  > python setup.py install

Using easy_install
------------------
::

  easy_install httpforge

==============
About this doc
==============
I'm trying to make this documentation as accurate as possible. Still, errors
may appear. If you spot one, or if you think something is missing or could
be improved, please tell me at
`a.dotreppe@aspyct.org <mailto:a.dotreppe@aspyct.org>`_.