a comment indicating why we can't raise an error for relation(Foo, uselist=False...

diff --git a/test/orm/unitofwork.py b/test/orm/unitofwork.py
index 649754601c4f9d5933f41bfed792248b3b26e9d1..7beafb58f5dd21aa3e54652f22cfaa26346081b5 100644 (file)
--- a/test/orm/unitofwork.py
+++ b/test/orm/unitofwork.py
@@ -1854,7 +1854,9 @@ class ManyToManyTest(_fixtures.FixtureTest):
                  keyword=relation(mapper(Keyword, keywords, non_primary=True),
                                   lazy=False,
                                   uselist=False,
-                                  order_by=keywords.c.name)))
+                                  order_by=keywords.c.name      # note here is a valid place where order_by can be used
+                                  )))                           # on a scalar relation(); to determine eager ordering of
+                                                                # the parent object within its collection.
 
         mapper(Item, items, properties=dict(
             keywords=relation(IKAssociation, lazy=False)))