From e81d1c995c0cc5573d3627de0fe6b803b2f43fb2 Mon Sep 17 00:00:00 2001
From: Andrew Kuchev <0coming.soon@gmail.com>
Date: Thu, 5 Nov 2015 15:59:56 +0500
Subject: Fixed #25670 -- Allowed dictsort to sort a list of lists.

Thanks Tim Graham for the review.
---
 docs/ref/templates/builtins.txt | 34 ++++++++++++++++++++++++++++++++++
 docs/releases/1.10.txt          |  3 +++
 2 files changed, 37 insertions(+)

(limited to 'docs')

diff --git a/docs/ref/templates/builtins.txt b/docs/ref/templates/builtins.txt
index 21e5321f80..20fcdb02b5 100644
--- a/docs/ref/templates/builtins.txt
+++ b/docs/ref/templates/builtins.txt
@@ -1443,6 +1443,40 @@ then the output would be::
     * 1984 (George)
     * Timequake (Kurt)
 
+``dictsort`` can also order a list of lists (or any other object implementing
+``__getitem__()``) by elements at specified index. For example::
+
+    {{ value|dictsort:0 }}
+
+If ``value`` is:
+
+.. code-block:: python
+
+    [
+        ('a', '42'),
+        ('c', 'string'),
+        ('b', 'foo'),
+    ]
+
+then the output would be:
+
+.. code-block:: python
+
+    [
+        ('a', '42'),
+        ('b', 'foo'),
+        ('c', 'string'),
+    ]
+
+You must pass the index as an integer rather than a string. The following
+produce empty output::
+
+    {{ values|dictsort:"0" }}
+
+.. versionchanged:: 1.10
+
+    The ability to order a list of lists was added.
+
 .. templatefilter:: dictsortreversed
 
 ``dictsortreversed``
diff --git a/docs/releases/1.10.txt b/docs/releases/1.10.txt
index fc7b03d2a7..8bff4e99c6 100644
--- a/docs/releases/1.10.txt
+++ b/docs/releases/1.10.txt
@@ -333,6 +333,9 @@ Templates
 
 * Added the ``is`` comparison operator to the :ttag:`if` tag.
 
+* Allowed :tfilter:`dictsort` to order a list of lists by an element at a
+  specified index.
+
 Tests
 ~~~~~
 
-- 
cgit v1.3