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

diff --git a/lib/sqlalchemy/orm/session.py b/lib/sqlalchemy/orm/session.py
index 0fbd721af6b97d9f781601f0289936cf9dfe5ddb..eb031247241a5c942991db7249872e743e900981 100644 (file)
--- a/lib/sqlalchemy/orm/session.py
+++ b/lib/sqlalchemy/orm/session.py
@@ -804,6 +804,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