Ticket #7863: r8016-regroup-sorted.diff

docs/templates.txt

@@ -982 +982 @@
 regroup
 ~~~~~~~
 
-Regroup a list of alike objects by a common attribute.
+Takes a sorted list of like objects and regroups the list using a common attribute.
 
 This complex tag is best illustrated by use of an example:  say that ``people``
-is a list of people represented by dictionaries with ``first_name``,
-``last_name``, and ``gender`` keys::
+is a list of people, sorted by ``last_name``, represented by dictionaries with 
+``first_name``, ``last_name``, and ``gender`` keys::
 
     people = [
         {'first_name': 'George', 'last_name': 'Bush', 'gender': 'Male'},