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

1 files changed, 13 insertions, 1 deletions

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/