Commit 5b918027 authored by Tim Graham's avatar Tim Graham
Browse files

[1.8.x] Refs #24462 -- Emphasized that order_by() clears previous ordering. 

Backport of b9d9ab23 from master
parent 937c8a5a

docs/ref/models/querysets.txt

+5 −0
Original line number Diff line number Diff line
@@ -393,6 +393,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