gnue/docbook/GNUeModuleGuide/chapters businesso...

[Neil Tiffin]

CVSROOT:        /home/cvs
Module name:    gnue
Changes by:     Neil Tiffin <address@hidden>    01/06/29 03:38:11

Modified files:
        docbook/GNUeModuleGuide/chapters: businessobjects.sgml 

Log message:
        Update for Order By syntax.

CVSWeb URLs:
http://savannah.gnu.org/cgi-bin/viewcvs/gnue/docbook/GNUeModuleGuide/chapters/businessobjects.sgml.diff?cvsroot=OldCVS&tr1=1.19&tr2=1.20&r1=text&r2=text

Patches:
Index: gnue/docbook/GNUeModuleGuide/chapters/businessobjects.sgml
diff -u gnue/docbook/GNUeModuleGuide/chapters/businessobjects.sgml:1.19 
gnue/docbook/GNUeModuleGuide/chapters/businessobjects.sgml:1.20
--- gnue/docbook/GNUeModuleGuide/chapters/businessobjects.sgml:1.19     Thu May 
31 10:25:01 2001
+++ gnue/docbook/GNUeModuleGuide/chapters/businessobjects.sgml  Fri Jun 29 
03:38:11 2001
@@ -7,7 +7,7 @@
                        Introduction 
                </title>
                <para>
-                       This chapter is $Id: businessobjects.sgml,v 1.19 
2001/05/31 17:25:01 ntiffin Exp $. 
+                       This chapter is $Id: businessobjects.sgml,v 1.20 
2001/06/29 10:38:11 ntiffin Exp $. 
                </para>
                <para>
                Quick links to the various sections.
@@ -19,6 +19,7 @@
                        <link linkend=extend endterm="extend.title"></link>
                        <link linkend=fields endterm="fields.title"></link>
                        <link linkend=include endterm="include.title"></link>
+                       <link linkend=orderby endterm="orderby.title"></link>
                        <link linkend=inheritance 
endterm="inheritance.title"></link>
                        <link linkend=list endterm="list.title"></link>
                        <link linkend=lookup endterm="lookup.title"></link>
@@ -569,6 +570,48 @@
        The second file will never ever get processed.
 </para>
                </sect2>
+               <sect2 id=orderby>
+                       <title id=include.title>
+                               ORDER BY
+                       </title>
+<para>
+Classes can have an 'order by' section, that causes all queries to be
+sorted on a given field. (er, should have been multiple fields - call that
+a TODO)
+</para>
+
+<para>
+       Syntax:
+
+</para>
+<programlisting>
+   ORDER BY <fieldname> [DESC];
+
+</programlisting>
+<para>
+       Examples:
+
+</para>
+
+<programlisting>
+class hello
+{
+    int32 field;
+    ORDER BY field;
+};
+
+class there
+{
+    int32 field;
+    ORDER BY field DESC;
+};
+
+</programlisting>
+<para>
+(with the query API - ie, the classes defined in query.idl - the 'DESC'
+option reverses the sort order.)               
+</para>
+</sect2>
                <sect2 id=lookup>
                        <title id=lookup.title>
                                LOOKUP