- clarify docs that contains_eager() is included in the of_type() system,

fix #2438
This commit is contained in:
Mike Bayer
2014-08-07 09:59:59 -04:00
parent a3761896fa
commit b35e6c69b7
+5 -2
View File
@@ -472,7 +472,8 @@ subselect back to the parent ``companies`` table.
Eager Loading of Specific or Polymorphic Subtypes
++++++++++++++++++++++++++++++++++++++++++++++++++
The :func:`.joinedload` and :func:`.subqueryload` options also support
The :func:`.joinedload`, :func:`.subqueryload`, :func:`.contains_eager` and
other loading-related options also support
paths which make use of :func:`~sqlalchemy.orm.interfaces.PropComparator.of_type`.
Below we load ``Company`` rows while eagerly loading related ``Engineer``
objects, querying the ``employee`` and ``engineer`` tables simultaneously::
@@ -500,11 +501,13 @@ can be loaded::
)
.. versionadded:: 0.8
:func:`.joinedload` and :func:`.subqueryload` support
:func:`.joinedload`, :func:`.subqueryload`, :func:`.contains_eager`
and related loader options support
paths that are qualified with
:func:`~sqlalchemy.orm.interfaces.PropComparator.of_type`, supporting
single target types as well as :func:`.orm.with_polymorphic` targets.
Single Table Inheritance
------------------------