From: BR Date: Mon, 4 Jun 2018 16:33:39 +0000 (-0400) Subject: Small docs style fixes in inheritance.rst X-Git-Tag: rel_1_3_0b1~174 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=63307d201e0c442466e84863989774de2918bcd7;p=thirdparty%2Fsqlalchemy%2Fsqlalchemy.git Small docs style fixes in inheritance.rst Change-Id: I01d217cf1a8a1a8791e3b44167dfc4d6a0c77cdb Pull-request: https://github.com/zzzeek/sqlalchemy/pull/445 --- diff --git a/doc/build/orm/inheritance.rst b/doc/build/orm/inheritance.rst index 794fc391c4..553fb92911 100644 --- a/doc/build/orm/inheritance.rst +++ b/doc/build/orm/inheritance.rst @@ -30,14 +30,15 @@ Joined Table Inheritance In joined table inheritance, each class along a hierarchy of classes is represented by a distinct table. Querying for a particular subclass in the hierarchy will render as a SQL JOIN along all tables in its -inheritance path - if the class is the base class, the default behavior -is to include only the base table in the SELECT. In all cases, the +inheritance path. If the queried class is the base class, the **default behavior +is to include only the base table** in a SELECT statement. In all cases, the ultimate class to instantiate for a given row is determined by a discriminator -column or expression that works against the base table. A subclass -loaded against the base table only will have only base attributes -populated at first; the additional attributes will :term:`lazy load` when -they are accessed. Options also exist to query for all -columns across multiple tables/subclasses up front. +column or an expression that works against the base table. When a subclass +is loaded **only** against a base table, resulting objects will have base attributes +populated at first; attributes that are local to the subclass will :term:`lazy load` +when they are accessed. Alternatively, there are options which can change +the default behavior, allowing the query to include columns corresponding to +multiple tables/subclasses up front. The base class in a joined inheritance hierarchy is configured with additional arguments that will refer to the polymorphic discriminator