- add a tl;dr to postgresql search_path section as it's long

and will be easier to read if we know where it's going first.

Change-Id: I2766cf4655451ed514d4dc95ac60406b9f4a8ddb
(cherry picked from commit 513a6e5bcea5dccabaf86166906233542a4669e7)

diff --git a/lib/sqlalchemy/dialects/postgresql/base.py b/lib/sqlalchemy/dialects/postgresql/base.py
index 6bc3d55fee34524dccfec1adb72998e2c3ae58ad..5783f0db9dce1ee3057ae3f0ce586ad83627c0b1 100644 (file)
--- a/lib/sqlalchemy/dialects/postgresql/base.py
+++ b/lib/sqlalchemy/dialects/postgresql/base.py
@@ -125,6 +125,9 @@ Valid values for ``isolation_level`` include:
 Remote-Schema Table Introspection and PostgreSQL search_path
 ------------------------------------------------------------
 
+**TL;DR;**: keep the ``search_path`` variable set to its default of ``public``,
+name schemas **other** than ``public`` explicitly within ``Table`` defintitions.
+
 The PostgreSQL dialect can reflect tables from any schema.  The
 :paramref:`.Table.schema` argument, or alternatively the
 :paramref:`.MetaData.reflect.schema` argument determines which schema will