some doc defenses

diff --git a/lib/sqlalchemy/dialects/mysql/base.py b/lib/sqlalchemy/dialects/mysql/base.py
index a74b20ac4f8ee9aa0509a947960310c8354d0323..131112ff4e48061babf17604ff9f8d435c550942 100644 (file)
--- a/lib/sqlalchemy/dialects/mysql/base.py
+++ b/lib/sqlalchemy/dialects/mysql/base.py
@@ -159,8 +159,10 @@ in the URL, such as::
 test?charset=utf8")
 
 Whether or not the DBAPI handles the job of encoding and decoding is determined
-by passing the ``use_unicode`` parameter.   For example, to disable
-unicode conversion by the DBAPI and let SQLAlchemy handle it::
+by passing the ``use_unicode`` parameter, supported by MySQLdb and PyMySQL
+and possibly others.
+For example, to disable unicode conversion by the DBAPI and let
+SQLAlchemy handle it::
 
     e = create_engine("mysql+pymysql://scott:tiger@localhost/\
 test?charset=utf8&use_uncode=0")

diff --git a/lib/sqlalchemy/dialects/mysql/mysqlconnector.py b/lib/sqlalchemy/dialects/mysql/mysqlconnector.py
index 97fd0ccdfa866a71252850278f34233756a50c4a..33cddd060f6183b566b1fccd8bf68337f204fd24 100644 (file)
--- a/lib/sqlalchemy/dialects/mysql/mysqlconnector.py
+++ b/lib/sqlalchemy/dialects/mysql/mysqlconnector.py
@@ -17,6 +17,9 @@
 Unicode
 -------
 
+The ``use_unicode=0`` flag is **not** supported in MySQL-Connector at this
+time, nor is the ``utf8mb4`` charset.
+
 Please see :ref:`mysql_unicode` for background on enabling charset support
 with mysql-connector.
 

diff --git a/lib/sqlalchemy/dialects/mysql/oursql.py b/lib/sqlalchemy/dialects/mysql/oursql.py
index 7f35e63bea4a54832d849ab2e5840686057abb6c..f4eca4252841249e17329ad5dc9b2a62cf40d523 100644 (file)
--- a/lib/sqlalchemy/dialects/mysql/oursql.py
+++ b/lib/sqlalchemy/dialects/mysql/oursql.py
@@ -16,6 +16,9 @@
 Unicode
 -------
 
+The ``use_unicode=0`` flag is **not** supported in OurSQL,
+nor is the ``utf8mb4`` charset.
+
 oursql defaults to using ``utf8`` as the connection charset, but other
 encodings may be used instead. Like the MySQL-Python driver, unicode support
 can be completely disabled::