[SQL-CVS] r1486 - SQLObject/docs

[<sub...@co...>]

Author: test
Date: 2006-01-10 15:27:38 -0700 (Tue, 10 Jan 2006)
New Revision: 1486

Modified:
   SQLObject/docs/download.txt
Log:
Updated the installation/download instructions

Modified: SQLObject/docs/download.txt
===================================================================
--- SQLObject/docs/download.txt	2006-01-10 22:18:53 UTC (rev 1485)
+++ SQLObject/docs/download.txt	2006-01-10 22:27:38 UTC (rev 1486)
@@ -2,24 +2,38 @@
 ++++++++++++++++++
 
 The latest releases are always available on the `Python Cheese Shop
-<http://cheeseshop.python.org/pypi/SQLObject>`_.
+<http://cheeseshop.python.org/pypi/SQLObject>`_, and is installable
+with `easy_install
+<http://peak.telecommunity.com/DevCenter/EasyInstall>`_.
 
-* `SQLObject 0.7rc1
-  <http://cheeseshop.python.org/packages/source/S/SQLObject/SQLObject-0.7rc1.tar.gz>`_
-  (source package in ``tar.gz`` format)
+You can install the latest release with::
 
-* `0.7rc1 Python 2.4 egg
-  <http://cheeseshop.python.org/packages/2.4/S/SQLObject/SQLObject-0.7rc1-py2.4.egg>`_
-  (`easy_install-friendly
-  <http://peak.telecommunity.com/DevCenter/EasyInstall>`__ egg
-  package)
+  easy_install -U SQLObject
 
-* `0.7rc1 Python 2.3 egg
-  <http://cheeseshop.python.org/packages/2.3/S/SQLObject/SQLObject-0.7rc1-py2.3.egg>`_
-  (`easy_install-friendly
-  <http://peak.telecommunity.com/DevCenter/EasyInstall>`__ egg
-  package)
+You can install the latest version of SQLObject with::
 
+  easy_install SQLObject==dev
+
+You can install the latest bug fixing branch with::
+
+  easy_install SQLObject==bugfix
+
+If you want to require a specific revision (because, for instance, you
+need a bugfix that hasn't appeared in a release), you can put this in
+your `setuptools
+<http://peak.telecommunity.com/DevCenter/setuptools>`_ using
+``setup.py`` file::
+
+  setup(...
+    install_requires=["SQLObject==bugfix,>=0.7.1dev-r1485"],
+  )
+
+This says that you *need* revision 1485 or higher.  But it also says
+that you can aquire the "bugfix" version to try to get that.  In fact,
+when you install ``SQLObject==bugfix`` you will be installing a
+specific version, and "bugfix" is just a kind of label for a way of
+acquiring the version (it points to a branch in the repository).
+
 Repository
 ----------