- justify NamedTuple, now called KeyedTuple

- fix this test

2 files changed, 12 insertions, 3 deletions

diff --git a/lib/sqlalchemy/util/__init__.py b/lib/sqlalchemy/util/__init__.py
index 313c6b02c..65a06c28d 100644
--- a/lib/sqlalchemy/util/__init__.py
+++ b/lib/sqlalchemy/util/__init__.py
@@ -9,7 +9,7 @@ from compat import callable, cmp, reduce, defaultdict, py25_dict, \
     update_wrapper, partial, md5_hex, decode_slice, dottedgetter,\
     parse_qsl, any, contextmanager, namedtuple, next, WeakSet
 
-from _collections import NamedTuple, ImmutableContainer, immutabledict, \
+from _collections import KeyedTuple, ImmutableContainer, immutabledict, \
     Properties, OrderedProperties, ImmutableProperties, OrderedDict, \
     OrderedSet, IdentitySet, OrderedIdentitySet, column_set, \
     column_dict, ordered_column_set, populate_column_dict, unique_list, \
diff --git a/lib/sqlalchemy/util/_collections.py b/lib/sqlalchemy/util/_collections.py
index 801a79e9a..af3be8ec3 100644
--- a/lib/sqlalchemy/util/_collections.py
+++ b/lib/sqlalchemy/util/_collections.py
@@ -16,10 +16,19 @@ from compat import time_func, threading
 EMPTY_SET = frozenset()
 
 
-class NamedTuple(tuple):
+class KeyedTuple(tuple):
     """tuple() subclass that adds labeled names.
 
-    Is also pickleable.
+    Unlike collections.namedtuple, this is
+    an ad-hoc data structure, not a factory
+    for new types.
+
+    It's pickleable in-place without the need for stack
+    frame manipulation, new KeyedTuple types can be created
+    very quickly and simply (look at the source
+    to collections.namedtuple for contrast).
+
+    Is used by :class:`.Query` to return result rows.
 
     """