]> git.ipfire.org Git - thirdparty/sqlalchemy/sqlalchemy.git/commitdiff
doc fixes
authorMike Bayer <mike_mp@zzzcomputing.com>
Mon, 18 Sep 2023 20:43:31 +0000 (16:43 -0400)
committerMike Bayer <mike_mp@zzzcomputing.com>
Mon, 18 Sep 2023 20:43:31 +0000 (16:43 -0400)
Change-Id: I97f4985ccfcaaa6da75ff89defe0dd62c61d0559

doc/build/changelog/unreleased_20/10279.rst
doc/build/orm/queryguide/inheritance.rst

index 4a851cbdd29f319e3db90c67fefcf0b200d4534c..f7d29a36bd7a9bf929d2fc362090f7a8a6f84e4a 100644 (file)
@@ -2,9 +2,11 @@
     :tags: bug, orm
     :tickets: 10279
 
-    Adjusted the ORM's interpretation of UPDATE/DELETE targets to not interfere
-    with the target table passed to the statement, such as for
-    :class:`_orm.aliased` constructs.   Cases like ORM session synchonize using
-    "SELECT" statements such as with MySQL/ MariaDB will still have issues with
+    Adjusted the ORM's interpretation of the "target" entity used within
+    :class:`.Update` and :class:`.Delete` to not interfere with the target
+    "from" object passed to the statement, such as when passing an ORM-mapped
+    :class:`_orm.aliased` construct that should be maintained within a phrase
+    like "UPDATE FROM".  Cases like ORM session synchonize using "SELECT"
+    statements such as with MySQL/ MariaDB will still have issues with
     UPDATE/DELETE of this form so it's best to disable synchonize_session when
     using DML statements of this type.
index 0cb44b8ac729394c7211962508a818a964e41e03..98fac2bc976f8645a67d15cea47cd1258c99ea78 100644 (file)
@@ -299,17 +299,17 @@ Applying loader options when selectin_polymorphic is itself a sub-option
 
 .. versionadded:: 2.0.21
 
-The previous section illustrated
-:func:`_orm.selectin_polymorphic` and :func:`_orm.selectinload` used as siblings
-within a call to :func:`_sql.select.options`.   If the target entity is one that
-is already being loaded from a parent relationship, as in the example at
+The previous section illustrated :func:`_orm.selectin_polymorphic` and
+:func:`_orm.selectinload` used as sibling options, both used within a single
+call to :meth:`_sql.select.options`.   If the target entity is one that is
+already being loaded from a parent relationship, as in the example at
 :ref:`polymorphic_selectin_as_loader_option_target`, we can apply this
 "sibling" pattern using the :meth:`_orm.Load.options` method that applies
 sub-options to a parent, as illustrated at
-:ref:`orm_queryguide_relationship_sub_options`.  Below we combine the two examples
-to load `Company.employees`, also loading the attributes for the `Manager` and
-`Engineer` classes, as well as eagerly loading the `Manager.paperwork`
-attribute::
+:ref:`orm_queryguide_relationship_sub_options`.  Below we combine the two
+examples to load ``Company.employees``, also loading the attributes for the
+``Manager`` and ``Engineer`` classes, as well as eagerly loading the
+```Manager.paperwork``` attribute::
 
     >>> from sqlalchemy.orm import selectinload
     >>> stmt = select(Company).options(