]> git.ipfire.org Git - thirdparty/sqlalchemy/sqlalchemy.git/commitdiff
remove ambiguous language
authorMike Bayer <mike_mp@zzzcomputing.com>
Mon, 18 Jun 2012 04:08:46 +0000 (00:08 -0400)
committerMike Bayer <mike_mp@zzzcomputing.com>
Mon, 18 Jun 2012 04:08:46 +0000 (00:08 -0400)
lib/sqlalchemy/ext/declarative.py

index ac00c8a9c4dc77c7a6b093bcc2723d4444e38e10..6b804036c334b6e239f1ac3d32da11eb0c4a95b9 100755 (executable)
@@ -400,8 +400,8 @@ table::
 
 Note that above, the ``Engineer.id`` attribute, since it shares the
 same attribute name as the ``Person.id`` attribute, will in fact
-represent the ``people.id`` and ``engineers.id`` columns together, and
-will render inside a query as ``"people.id"``. 
+represent the ``people.id`` and ``engineers.id`` columns together,
+with the "Engineer.id" column taking precedence if queried directly.
 To provide the ``Engineer`` class with an attribute that represents
 only the ``engineers.id`` column, give it a different attribute name::
 
@@ -412,6 +412,11 @@ only the ``engineers.id`` column, give it a different attribute name::
                                                     primary_key=True)
         primary_language = Column(String(50))
 
+
+.. versionchanged:: 0.7 joined table inheritance favors the subclass
+   column over that of the superclass, such as querying above
+   for ``Engineer.id``.  Prior to 0.7 this was the reverse.
+   
 Single Table Inheritance
 ~~~~~~~~~~~~~~~~~~~~~~~~