]> git.ipfire.org Git - thirdparty/sqlalchemy/sqlalchemy.git/commitdiff
update the intro
authorMike Bayer <mike_mp@zzzcomputing.com>
Wed, 31 Oct 2012 04:55:43 +0000 (00:55 -0400)
committerMike Bayer <mike_mp@zzzcomputing.com>
Wed, 31 Oct 2012 04:55:43 +0000 (00:55 -0400)
doc/build/intro.rst
lib/sqlalchemy/orm/events.py

index 1493e2c4bf988d85915bc9064b2f86b59216f2bd..fc7e1142e93f034e628e5520e2ec5d8191e2f5cc 100644 (file)
@@ -74,11 +74,14 @@ Supported Platforms
 
 SQLAlchemy has been tested against the following platforms:
 
-* cPython since version 2.4, through the 2.xx series
+* cPython since version 2.5, through the 2.xx series
 * cPython version 3, throughout all 3.xx series
 * `Jython <http://www.jython.org/>`_ 2.5 or greater
 * `Pypy <http://pypy.org/>`_ 1.5 or greater
 
+.. versionchanged:: 0.8
+   Python 2.5 is now the minimum Python version supported.
+
 Supported Installation Methods
 -------------------------------
 
@@ -99,11 +102,6 @@ SQLAlchemy supports installation using standard Python "distutils" or
   rides on top of ``setuptools`` or ``distribute``, replacing the usage
   of ``easy_install``.  It is often preferred for its simpler mode of usage.
 
-.. note::
-
-   It is strongly recommended that either ``setuptools`` or ``distribute`` be installed.
-   Python's built-in ``distutils`` lacks many widely used installation features.
-
 Install via easy_install or pip
 -------------------------------
 
@@ -166,10 +164,10 @@ work with a non-Distribute setuptools installation.
 Installing a Database API
 ----------------------------------
 
-SQLAlchemy is designed to operate with a `DB-API
-<http://www.python.org/doc/peps/pep-0249/>`_ implementation built for a
-particular database, and includes support for the most popular databases. The
-current list is at :ref:`supported_dbapis`.
+SQLAlchemy is designed to operate with a :term:`DBAPI` implementation built for a
+particular database, and includes support for the most popular databases.
+The individual database sections in :doc:`/dialects/index` enumerate
+the available DBAPIs for each database, including external links.
 
 Checking the Installed SQLAlchemy Version
 ------------------------------------------
index 8f9680911e378a60317cad4e88b5bd1aa018873e..72c430b381e50a072b3eef23b716b33c3b5fdd7d 100644 (file)
@@ -1102,7 +1102,7 @@ class SessionEvents(event.Events):
     def after_transaction_create(self, session, transaction):
         """Execute when a new :class:`.SessionTransaction` is created.
 
-        :param session: the target :class:.`Session`.
+        :param session: the target :class:`.Session`.
         :param transaction: the target :class:`.SessionTransaction`.
 
         .. versionadded:: 0.8
@@ -1112,7 +1112,7 @@ class SessionEvents(event.Events):
     def after_transaction_end(self, session, transaction):
         """Execute when the span of a :class:`.SessionTransaction` ends.
 
-        :param session: the target :class:.`Session`.
+        :param session: the target :class:`.Session`.
         :param transaction: the target :class:`.SessionTransaction`.
 
         .. versionadded:: 0.8