From: Mike Bayer <mike_mp@zzzcomputing.com>
Date: Tue, 9 Jun 2015 17:02:43 +0000 (-0400)
Subject: - add a migration note for the query.update()/query.delete() change
X-Git-Tag: rel_1_0_6~29
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=1cc50c81b9d3507e9bcefc625dd07b12a8178e9c;p=thirdparty%2Fsqlalchemy%2Fsqlalchemy.git

- add a migration note for the query.update()/query.delete() change
in #3349
---

diff --git a/doc/build/changelog/migration_10.rst b/doc/build/changelog/migration_10.rst
index 4999e45def..08e26fd4b0 100644
--- a/doc/build/changelog/migration_10.rst
+++ b/doc/build/changelog/migration_10.rst
@@ -8,7 +8,7 @@ What's New in SQLAlchemy 1.0?
     undergoing maintenance releases as of May, 2014,
     and SQLAlchemy version 1.0, released in April, 2015.
 
-    Document last updated: May 2, 2015
+    Document last updated: June 9, 2015
 
 Introduction
 ============
@@ -1669,6 +1669,20 @@ has always emitted a warning here and ignored addtional results for
 :ticket:`3249`
 
 
+query.update() / query.delete() raises if used with join(), select_from(), from_self()
+--------------------------------------------------------------------------------------
+
+A warning is emitted in SQLAlchemy 0.9.10 (not yet released as of
+June 9, 2015) when the :meth:`.Query.update` or :meth:`.Query.delete` methods
+are invoked against a query which has also called upon :meth:`.Query.join`,
+:meth:`.Query.outerjoin`,
+:meth:`.Query.select_from` or :meth:`.Query.from_self`.  These are unsupported
+use cases which silently fail in the 0.9 series up until 0.9.10 where it emits
+a warning.  In 1.0, these cases raise an exception.
+
+:ticket:`3349`
+
+
 query.update() with ``synchronize_session='evaluate'`` raises on multi-table update
 -----------------------------------------------------------------------------------