From 4bcdb15091b21e09a92fe73e26d5ef5cc84bff80 Mon Sep 17 00:00:00 2001 From: Adrian Holovaty Date: Thu, 13 Apr 2006 01:45:15 +0000 Subject: [PATCH] Added some examples to 'ordering' section of docs/model-api.txt git-svn-id: http://code.djangoproject.com/svn/django/trunk@2689 bcc190cf-cafb-0310-a4f2-bffc1f526a37 --- docs/model-api.txt | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/docs/model-api.txt b/docs/model-api.txt index ecd813b17d..ec5b5e5ad4 100644 --- a/docs/model-api.txt +++ b/docs/model-api.txt @@ -793,7 +793,19 @@ Here's a list of all possible ``META`` options. No options are required. Adding optional "-" prefix, which indicates descending order. Fields without a leading "-" will be ordered ascending. Use the string "?" to order randomly. - See `Specifying ordering`_ for a full example. + For example, to order by a ``pub_date`` field ascending, use this:: + + ordering = ['pub_date'] + + To order by ``pub_date`` descending, use this:: + + ordering = ['-pub_date'] + + To order by ``pub_date`` descending, then by ``author`` ascending, use this:: + + ordering = ['-pub_date', 'author'] + + See `Specifying ordering`_ for more examples. .. _Specifying ordering: http://www.djangoproject.com/documentation/models/ordering/