Corrected docs on create_engine to link to DBEngine Logging docs. Fixes #1721.

diff --git a/doc/build/dbengine.rst b/doc/build/dbengine.rst
index 2e24c19563ca08ade60955035ad801ca492ac58e..49ccfd3be5710a88e093aad3bd0170f348a54f59 100644 (file)
--- a/doc/build/dbengine.rst
+++ b/doc/build/dbengine.rst
@@ -429,6 +429,8 @@ Calling ``close()`` on the "contextual" connection does not release the connecti
 
 So remember - if you're not sure if you need to use ``strategy="threadlocal"`` or not, the answer is **no** !  It's driven by a specific programming pattern that is generally not the norm.
 
+.. _dbengine_logging:
+
 Configuring Logging
 ====================
 

diff --git a/lib/sqlalchemy/engine/__init__.py b/lib/sqlalchemy/engine/__init__.py
index 137218c2c087bccbd31a5d9e50d20a6eabbd9f12..8911485cbbcf65b021cf06da9044577160045fdd 100644 (file)
--- a/lib/sqlalchemy/engine/__init__.py
+++ b/lib/sqlalchemy/engine/__init__.py
@@ -150,14 +150,13 @@ def create_engine(*args, **kwargs):
         ``Engine`` can be modified at any time to turn logging on and
         off. If set to the string ``"debug"``, result rows will be
         printed to the standard output as well. This flag ultimately
-        controls a Python logger; see `dbengine_logging` at the end of
-        this chapter for information on how to configure logging
-        directly.
+        controls a Python logger; see :ref:`dbengine_logging` for
+        information on how to configure logging directly.
 
     :param echo_pool=False: if True, the connection pool will log
         all checkouts/checkins to the logging stream, which defaults to
         sys.stdout. This flag ultimately controls a Python logger; see
-        `dbengine_logging` for information on how to configure logging
+        :ref:`dbengine_logging` for information on how to configure logging
         directly.
 
     :param encoding='utf-8': the encoding to use for all Unicode