From: Evan Taylor Yates Date: Sun, 4 Oct 2020 00:04:44 +0000 (-0700) Subject: Add parens around unmarked clause X-Git-Tag: rel_1_4_0b1~28^2~1 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=c6eca2271770308bac2747f0c32030ffaf8d7747;p=thirdparty%2Fsqlalchemy%2Fsqlalchemy.git Add parens around unmarked clause I'm not 100% sure what this sentence is saying, but I'm pretty sure it needs either commas or parentheses to break it up a little. I think parens make the most sense in this case assuming I am reading it correctly. Here's the original sentence and proposed edit in plaintext: ORIG "...persistent objects which were removed from a collection or in some cases a scalar attribute may also be pulled into the Session of a parent object;..." EDIT "...persistent objects which were removed from a collection (or in some cases a scalar attribute) may also be pulled into the Session of a parent object;..." --- diff --git a/doc/build/orm/cascades.rst b/doc/build/orm/cascades.rst index 3f06b34c2f..8a2a948760 100644 --- a/doc/build/orm/cascades.rst +++ b/doc/build/orm/cascades.rst @@ -95,7 +95,7 @@ becomes part of the state of that :class:`.Session`:: ``save-update`` has the possibly surprising behavior which is that persistent objects which were *removed* from a collection -or in some cases a scalar attribute +(or in some cases a scalar attribute) may also be pulled into the :class:`.Session` of a parent object; this is so that the flush process may handle that related object appropriately. This case can usually only arise if an object is removed from one :class:`.Session`