- upgrade DBAPI index to have links to all dialect toplevel pages

- add line for google DBAPI

12 files changed, 77 insertions, 49 deletions

diff --git a/doc/build/core/engines.rst b/doc/build/core/engines.rst
index aa2c1f29b..1f01265a9 100644
--- a/doc/build/core/engines.rst
+++ b/doc/build/core/engines.rst
@@ -62,49 +62,50 @@ translate as:
   information on current support.
 * \* - indicates the given DBAPI is the "default" for SQLAlchemy, i.e. when just the database name is specified
 
-=========================  ===========================  ===========  ===========   ===========  =================  ============
-Driver                     Connect string               Py2K         Py3K          Jython       Unix               Windows
-=========================  ===========================  ===========  ===========   ===========  =================  ============
+===============================================================  ===========================  ===========  ===========   ===========  =================  ============
+Driver                                                           Connect string               Py2K         Py3K          Jython       Unix               Windows
+===============================================================  ===========================  ===========  ===========   ===========  =================  ============
 **DB2/Informix IDS**
-ibm-db_                    thirdparty                   thirdparty   thirdparty    thirdparty   thirdparty         thirdparty
-**Drizzle**
-mysql-python_              ``drizzle+mysqldb``\*        yes          development   no           yes                yes
-**Firebird / Interbase**
-kinterbasdb_               ``firebird+kinterbasdb``\*   yes          development   no           yes                yes
-**Informix**
-informixdb_                ``informix+informixdb``\*    yes          development   no           unknown            unknown
-**MaxDB**
-sapdb_                     ``maxdb+sapdb``\*            development  development   no           yes                unknown
-**Microsoft Access**
-pyodbc_                    ``access+pyodbc``\*          development  development   no           unknown            yes
-**Microsoft SQL Server**
-adodbapi_                  ``mssql+adodbapi``           development  development   no           no                 yes
-`jTDS JDBC Driver`_        ``mssql+zxjdbc``             no           no            development  yes                yes
-mxodbc_                    ``mssql+mxodbc``             yes          development   no           yes with FreeTDS_  yes
-pyodbc_                    ``mssql+pyodbc``\*           yes          development   no           yes with FreeTDS_  yes
-pymssql_                   ``mssql+pymssql``            yes          development   no           yes                yes
-**MySQL**
-`MySQL Connector/J`_       ``mysql+zxjdbc``             no           no            yes          yes                yes
-`MySQL Connector/Python`_  ``mysql+mysqlconnector``     yes          development   no           yes                yes
-mysql-python_              ``mysql+mysqldb``\*          yes          development   no           yes                yes
-OurSQL_                    ``mysql+oursql``             yes          yes           no           yes                yes
-pymysql_                   ``mysql+pymysql``            yes          development   no           yes                yes
-**Oracle**
-cx_oracle_                 ``oracle+cx_oracle``\*       yes          development   no           yes                yes
-`Oracle JDBC Driver`_      ``oracle+zxjdbc``            no           no            yes          yes                yes
-**Postgresql**
-pg8000_                    ``postgresql+pg8000``        yes          yes           no           yes                yes
-`PostgreSQL JDBC Driver`_  ``postgresql+zxjdbc``        no           no            yes          yes                yes
-psycopg2_                  ``postgresql+psycopg2``\*    yes          yes           no           yes                yes
-pypostgresql_              ``postgresql+pypostgresql``  no           yes           no           yes                yes
-**SQLite**
-pysqlite_                  ``sqlite+pysqlite``\*        yes          yes           no           yes                yes
-sqlite3_                   ``sqlite+pysqlite``\*        yes          yes           no           yes                yes
-**Sybase ASE**
-mxodbc_                    ``sybase+mxodbc``            development  development   no           yes                yes
-pyodbc_                    ``sybase+pyodbc``\*          partial      development   no           unknown            unknown
-python-sybase_             ``sybase+pysybase``          yes [1]_     development   no           yes                yes
-=========================  ===========================  ===========  ===========   ===========  =================  ============
+ibm-db_                                                          thirdparty                   thirdparty   thirdparty    thirdparty   thirdparty         thirdparty
+**Drizzle** :ref:`(docs) <drizzle_toplevel>`
+mysql-python_                                                    ``drizzle+mysqldb``\*        yes          development   no           yes                yes
+**Firebird / Interbase** :ref:`(docs) <firebird_toplevel>`
+kinterbasdb_                                                     ``firebird+kinterbasdb``\*   yes          development   no           yes                yes
+**Informix** :ref:`(docs) <informix_toplevel>`
+informixdb_                                                      ``informix+informixdb``\*    yes          development   no           unknown            unknown
+**MaxDB** :ref:`(docs) <maxdb_toplevel>`
+sapdb_                                                           ``maxdb+sapdb``\*            development  development   no           yes                unknown
+**Microsoft Access** :ref:`(docs) <access_toplevel>`
+pyodbc_                                                          ``access+pyodbc``\*          development  development   no           unknown            yes
+**Microsoft SQL Server** :ref:`(docs) <mssql_toplevel>`
+adodbapi_                                                        ``mssql+adodbapi``           development  development   no           no                 yes
+`jTDS JDBC Driver`_                                              ``mssql+zxjdbc``             no           no            development  yes                yes
+mxodbc_                                                          ``mssql+mxodbc``             yes          development   no           yes with FreeTDS_  yes
+pyodbc_                                                          ``mssql+pyodbc``\*           yes          development   no           yes with FreeTDS_  yes
+pymssql_                                                         ``mssql+pymssql``            yes          development   no           yes                yes
+**MySQL** :ref:`(docs) <mysql_toplevel>`
+`MySQL Connector/J`_                                             ``mysql+zxjdbc``             no           no            yes          yes                yes
+`MySQL Connector/Python`_                                        ``mysql+mysqlconnector``     yes          development   no           yes                yes
+mysql-python_                                                    ``mysql+mysqldb``\*          yes          development   no           yes                yes
+OurSQL_                                                          ``mysql+oursql``             yes          yes           no           yes                yes
+pymysql_                                                         ``mysql+pymysql``            yes          development   no           yes                yes
+rdbms_ (Google Appengine)                                        ``mysql+gaerdbms``           yes          development   no           no                 no
+**Oracle** :ref:`(docs) <oracle_toplevel>`
+cx_oracle_                                                       ``oracle+cx_oracle``\*       yes          development   no           yes                yes
+`Oracle JDBC Driver`_                                            ``oracle+zxjdbc``            no           no            yes          yes                yes
+**Postgresql** :ref:`(docs) <postgresql_toplevel>`
+pg8000_                                                          ``postgresql+pg8000``        yes          yes           no           yes                yes
+`PostgreSQL JDBC Driver`_                                        ``postgresql+zxjdbc``        no           no            yes          yes                yes
+psycopg2_                                                        ``postgresql+psycopg2``\*    yes          yes           no           yes                yes
+pypostgresql_                                                    ``postgresql+pypostgresql``  no           yes           no           yes                yes
+**SQLite** :ref:`(docs) <sqlite_toplevel>`
+pysqlite_                                                        ``sqlite+pysqlite``\*        yes          yes           no           yes                yes
+sqlite3_                                                         ``sqlite+pysqlite``\*        yes          yes           no           yes                yes
+**Sybase ASE** :ref:`(docs) <sybase_toplevel>`
+mxodbc_                                                          ``sybase+mxodbc``            development  development   no           yes                yes
+pyodbc_                                                          ``sybase+pyodbc``\*          partial      development   no           unknown            unknown
+python-sybase_                                                   ``sybase+pysybase``          yes [1]_     development   no           yes                yes
+===============================================================  ===========================  ===========  ===========   ===========  =================  ============
 
 .. [1] The Sybase dialect currently lacks the ability to reflect tables.
 .. _psycopg2: http://www.initd.org/
@@ -114,6 +115,7 @@ python-sybase_             ``sybase+pysybase``          yes [1]_     development
 .. _MySQL Connector/Python: https://launchpad.net/myconnpy
 .. _OurSQL: http://packages.python.org/oursql/
 .. _pymysql: http://code.google.com/p/pymysql/
+.. _rdbms: https://developers.google.com/cloud-sql/docs/developers_guide_python
 .. _PostgreSQL JDBC Driver: http://jdbc.postgresql.org/
 .. _sqlite3: http://docs.python.org/library/sqlite3.html
 .. _pysqlite: http://pypi.python.org/pypi/pysqlite/
diff --git a/doc/build/dialects/access.rst b/doc/build/dialects/access.rst
index 52a2ee371..161ec1ffd 100644
--- a/doc/build/dialects/access.rst
+++ b/doc/build/dialects/access.rst
@@ -1,3 +1,5 @@
+.. _access_toplevel:
+
 Microsoft Access
 ================
 
diff --git a/doc/build/dialects/drizzle.rst b/doc/build/dialects/drizzle.rst
index ab1b703da..114c6f9c9 100644
--- a/doc/build/dialects/drizzle.rst
+++ b/doc/build/dialects/drizzle.rst
@@ -1,3 +1,5 @@
+.. _drizzle_toplevel:
+
 Drizzle
 =======
 
diff --git a/doc/build/dialects/firebird.rst b/doc/build/dialects/firebird.rst
index dd6b6d0ba..000a8355e 100644
--- a/doc/build/dialects/firebird.rst
+++ b/doc/build/dialects/firebird.rst
@@ -1,3 +1,5 @@
+.. _firebird_toplevel:
+
 Firebird
 ========
 
diff --git a/doc/build/dialects/informix.rst b/doc/build/dialects/informix.rst
index 617b8cd9d..12eaa0438 100644
--- a/doc/build/dialects/informix.rst
+++ b/doc/build/dialects/informix.rst
@@ -1,3 +1,5 @@
+.. _informix_toplevel:
+
 Informix
 ========
 
diff --git a/doc/build/dialects/maxdb.rst b/doc/build/dialects/maxdb.rst
index 3edd55a77..c4f8a802c 100644
--- a/doc/build/dialects/maxdb.rst
+++ b/doc/build/dialects/maxdb.rst
@@ -1,3 +1,5 @@
+.. _maxdb_toplevel:
+
 MaxDB
 =====
 
diff --git a/doc/build/dialects/mysql.rst b/doc/build/dialects/mysql.rst
index 2439d8aa2..916df525e 100644
--- a/doc/build/dialects/mysql.rst
+++ b/doc/build/dialects/mysql.rst
@@ -176,6 +176,11 @@ MySQL-Connector Notes
 
 .. automodule:: sqlalchemy.dialects.mysql.mysqlconnector
 
+Google App Engine Notes
+-----------------------
+
+.. automodule:: sqlalchemy.dialects.mysql.gaerdbms
+
 pyodbc Notes
 --------------
 
diff --git a/doc/build/dialects/sybase.rst b/doc/build/dialects/sybase.rst
index 724656a30..8200f223d 100644
--- a/doc/build/dialects/sybase.rst
+++ b/doc/build/dialects/sybase.rst
@@ -1,3 +1,5 @@
+.. _sybase_toplevel:
+
 Sybase
 ======
 
diff --git a/lib/sqlalchemy/dialects/access/base.py b/lib/sqlalchemy/dialects/access/base.py
index 7c62dcc34..29f10c560 100644
--- a/lib/sqlalchemy/dialects/access/base.py
+++ b/lib/sqlalchemy/dialects/access/base.py
@@ -9,9 +9,10 @@
 """
 Support for the Microsoft Access database.
 
-This dialect is *not* ported to SQLAlchemy 0.6 or 0.7.
+.. note::
 
-This dialect is *not* tested on SQLAlchemy 0.6 or 0.7.
+    The Access dialect is **non-functional as of SQLAlchemy 0.6**, 
+    pending development efforts to bring it up-to-date.
 
 
 """
diff --git a/lib/sqlalchemy/dialects/informix/base.py b/lib/sqlalchemy/dialects/informix/base.py
index 044fb525d..ff096acc6 100644
--- a/lib/sqlalchemy/dialects/informix/base.py
+++ b/lib/sqlalchemy/dialects/informix/base.py
@@ -7,8 +7,11 @@
 
 """Support for the Informix database.
 
-This dialect is mostly functional as of SQLAlchemy 0.6.5.
+.. note::
 
+    The Informix dialect functions on current SQLAlchemy versions
+    but is not regularly tested, and may have many issues and 
+    caveats not currently handled.
 
 """
 
diff --git a/lib/sqlalchemy/dialects/maxdb/base.py b/lib/sqlalchemy/dialects/maxdb/base.py
index ce3aaaa1e..cde839db9 100644
--- a/lib/sqlalchemy/dialects/maxdb/base.py
+++ b/lib/sqlalchemy/dialects/maxdb/base.py
@@ -6,9 +6,10 @@
 
 """Support for the MaxDB database.
 
-This dialect is *not* ported to SQLAlchemy 0.6 or 0.7.
+.. note::
 
-This dialect is *not* tested on SQLAlchemy 0.6 or 0.7.
+    The MaxDB dialect is **non-functional as of SQLAlchemy 0.6**, 
+    pending development efforts to bring it up-to-date.
 
 Overview
 --------
diff --git a/lib/sqlalchemy/dialects/sybase/base.py b/lib/sqlalchemy/dialects/sybase/base.py
index 4b8cc08be..affef974c 100644
--- a/lib/sqlalchemy/dialects/sybase/base.py
+++ b/lib/sqlalchemy/dialects/sybase/base.py
@@ -10,8 +10,12 @@
 
 """Support for Sybase Adaptive Server Enterprise (ASE).
 
-Note that this dialect is no longer specific to Sybase iAnywhere.
-ASE is the primary support platform.
+.. note::
+
+    The Sybase dialect functions on current SQLAlchemy versions
+    but is not regularly tested, and may have many issues and 
+    caveats not currently handled.   In particular, the table
+    and database reflection features are not implemented.
 
 """