From: Mike Bayer <mike_mp@zzzcomputing.com>
Date: Wed, 29 Oct 2025 12:08:03 +0000 (-0400)
Subject: fix session cursor result tip
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=e2bda66b5115cc628ebce9423877586c9e817feb;p=thirdparty%2Fsqlalchemy%2Fsqlalchemy.git

fix session cursor result tip

in 2.0, we are usually not returning CursorResult for
Session.execute().

References: #12813
Change-Id: I19049b57790b5429ce7890c86e87b93c07a3f1d2
---

diff --git a/doc/build/tutorial/data_update.rst b/doc/build/tutorial/data_update.rst
index d21b153144..4b444395ea 100644
--- a/doc/build/tutorial/data_update.rst
+++ b/doc/build/tutorial/data_update.rst
@@ -291,8 +291,9 @@ is available from the :attr:`_engine.CursorResult.rowcount` attribute:
     specific to the DBAPI ``cursor`` object.  An instance of this subclass is
     returned when a statement is invoked via the
     :meth:`_engine.Connection.execute` method. When using the ORM, the
-    :meth:`_orm.Session.execute` method returns an object of this type for
-    all INSERT, UPDATE, and DELETE statements.
+    :meth:`_orm.Session.execute` method will normally **not** return this type
+    of object, unless the given query uses only Core :class:`.Table` objects
+    directly.
 
 Facts about :attr:`_engine.CursorResult.rowcount`: