Author: phd
Date: 2007-04-25 09:17:07 -0600 (Wed, 25 Apr 2007)
New Revision: 2602
Modified:
SQLObject/docs/News.txt
SQLObject/docs/SQLObject.txt
Log:
More documentation about orderBy.
Modified: SQLObject/docs/News.txt
===================================================================
--- SQLObject/docs/News.txt 2007-04-25 15:16:50 UTC (rev 2601)
+++ SQLObject/docs/News.txt 2007-04-25 15:17:07 UTC (rev 2602)
@@ -220,6 +220,8 @@
* Yet another patch to properly initialize MySQL connection encoding.
+* More documentation about orderBy.
+
SQLObject 0.7.5
===============
Modified: SQLObject/docs/SQLObject.txt
===================================================================
--- SQLObject/docs/SQLObject.txt 2007-04-25 15:16:50 UTC (rev 2601)
+++ SQLObject/docs/SQLObject.txt 2007-04-25 15:17:07 UTC (rev 2602)
@@ -568,14 +568,13 @@
.. _orderBy:
-You can use the keyword arguments `orderBy` to create ``ORDER BY`` in
-the select statements: `orderBy` takes a string, which should be the
-*database* name of the column, or a column in the form
-``Person.q.firstName``. You can use ``"-colname"`` to specify
-descending order (this is translated to DESC, so it works on
-non-numeric types as well), or call
-``MyClass.select().reversed()``. orderBy can also take a list of
-column names in the same format as a single column name.
+You can use the keyword arguments `orderBy` to create ``ORDER BY`` in the
+select statements: `orderBy` takes a string, which should be the *database*
+name of the column, or a column in the form ``Person.q.firstName``. You
+can use ``"-colname"`` or ``DESC(Person.q.firstName``) to specify
+descending order (this is translated to DESC, so it works on non-numeric
+types as well), or call ``MyClass.select().reversed()``. orderBy can also
+take a list of columns in the same format: ``["-weight", "name"]``.
You can use the special class variable `_defaultOrder` to give a
default ordering for all selects. To get an unordered result when
|