add note to "quote" regarding case insensitive table reflection

this note basically states that the use case requested in
issue #7026 is not supported.  I'm not sure the note is
going to otherwise make sense to  anyone.

Fixes: #7026
Change-Id: Ib7782afc9bc5dc0c43cfab9b1f969a55c43209fe

diff --git a/lib/sqlalchemy/sql/schema.py b/lib/sqlalchemy/sql/schema.py
index d9c7eb8b9f9ef31bc112551dc0fa0db49e8f9d1a..02c1b9cedb18bd94aed4d7c1b1c97c53264e2160 100644 (file)
--- a/lib/sqlalchemy/sql/schema.py
+++ b/lib/sqlalchemy/sql/schema.py
@@ -440,6 +440,12 @@ class Table(DialectKWArgs, SchemaItem, TableClause):
         is only needed to force quoting of a reserved word which is not known
         by the SQLAlchemy dialect.
 
+        .. note:: setting this flag to ``False`` will not provide
+           case-insensitive behavior for table reflection; table reflection
+           will always search for a mixed-case name in a case sensitive
+           fashion.  Case insensitive names are specified in SQLAlchemy only
+           by stating the name with all lower case characters.
+
     :param quote_schema: same as 'quote' but applies to the schema identifier.
 
     :param schema: The schema name for this table, which is required if