From bdfe680708d869d37dd5c1bc2d2b045639caba9d Mon Sep 17 00:00:00 2001 From: Mike Bayer Date: Sun, 31 Aug 2014 18:05:17 -0400 Subject: [PATCH] - improve from_statement() doc --- lib/sqlalchemy/orm/query.py | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/lib/sqlalchemy/orm/query.py b/lib/sqlalchemy/orm/query.py index 72989f34b9..090284d9f8 100644 --- a/lib/sqlalchemy/orm/query.py +++ b/lib/sqlalchemy/orm/query.py @@ -2348,9 +2348,15 @@ class Query(object): This method bypasses all internal statement compilation, and the statement is executed without modification. - The statement argument is either a string, a ``select()`` construct, - or a ``text()`` construct, and should return the set of columns - appropriate to the entity class represented by this ``Query``. + The statement is typically either a :func:`~.expression.text` + or :func:`~.expression.select` construct, and should return the set + of columns + appropriate to the entity class represented by this :class:`.Query`. + + .. seealso:: + + :ref:`orm_tutorial_literal_sql` - usage examples in the + ORM tutorial """ if isinstance(statement, util.string_types): -- 2.47.3