remove undoc-members from query docstring [ticket:2774]

diff --git a/doc/build/orm/query.rst b/doc/build/orm/query.rst
index e5358792caaeeb0cc1c243407341fe2dcd4e56e4..73aa5c5551a15f3cd6486bccd500df5fd8da757d 100644 (file)
--- a/doc/build/orm/query.rst
+++ b/doc/build/orm/query.rst
@@ -21,7 +21,6 @@ Following is the full interface for the :class:`.Query` object.
 
 .. autoclass:: sqlalchemy.orm.query.Query
    :members:
-   :undoc-members:
 
 ORM-Specific Query Constructs
 -----------------------------

diff --git a/lib/sqlalchemy/orm/query.py b/lib/sqlalchemy/orm/query.py
index 7454c48536fcfeae2e292a3cb925023f138565fb..999e97394f4ce804cdd1837dbb99188b67e0e35d 100644 (file)
--- a/lib/sqlalchemy/orm/query.py
+++ b/lib/sqlalchemy/orm/query.py
@@ -577,6 +577,13 @@ class Query(object):
 
     @property
     def selectable(self):
+        """Return the :class:`.Select` object emitted by this :class:`.Query`.
+
+        Used for :func:`.inspect` compatibility, this is equivalent to::
+
+            query.enable_eagerloads(False).with_labels().statement
+
+        """
         return self.__clause_element__()
 
     def __clause_element__(self):