r6632 - trunk/gnue-appserver/doc/devguide

[reinhard]

Author: reinhard
Date: 2004-11-05 10:10:00 -0600 (Fri, 05 Nov 2004)
New Revision: 6632

Modified:
   trunk/gnue-appserver/doc/devguide/04-ui.texi
   trunk/gnue-appserver/doc/devguide/05-references.texi
Log:
Updated documentation with latest features.


Modified: trunk/gnue-appserver/doc/devguide/04-ui.texi
===================================================================
--- trunk/gnue-appserver/doc/devguide/04-ui.texi        2004-11-05 15:37:08 UTC 
(rev 6631)
+++ trunk/gnue-appserver/doc/devguide/04-ui.texi        2004-11-05 16:10:00 UTC 
(rev 6632)
@@ -23,7 +23,7 @@
 
 @example
 <module name="address" language="C">
-  <class name="person">
+  <class name="person" label="Address management">
     <property name="name"   pos="100" label="Name" />
     <property name="street" pos="200" label="Street" />
     <property name="zip"    pos="300" label="Zip-Code" />
@@ -50,6 +50,12 @@
 gnue-forms appserver://appserver/form/address_person
 @end example
 
+The @code{label} tag of the class defines the form title, the @code{label} tag
+of the properties tells GNU Enterprise about the labels to use for the several
+fields in the form. Fields are ordered by the number given in the @code{pos}
+attribute of the properties. Properties with @code{pos="0"} are not shown in
+the form at all.
+
 However, maybe English isn't your native language, and you want GNU Enterprise
 to display the form with translated labels.  No problem: just create a second
 file, for example @samp{address-de.gld} for German texts, exchange all labels

Modified: trunk/gnue-appserver/doc/devguide/05-references.texi
===================================================================
--- trunk/gnue-appserver/doc/devguide/05-references.texi        2004-11-05 
15:37:08 UTC (rev 6631)
+++ trunk/gnue-appserver/doc/devguide/05-references.texi        2004-11-05 
16:10:00 UTC (rev 6632)
@@ -34,11 +34,11 @@
 
 @example
 <module name="address" language="C">
-  <class name="country">
+  <class name="country" label="Country Codes">
     <property name="code"   pos="100" label="ISO Code" />
     <property name="name"   pos="200" label="Name" />
   </class>
-  <class name="person">
+  <class name="person" label="Address management">
     <property name="name"   pos="100" label="Name" />
     <property name="street" pos="200" label="Street" />
     <property name="zip"    pos="300" label="Zip-Code" />
@@ -127,3 +127,7 @@
 class, in our case the @samp{country} class. That means that @emph{every other
 class} referencing a country will show the @emph{same} dropdowns in the user
 interface.
+
+Additionally, a form generated by GNU Enterprise will always order the records
+by the property that was given the lowest number in the @code{search}
+attribute.