add a note, no autoflush with execute, [ticket:2550]

diff --git a/lib/sqlalchemy/orm/session.py b/lib/sqlalchemy/orm/session.py
index 191d6babe6c0f58bbc0ba22aed68d82c77330ca9..4ab41a79d7fc38a500265881018305face788460 100644 (file)
--- a/lib/sqlalchemy/orm/session.py
+++ b/lib/sqlalchemy/orm/session.py
@@ -805,6 +805,8 @@ class Session(object):
         with no active transaction will produce a result that auto-closes
         the underlying :class:`.Connection`.
 
+        The :meth:`.Session.execute` method does *not* invoke autoflush.
+
         :param clause:
             A :class:`.ClauseElement` (i.e. :func:`~.sql.expression.select`,
             :func:`~.sql.expression.text`, etc.) or string SQL statement to be executed.  The clause