Ticket #153: order_by_docs.patch

docs/tutorial03.txt

@@ -174 +174 @@
     from django.utils.httpwrappers import HttpResponse
 
     def index(request):
-        latest_poll_list = polls.get_list(order_by=[('pub_date', 'DESC')],
+        latest_poll_list = polls.get_list(order_by='-pub_date',
             limit=5)
         output = ', '.join([p.question for p in latest_poll_list])
         return HttpResponse(output)
@@ -189 +189 @@
     from django.utils.httpwrappers import HttpResponse
 
     def index(request):
-        latest_poll_list = polls.get_list(order_by=[('pub_date', 'DESC')],
+        latest_poll_list = polls.get_list(order_by='-pub_date',
             limit=5)
         t = template_loader.get_template('polls/index')
         c = Context(request, {

docs/db-api.txt

@@ -107 +107 @@
     polls.get_list(
         pub_date__year=2005,
         pub_date__month=1,
-        order_by=(("pub_date", "DESC"), ("question", "ASC")),
+        order_by=("-pub_date", "question")),
     )
 
-The result set above will be ordered by ``pub_date`` (descending), then
-by ``question`` (ascending).  Just like in models, the ``order_by`` clause
-is a list of ordering tuples where the first element is the field and the
-second is "ASC" (ascending) or "DESC" (descending).  You can also
-use the tuple ``(None, "RANDOM")`` to order the result set randomly.
+The result set above will be ordered by ``pub_date`` (the negative sign
+indicates descending ordering), then by ``question`` (ascending).  Just like in
+models, the ``order_by`` clause is a list of fields to order by.  Each field
+can be prepended with a negative sign to indicate descending ordering.  You can
+also use ``?`` as the field to order the result set randomly.
 
 Relationships (joins)
 =====================