8 files changed, 43 insertions, 5 deletions
diff --git a/lib/sqlalchemy/dialects/mysql/base.py b/lib/sqlalchemy/dialects/mysql/base.py
index acb5671ca..7f67d7826 100644
--- a/lib/sqlalchemy/dialects/mysql/base.py
+++ b/lib/sqlalchemy/dialects/mysql/base.py
@@ -6,6 +6,26 @@
 
 """Support for the MySQL database.
 
+DBAPI Support
+-------------
+
+The following dialect/driver options are available:
+
+* :ref:`mysqldb`
+
+* :ref:`mysqlconnector`
+
+* :ref:`oursql`
+
+* :ref:`gaerdbms`
+
+* :ref:`pymysql`
+
+* :ref:`mysql_pyodbc`
+
+* :ref:`mysql_zxjdbc`
+
+
 Supported Versions and Features
 -------------------------------
 
diff --git a/lib/sqlalchemy/dialects/mysql/gaerdbms.py b/lib/sqlalchemy/dialects/mysql/gaerdbms.py
index a56d4b791..29a67a540 100644
--- a/lib/sqlalchemy/dialects/mysql/gaerdbms.py
+++ b/lib/sqlalchemy/dialects/mysql/gaerdbms.py
@@ -10,6 +10,11 @@ changes.
 
 .. versionadded:: 0.7.8
 
+DBAPI
+-----
+
+    https://developers.google.com/appengine/docs/python/cloud-sql/developers-guide
+
 Connecting
 ----------
 
diff --git a/lib/sqlalchemy/dialects/mysql/mysqlconnector.py b/lib/sqlalchemy/dialects/mysql/mysqlconnector.py
index 104d5330a..ea8d9322c 100644
--- a/lib/sqlalchemy/dialects/mysql/mysqlconnector.py
+++ b/lib/sqlalchemy/dialects/mysql/mysqlconnector.py
@@ -6,6 +6,9 @@
 
 """Support for the MySQL database via the MySQL Connector/Python adapter.
 
+DBAPI
+-----
+
 MySQL Connector/Python is available at:
 
     https://launchpad.net/myconnpy
diff --git a/lib/sqlalchemy/dialects/mysql/mysqldb.py b/lib/sqlalchemy/dialects/mysql/mysqldb.py
index 21b87a018..add0c00ee 100644
--- a/lib/sqlalchemy/dialects/mysql/mysqldb.py
+++ b/lib/sqlalchemy/dialects/mysql/mysqldb.py
@@ -6,12 +6,13 @@
 
 """Support for the MySQL database via the MySQL-python adapter.
 
+DBAPI
+-----
+
 MySQL-Python is available at:
 
     http://sourceforge.net/projects/mysql-python
 
-At least version 1.2.1 or 1.2.2 should be used.
-
 Connecting
 -----------
 
diff --git a/lib/sqlalchemy/dialects/mysql/oursql.py b/lib/sqlalchemy/dialects/mysql/oursql.py
index 1be3f3b2a..ca713a068 100644
--- a/lib/sqlalchemy/dialects/mysql/oursql.py
+++ b/lib/sqlalchemy/dialects/mysql/oursql.py
@@ -6,6 +6,9 @@
 
 """Support for the MySQL database via the oursql adapter.
 
+DBAPI
+-----
+
 OurSQL is available at:
 
     http://packages.python.org/oursql/
diff --git a/lib/sqlalchemy/dialects/mysql/pymysql.py b/lib/sqlalchemy/dialects/mysql/pymysql.py
index 71548880c..b6f2d4384 100644
--- a/lib/sqlalchemy/dialects/mysql/pymysql.py
+++ b/lib/sqlalchemy/dialects/mysql/pymysql.py
@@ -6,6 +6,9 @@
 
 """Support for the MySQL database via the pymysql adapter.
 
+DBAPI
+-----
+
 pymysql is available at:
 
     http://code.google.com/p/pymysql/
diff --git a/lib/sqlalchemy/dialects/mysql/pyodbc.py b/lib/sqlalchemy/dialects/mysql/pyodbc.py
index 03906f8c9..20cc53be7 100644
--- a/lib/sqlalchemy/dialects/mysql/pyodbc.py
+++ b/lib/sqlalchemy/dialects/mysql/pyodbc.py
@@ -6,6 +6,9 @@
 
 """Support for the MySQL database via the pyodbc adapter.
 
+DBAPI
+-----
+
 pyodbc is available at:
 
     http://pypi.python.org/pypi/pyodbc/
diff --git a/lib/sqlalchemy/dialects/mysql/zxjdbc.py b/lib/sqlalchemy/dialects/mysql/zxjdbc.py
index d25444cd0..82e7dca8d 100644
--- a/lib/sqlalchemy/dialects/mysql/zxjdbc.py
+++ b/lib/sqlalchemy/dialects/mysql/zxjdbc.py
@@ -6,8 +6,8 @@
 
 """Support for the MySQL database via Jython's zxjdbc JDBC connector.
 
-JDBC Driver
------------
+DBAPI
+-----
 
 The official MySQL JDBC driver is at
 http://dev.mysql.com/downloads/connector/j/.
@@ -15,7 +15,7 @@ http://dev.mysql.com/downloads/connector/j/.
 Connecting
 ----------
 
-Connect string format:
+Connect string::
 
     mysql+zxjdbc://<user>:<password>@<hostname>[:<port>]/<database>