[1.7.x] Refs #24462 -- Emphasized that order_by() clears previous ord…

…ering. Backport of b9d9ab2 from master
django · Mar 13, 2015 · f8ed647 · f8ed647
1 parent 9bb451a
commit f8ed647
Showing 1 changed file with 5 additions and 0 deletions.
diff --git a/docs/ref/models/querysets.txt b/docs/ref/models/querysets.txt
@@ -348,6 +348,11 @@ You can tell if a query is ordered or not by checking the
 :attr:`.QuerySet.ordered` attribute, which will be ``True`` if the
 ``QuerySet`` has been ordered in any way.
 
+Each ``order_by()`` call will clear any previous ordering. For example, this
+query will be ordered by ``pub_date`` and not ``headline``::
+
+    Entry.objects.order_by('headline').order_by('pub_date')
+
 .. warning::
 
     Ordering is not a free operation. Each field you add to the ordering