]> git.ipfire.org Git - thirdparty/sqlalchemy/sqlalchemy.git/commitdiff
Add parens around unmarked clause
authorEvan Taylor Yates <evantayloryates@gmail.com>
Sun, 4 Oct 2020 00:04:44 +0000 (17:04 -0700)
committerGitHub <noreply@github.com>
Sun, 4 Oct 2020 00:04:44 +0000 (17:04 -0700)
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;..."

doc/build/orm/cascades.rst

index 3f06b34c2f2c39d5d0403fdf25ec7976e08c8e36..8a2a94876025a39ceeff2bdb3f6bfac70a531cc8 100644 (file)
@@ -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`