gnue forms/doc/techref.lyx reports/doc/Reportin...

[Jason Cater]

CVSROOT:        /cvsroot/gnue
Module name:    gnue
Changes by:     Jason Cater <address@hidden>    02/04/13 20:36:52

Modified files:
        forms/doc      : techref.lyx 
        reports/doc    : ReportingConcepts.lyx 

Log message:
        updates to documentation

CVSWeb URLs:
http://savannah.gnu.org/cgi-bin/viewcvs/gnue/gnue/forms/doc/techref.lyx.diff?tr1=1.15&tr2=1.16&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/gnue/gnue/reports/doc/ReportingConcepts.lyx.diff?tr1=1.1&tr2=1.2&r1=text&r2=text

Patches:
Index: gnue/forms/doc/techref.lyx
diff -c gnue/forms/doc/techref.lyx:1.15 gnue/forms/doc/techref.lyx:1.16
*** gnue/forms/doc/techref.lyx:1.15     Sun Mar 31 13:21:05 2002
--- gnue/forms/doc/techref.lyx  Sat Apr 13 20:36:51 2002
***************
*** 374,384 ****
   able to be configured to cache records in memory.
   The application developer will have control over the number of records
   cached to allow them to balance memory usage vs system responsiveness.
!  Currently the cache system in GNUe is in reallity a pre-fetch system.
   When large numbers of records are requested from the database the system
!  will fetch only the user specified cache amout at a time.
!  When the user moves beyond the number of records in memory the system will
!  automatically fetch another group of records.
   This allows the system to respond rapidly to user requests involving large
   number of records.
   
--- 374,392 ----
   able to be configured to cache records in memory.
   The application developer will have control over the number of records
   cached to allow them to balance memory usage vs system responsiveness.
!  Currently the cache system in GNUe is, in reality, a pre-fetch system.
   When large numbers of records are requested from the database the system
!  will fetch only the user-specified 
! \begin_inset Quotes eld
! \end_inset 
! 
! cache amount
! \begin_inset Quotes erd
! \end_inset 
! 
!  at a time.
!  When the user moves beyond the number of records in memory, the system
!  will automatically fetch another group of records.
   This allows the system to respond rapidly to user requests involving large
   number of records.
   
***************
*** 390,397 ****
  Triggers contain scripts of code that execute during specific events which
   "fire" the triggers.
   They can be attached to any of the components of the virtual form though
!  some trigger events may not pertain to the compontent and thus will never
!  fire.
  \layout Standard
  
  
--- 398,405 ----
  Triggers contain scripts of code that execute during specific events which
   "fire" the triggers.
   They can be attached to any of the components of the virtual form though
!  some trigger events may not pertain to the component and, as such, will
!  never fire.
  \layout Standard
  
  
***************
*** 469,476 ****
   
  \layout Itemize
  
! Pre-Commit - Fires prior to commiting data into persistant storage.
!  If the return value of the script is False then the commit will be aborted.
  \layout Itemize
  
  Post-Commit - Fires after data has been commited.
--- 477,551 ----
   
  \layout Itemize
  
! Pre-Commit - Fires once, for each record in the block marked as either 
! \begin_inset Quotes eld
! \end_inset 
! 
! new
! \begin_inset Quotes erd
! \end_inset 
! 
! , 
! \begin_inset Quotes eld
! \end_inset 
! 
! updated
! \begin_inset Quotes erd
! \end_inset 
! 
! , or 
! \begin_inset Quotes eld
! \end_inset 
! 
! deleted
! \begin_inset Quotes erd
! \end_inset 
! 
! , prior to commiting the record into persistant storage.
!  In the future, if the return value of the script is False then the commit
!  will be aborted.
! \layout Itemize
! 
! Pre-Insert - Fires once, for each record in the block marked as 
! \begin_inset Quotes eld
! \end_inset 
! 
! new
! \begin_inset Quotes erd
! \end_inset 
! 
! , and commiting the record into persistant storage.
!  In the future, if the return value of the script is False then the commit
!  will be aborted.
!  This event is called prior to the pre-commit event.
! \layout Itemize
! 
! Pre-Update - Fires once, for each record in the block marked as 
! \begin_inset Quotes eld
! \end_inset 
! 
! updated
! \begin_inset Quotes erd
! \end_inset 
! 
! , prior to updating and commiting the record into persistant storage.
!  In the future, if the return value of the script is False then the commit
!  will be aborted.
!  This event is called prior to the pre-commit event.
! \layout Itemize
! 
! Pre-Delete - Fires once, for each record in the block marked as 
! \begin_inset Quotes eld
! \end_inset 
! 
! deleted
! \begin_inset Quotes erd
! \end_inset 
! 
! , prior to deleting and commiting the record into persistant storage.
!  In the future, if the return value of the script is False then the commit
!  will be aborted.
!  This event is called prior to the pre-commit event.
  \layout Itemize
  
  Post-Commit - Fires after data has been commited.
***************
*** 4410,4417 ****
  
  \lang english
  Causes the datasource to load all data from the table into memory.
!  Usefull for validation purposes and obtaining values to dropdown style
!  entry objects.
  \end_inset 
  </cell>
  </row>
--- 4485,4492 ----
  
  \lang english
  Causes the datasource to load all data from the table into memory.
!  Useful for validation purposes and obtaining values to dropdown style entry
!  objects.
  \end_inset 
  </cell>
  </row>
Index: gnue/reports/doc/ReportingConcepts.lyx
diff -c gnue/reports/doc/ReportingConcepts.lyx:1.1 
gnue/reports/doc/ReportingConcepts.lyx:1.2
*** gnue/reports/doc/ReportingConcepts.lyx:1.1  Fri Apr 12 14:57:06 2002
--- gnue/reports/doc/ReportingConcepts.lyx      Sat Apr 13 20:36:51 2002
***************
*** 27,39 ****
  GNUe Reporting Concepts
  \layout Author
  
! Jason Cater 
  \layout Date
  
  April 12, 2002
  \layout Abstract
  
! Technical reference for the GNUe Reports file format.
  \layout Standard
  
  
--- 27,40 ----
  GNUe Reporting Concepts
  \layout Author
  
! GNUe Team
  \layout Date
  
  April 12, 2002
  \layout Abstract
  
! Understanding the GNUe Reports reporting engine.
!  
  \layout Standard
  
  
***************
*** 51,63 ****
  \layout Section
  
  Datasources
  \layout Subsection
  
! Overview
  \layout Standard
  
! See forms tech ref...
!  datasources use common code.
  \layout Section
  
  Parameters
--- 52,106 ----
  \layout Section
  
  Datasources
+ \layout Standard
+ 
+ 
+ \lang american
+ A datasource contains records and fields of information.
+  Typically it is linked to a defined database and associates itself with
+  a specific source, like a table, in that database.
+  However it is possible to have datasources that have no database link 
defined.
+  These types of datasources cannot provide persistance to the information
+  stored within themself.
+  Typically, only data-bound datasources will be used in reports.
  \layout Subsection
  
! 
! \lang american
! Master/Detail Relationships
! \layout Standard
! 
! 
! \lang american
! Datasources can also be associated with other datasoure in what we call
!  a Master/Detail relationship.
!  A master datasource has one or more detail datasources associated with
!  itself.
!  These detail datasources contain a foreign key which points back to a 
specific
!  master datasource/field key.
!  It's worth noting that a datasource can be both a detail and master 
datasource
!  simultaneously.
! \layout Subsection
! 
! 
! \lang american
! Record Caching/Prefetch
  \layout Standard
  
! 
! \lang american
! In an effort to improve system performance datasources will eventually be
!  able to be configured to cache records in memory.
!  The application developer will have control over the number of records
!  cached to allow them to balance memory usage vs system responsiveness.
!  Currently the cache system in GNUe is, in reality, a pre-fetch system.
!  When large numbers of records are requested from the database the system
!  will fetch only the user specified cache amount at a time.
!  When the report moves beyond the number of records in memory, the system
!  will automatically fetch another group of records.
!  This allows the system to respond rapidly to requests involving large number
!  of records.
!  
  \layout Section
  
  Parameters
***************
*** 69,86 ****
  \layout Section
  
  Sorting Options
! \layout Standard
  
  Sorting Options are not fully supported in GNUe Reports.
   This will be added in an upcoming release.
   
  \layout Section
  
  Triggers
! \layout Standard
  
  Triggers are not currently supported in GNUe Reports.
   This will be added in an upcoming release.
  \layout Section
  
  Standard Layout Elements
--- 112,281 ----
  \layout Section
  
  Sorting Options
! \layout Subparagraph
  
  Sorting Options are not fully supported in GNUe Reports.
   This will be added in an upcoming release.
   
+ \layout Standard
+ 
+ Sorting options allow...
  \layout Section
  
  Triggers
! \layout Subparagraph
  
  Triggers are not currently supported in GNUe Reports.
   This will be added in an upcoming release.
+  
+ \layout Standard
+ 
+ See the Forms Technical Reference for an understanding of 
+ \layout Standard
+ 
+ 
+ \lang american
+ Triggers contain scripts of code that execute during specific events which
+  "fire" the triggers.
+  They can be attached to any of the components of the virtual form though
+  some trigger events may not pertain to the component and, as such, will
+  never fire.
+ \layout Standard
+ 
+ 
+ \series bold 
+ \lang american
+ Not implemented yet: 
+ \series default 
+ Triggers normally return a True value upon sucessful completion.
+  It is possible for the trigger script to return True or False values to
+  influence the applications behaviour.
+ \layout Subsection
+ 
+ 
+ \lang american
+ Trigger Languages
+ \layout Standard
+ 
+ 
+ \lang american
+ Currently, trigger scripts must be written in python.
+  We would like to increase the number of supported languages as time permits.
+ \layout Subsection
+ 
+ 
+ \lang american
+ Trigger Events
+ \layout Standard
+ 
+ 
+ \lang american
+ The following triggers are either implemented or planned for implementation
+  in the GNUe Forms system.
+ 
+ \series bold 
+  
+ \series default 
+ Unless specifically mentioned the return value of the script will not effect
+  the application in any way.
+ \layout Subsubsection
+ 
+ 
+ \lang american
+ Implemented
+ \layout Standard
+ 
+ 
+ \lang american
+ No trigger events have been implemented.
+  
+ \layout Subsubsection
+ 
+ 
+ \lang american
+ Not Implemented
+ \layout Standard
+ 
+ 
+ \lang american
+ These triggers are not yet implemented.
+  Plans for these triggers may change prior to implementation.
+  Use this section only as a tool to understand our conceptual plans.
+ \layout Standard
+ 
+ 
+ \series bold 
+ \lang american
+ Entry 
+ \layout Itemize
+ 
+ 
+ \series bold 
+ \lang american
+ On-New-Value
+ \series default 
+  - Fires when a new value is queried.
+  ?????
+ \layout Standard
+ 
+ 
+ \series bold 
+ \lang american
+ Summary 
+ \layout Itemize
+ 
+ 
+ \series bold 
+ \lang american
+ Pre-Calculate
+ \series default 
+  - Fires prior to the summary being calcuated.
+  ?????
+ \layout Itemize
+ 
+ 
+ \series bold 
+ \lang american
+ Post-Calculate
+ \series default 
+  - Fires following the summary being calcuated.
+  ?????
+ \layout Standard
+ 
+ 
+ \series bold 
+ \lang american
+ Section/Layout
+ \layout Itemize
+ 
+ 
+ \series bold 
+ \lang american
+ Pre-Process
+ \series default 
+  - Fires prior to selecting any records ?????
+ \layout Itemize
+ 
+ 
+ \series bold 
+ \lang american
+ On-Select
+ \series default 
+  - Fires when a new record is queried.
+  ?????
+ \layout Itemize
+ 
+ 
+ \series bold 
+ \lang american
+ Post-Process
+ \series default 
+  - Fires after selecting and processing all records ?????
+ \layout Description
+ 
+ 
+ \lang american
+ On-newrecord Fires whenever a new record is created.
  \layout Section
  
  Standard Layout Elements
***************
*** 489,492 ****
--- 684,2197 ----
  \layout Code
  
  ...
+ \layout Section
+ \start_of_appendix 
+ 
+ \emph on 
+ GNUe Reports Definition
+ \emph default 
+  (GRD) File Format
+ \layout Subsection
+ 
+ 
+ \lang american
+ <report>
+ \layout Subsubsection
+ 
+ 
+ \lang american
+ Attributes
+ \layout Standard
+ 
+ 
+ \lang american
+ 
+ \begin_inset  Tabular
+ <lyxtabular version="2" rows="10" columns="4">
+ <features rotate="false" islongtable="false" endhead="0" endfirsthead="0" 
endfoot="0" endlastfoot="0">
+ <column alignment="center" valignment="top" leftline="true" rightline="false" 
width="" special="">
+ <column alignment="center" valignment="top" leftline="true" rightline="false" 
width="" special="">
+ <column alignment="center" valignment="top" leftline="true" rightline="false" 
width="" special="">
+ <column alignment="left" valignment="top" leftline="true" rightline="true" 
width="" special="">
+ <row topline="true" bottomline="true" newpage="false">
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ Attribute
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ Datatype
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ Default
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ Description
+ \end_inset 
+ </cell>
+ </row>
+ <row topline="true" bottomline="false" newpage="false">
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ title
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ string
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ none
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ The title of the form.
+  Will be displayed on About Screen.
+ \end_inset 
+ </cell>
+ </row>
+ <row topline="true" bottomline="false" newpage="false">
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ width
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ int
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ 10
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ The width of the object in text columns.
+ \end_inset 
+ </cell>
+ </row>
+ <row topline="true" bottomline="false" newpage="false">
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ height
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ int
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ 1
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ The height of the object in text rows.
+ \end_inset 
+ </cell>
+ </row>
+ <row topline="true" bottomline="false" newpage="false">
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ author
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ string
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ none
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ The name of the author of the form.
+  Will be displayed on About Screen
+ \end_inset 
+ </cell>
+ </row>
+ <row topline="true" bottomline="false" newpage="false">
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ version
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ string
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ none
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ The specific version number of the form.
+  Will be displayed on About Screen
+ \end_inset 
+ </cell>
+ </row>
+ <row topline="true" bottomline="false" newpage="false">
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ description
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ string
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ none
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ A brief description of the form to be displayed on About screen.
+ \end_inset 
+ </cell>
+ </row>
+ <row topline="true" bottomline="false" newpage="false">
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ 
+ \lang american
+ tabbed
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ 
+ \lang american
+ string
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ 
+ \lang american
+ none
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ 
+ \lang american
+ Allows a form to convert it's pages as notebook tabs.
+  Allowed values are left, right, bottom, top.
+ \end_inset 
+ </cell>
+ </row>
+ <row topline="true" bottomline="false" newpage="false">
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ requireGUI
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ boolean
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ FALSE
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ 
+ \series bold 
+ NOT IMPLEMENTED YET:
+ \series default 
+  If defined the client will abort the form if it is unable to provide 
graphical
+  display
+ \end_inset 
+ </cell>
+ </row>
+ <row topline="true" bottomline="true" newpage="false">
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ noTriggerDownload
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ boolean
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ FALSE
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ 
+ \series bold 
+ NOT IMPLEMENTED YET: 
+ \series default 
+ If defined the client will not attempt to ask the server for triggers to
+  download
+ \end_inset 
+ </cell>
+ </row>
+ </lyxtabular>
+ 
+ \end_inset 
+ 
+ 
+ \layout Subsubsection
+ 
+ 
+ \lang american
+ Example
+ \layout Code
+ 
+ 
+ \lang american
+ <form title=
+ \begin_inset Quotes erd
+ \end_inset 
+ 
+ My Form
+ \begin_inset Quotes erd
+ \end_inset 
+ 
+  width=
+ \begin_inset Quotes erd
+ \end_inset 
+ 
+ 40
+ \begin_inset Quotes erd
+ \end_inset 
+ 
+  height=
+ \begin_inset Quotes erd
+ \end_inset 
+ 
+ 40
+ \begin_inset Quotes erd
+ \end_inset 
+ 
+ >
+ \layout Code
+ 
+ 
+ \emph on 
+ \lang american
+ Rest of form logic goes here
+ \layout Code
+ 
+ 
+ \lang american
+ </form>
+ \layout Subsection
+ 
+ 
+ \lang american
+ <page>
+ \layout Subsubsection
+ 
+ 
+ \lang american
+ Attributes
+ \layout Standard
+ 
+ 
+ \lang american
+ 
+ \begin_inset  Tabular
+ <lyxtabular version="2" rows="2" columns="4">
+ <features rotate="false" islongtable="false" endhead="0" endfirsthead="0" 
endfoot="0" endlastfoot="0">
+ <column alignment="center" valignment="top" leftline="true" rightline="false" 
width="" special="">
+ <column alignment="center" valignment="top" leftline="true" rightline="false" 
width="" special="">
+ <column alignment="center" valignment="top" leftline="true" rightline="false" 
width="" special="">
+ <column alignment="left" valignment="top" leftline="true" rightline="true" 
width="" special="">
+ <row topline="true" bottomline="true" newpage="false">
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ Attribute
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ Datatype
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ Default
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ Description
+ \end_inset 
+ </cell>
+ </row>
+ <row topline="true" bottomline="false" newpage="false">
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ 
+ \lang american
+ name
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ string
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ none
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ 
+ \lang american
+ A unique ID for the widget.
+  This is only useful when importing pages from a library.
+ \end_inset 
+ </cell>
+ </row>
+ </lyxtabular>
+ 
+ \end_inset 
+ 
+ 
+ \layout Subsubsection
+ 
+ 
+ \lang american
+ Example
+ \layout Standard
+ 
+ 
+ \lang american
+ <page name=
+ \begin_inset Quotes erd
+ \end_inset 
+ 
+ page1
+ \begin_inset Quotes erd
+ \end_inset 
+ 
+ >
+ \layout Standard
+ 
+ 
+ \emph on 
+ \lang american
+ Objects that should be on this page go in here
+ \layout Standard
+ 
+ 
+ \lang american
+ </page>
+ \layout Standard
+ 
+ 
+ \lang american
+ <page>
+ \layout Standard
+ 
+ 
+ \emph on 
+ \lang american
+ Objects that should be on this page go in here
+ \layout Standard
+ 
+ 
+ \lang american
+ </page>
+ \layout Subsection
+ 
+ 
+ \lang american
+ <block>
+ \layout Subsubsection
+ 
+ 
+ \lang american
+ Attributes
+ \layout Standard
+ 
+ 
+ \lang american
+ 
+ \begin_inset  Tabular
+ <lyxtabular version="2" rows="8" columns="4">
+ <features rotate="false" islongtable="false" endhead="0" endfirsthead="0" 
endfoot="0" endlastfoot="0">
+ <column alignment="center" valignment="top" leftline="true" rightline="false" 
width="" special="">
+ <column alignment="center" valignment="top" leftline="true" rightline="false" 
width="" special="">
+ <column alignment="center" valignment="top" leftline="true" rightline="false" 
width="" special="">
+ <column alignment="left" valignment="top" leftline="true" rightline="true" 
width="" special="">
+ <row topline="true" bottomline="true" newpage="false">
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ Attribute
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ Datatype
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ Default
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ Description
+ \end_inset 
+ </cell>
+ </row>
+ <row topline="true" bottomline="false" newpage="false">
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ name
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ string
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ none
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="left" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ A unique ID for the widget.The name of the widget.
+  No blocks or datasources can share the same name without causing namespace
+  collisions in user triggers.
+ \end_inset 
+ </cell>
+ </row>
+ <row topline="true" bottomline="false" newpage="false">
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ datasource
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ string
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ none
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ The name of a datasource (defined in by a <datasource> tag.) that provides
+  this block with it's data.
+ \end_inset 
+ </cell>
+ </row>
+ <row topline="true" bottomline="false" newpage="false">
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ restrictDelete
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ boolean
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ none
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ If set then the user will be unable to request that a record be deleted
+  via the user interface.
+ \end_inset 
+ </cell>
+ </row>
+ <row topline="true" bottomline="false" newpage="false">
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ 
+ \lang american
+ restrictInsert
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ 
+ \lang american
+ boolean
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ 
+ \lang american
+ none
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ 
+ \lang american
+ If set then the user will be unable to request that new records be inserted
+  into the block
+ \end_inset 
+ </cell>
+ </row>
+ <row topline="true" bottomline="false" newpage="false">
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ 
+ \lang american
+ transparentBlock
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ 
+ \lang american
+ boolean
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ 
+ \lang american
+ none
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ 
+ \lang american
+ If set then the you can tab out of the block via next or previous field
+  events.
+  Makes navigation in mutliblock forms easier.
+  
+ \end_inset 
+ </cell>
+ </row>
+ <row topline="true" bottomline="false" newpage="false">
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ 
+ \lang american
+ rows
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ 
+ \lang american
+ int
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ 
+ \lang american
+ 1
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ 
+ \lang american
+ Any widgets inside the block will display this number of copies in a verticle
+  column.
+  Simulates a very crude grid entry system.
+  Serves the same purpose as the visibleCount attribute on some widgets.
+ \end_inset 
+ </cell>
+ </row>
+ <row topline="true" bottomline="true" newpage="false">
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ 
+ \lang american
+ rowSpacer
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ 
+ \lang american
+ int
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ 
+ \lang american
+ 1
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ 
+ \lang american
+ Adjusts the verticle gap of this number of rows between duplicated widgets.
+  Serves the same purpose as some of the gap attributes on individual widgets.
+ \end_inset 
+ </cell>
+ </row>
+ </lyxtabular>
+ 
+ \end_inset 
+ 
+ 
+ \layout Subsubsection
+ 
+ 
+ \lang american
+ Example
+ \layout Standard
+ 
+ 
+ \lang american
+ <block name="cities" datasource="city" master="state.st_code" detail="state">
+ \layout Standard
+ 
+ 
+ \emph on 
+ \lang american
+ label and entry objects that are part of this block go here
+ \layout Standard
+ 
+ 
+ \lang american
+ </block>
+ \layout Standard
+ 
+ 
+ \lang american
+ The cities block defined in the above example is a detail block.
+  It is linked to a datasource named city and it keeps the data displayed
+  within itself in sync with the block named state.
+  It does this by monitoring the entry named st_code in the state block,
+  when that data changes it sets the entry within itself named state to match
+  the value stored in st_code as querying data from the datasource.
+ \layout Subsection
+ 
+ 
+ \lang american
+ <label>
+ \layout Subsubsection
+ 
+ 
+ \lang american
+ Attributes
+ \layout Standard
+ 
+ 
+ \lang american
+ 
+ \begin_inset  Tabular
+ <lyxtabular version="2" rows="9" columns="4">
+ <features rotate="false" islongtable="false" endhead="0" endfirsthead="0" 
endfoot="0" endlastfoot="0">
+ <column alignment="center" valignment="top" leftline="true" rightline="false" 
width="" special="">
+ <column alignment="center" valignment="top" leftline="true" rightline="false" 
width="" special="">
+ <column alignment="center" valignment="top" leftline="true" rightline="false" 
width="" special="">
+ <column alignment="left" valignment="top" leftline="true" rightline="true" 
width="" special="">
+ <row topline="true" bottomline="true" newpage="false">
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ Attribute
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ Datatype
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ Default
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ Description
+ \end_inset 
+ </cell>
+ </row>
+ <row topline="true" bottomline="false" newpage="false">
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ x
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ int
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ none
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ The text column starting position of the widget .
+  Based upon leftmost column of screen being 0.\SpecialChar ~
+ 
+ \end_inset 
+ </cell>
+ </row>
+ <row topline="true" bottomline="false" newpage="false">
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ y
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ int
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ none
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ The text row starting position of the widget.
+  Based upon the top row of the screen being 0.
+ \end_inset 
+ </cell>
+ </row>
+ <row topline="true" bottomline="false" newpage="false">
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ text
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ string
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ none
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ The text to be displayed.
+ \end_inset 
+ </cell>
+ </row>
+ <row topline="true" bottomline="false" newpage="false">
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ width
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ int
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ 10
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ The width of the label in text columns.
+  Defaults to the width of the text.
+  Only really usefull when used with the justification attribute.
+ \end_inset 
+ </cell>
+ </row>
+ <row topline="true" bottomline="false" newpage="false">
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ 
+ \lang american
+ alignment
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ string
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ left
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ The justification of the label.
+  Can be one of the following left, right, or center.
+  Requires that the width attribute be set.
+ \end_inset 
+ </cell>
+ </row>
+ <row topline="true" bottomline="false" newpage="false">
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ 
+ \lang american
+ rows
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ 
+ \lang american
+ int
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ 
+ \lang american
+ 1
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ 
+ \lang american
+ Overrides the rows setting defined at the block level.
+  
+ \end_inset 
+ </cell>
+ </row>
+ <row topline="true" bottomline="false" newpage="false">
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ 
+ \lang american
+ rowSpacer
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ 
+ \lang american
+ int
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ 
+ \lang american
+ 1
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ 
+ \lang american
+ Overriders the rowSpace setting defined at the block level.
+ \end_inset 
+ </cell>
+ </row>
+ <row topline="true" bottomline="true" newpage="false">
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ name
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ string
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ none
+ \end_inset 
+ </cell>
+ <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
+ \begin_inset Text
+ 
+ \layout Standard
+ 
+ The unique ID of the label.
+ \end_inset 
+ </cell>
+ </row>
+ </lyxtabular>
+ 
+ \end_inset 
+ 
+ 
+ \layout Subsubsection
+ 
+ 
+ \lang american
+ Example
+ \layout Section
+ 
+ 
+ \lang american
+ The 
+ \emph on 
+ grrun
+ \emph default 
+  Command-line Client
+ \layout Verbatim
+ 
+ 
+ \lang american
+ \SpecialChar ~
+ 
+ \layout Verbatim
+ 
+ 
+ \lang american
+ GNUe Reports Client Version 0.0.1
+ \layout Verbatim
+ 
+ 
+ \lang american
+ Usage: grrun [options] file [param1=val] [param2=val] [...]
+ \layout Verbatim
+ 
+ 
+ \lang american
+ GNUe Reports is the primary reporting agent of the GNU Enterprise system.
+ \layout Verbatim
+ 
+ 
+ \lang american
+ Available command line options:
+ \layout Verbatim
+ 
+ 
+ \lang american
+ --comment, -C Include structural comments in the XML output stream.
+  Useful for debugging .grd files.
+ \layout Verbatim
+ 
+ 
+ \lang american
+ --connections <loc> Specifies the location of the connection definition
+  file.
+  <loc> may specify a file name (/usr/local/gnue/etc/connections.conf), or
+  a URL location (http://localhost/connections.conf).
+  If this option is not specified, the environent variable GNUE_CONNECTIONS
+  is checked.
+ \layout Verbatim
+ 
+ 
+ \lang american
+ --debug-file <file> Sends all debugging messages to a specified file (e.g.,
+  "--debug-file trace.log" sends all output to "trace.log")
+ \layout Verbatim
+ 
+ 
+ \lang american
+ --debug-level <level> Enables debugging messages.
+  Argument specifies the level of messages to display (e.g., "--debug-level
+  5" displays all debugging messages at level 5 or below.)
+ \layout Verbatim
+ 
+ 
+ \lang american
+ --destination <dest>, -d Where should the report be output to? The value
+  of this depends on the destination type (e.g., if sending to printer, then
+  -d specifies the printer name; if sending via email, then -d specifies
+  the email address.) If <dest> is "-", then output is sent to stdout -- NOTE:
+  when sending to stdout, also use the -q [--quiet] option or you may get
+  junk in your output stream.
+  NOTE: Currently the default value is "-" -- this may change once GNUe Reports
+  is formally released!
+ \layout Verbatim
+ 
+ 
+ \lang american
+ --destination-options <opts> Options to pass to the destination process.
+  Available options are specific to the type of destination.
+  Example: '--destination-options "-o nobanner" '
+ \layout Verbatim
+ 
+ 
+ \lang american
+ --destination-type <type>, -D This specifies how the report should be output.
+  The currently supported values for <type> are file [default], printer,
+  email, and fax.
+  Note that printer, email, and fax are sent via the server's machine, not
+  the client's machine.
+  To NOTE: Only file, printer, and email are currently implemented!
+ \layout Verbatim
+ 
+ 
+ \lang american
+ --exclude-xml, -X Do not output GNUe Reports runtime XML markup information.
+  If specified, then the GRDs layout section will be processed and output
+  as-is; i.e., without any additional information added by GNUe Reports.
+ \layout Verbatim
+ 
+ 
+ \lang american
+ --filter <filt>, -f Select the filter to be used to process report output.
+  <filt> is the name of the filtering process as defined on the Report Server
+  machine.
+  If not specified, the "raw" filter is used (i.e., no filtering takes place.)
+ \layout Verbatim
+ 
+ 
+ \lang american
+ --filter-list List the available [predefined] filters available to GNUe
+  Reports
+ \layout Verbatim
+ 
+ 
+ \lang american
+ --filter-options <opts>, -F Options to pass to the filter process.
+  Available options are specific to the filter.
+  --filter-list will list available filters and their options.
+  Example: '--filter-options "paper=letter margin=1,1,1,1" '
+ \layout Verbatim
+ 
+ 
+ \lang american
+ --help Displays this help screen.
+ \layout Verbatim
+ 
+ 
+ \lang american
+ --interactive-debugger Run the app inside Python's built-in debugger
+ \layout Verbatim
+ 
+ 
+ \lang american
+ --pass <passwd> Password used to log into the database.
+  Note that if specified, this will be used for all databases.
+  If not supplied, the program will prompt for password.
+  NOTE: SUPPLYING A PASSWORD VIA THE COMMAND LINE MAY BE CONSIDERED A SECURITY
+  RISK.
+ \layout Verbatim
+ 
+ 
+ \lang american
+ --profile Run Python's built-in profiler and display the resulting run 
statistic
+ s.
+ \layout Verbatim
+ 
+ 
+ \lang american
+ --quiet, -q Run GNUe Reports in quiet mode -- i.e., display no output.
+  NOTE: if --debug-level is specified, then suppressed text will be output
+  as debugging information (at debug level 1)
+ \layout Verbatim
+ 
+ 
+ \lang american
+ --sort <sort>, -s Select the "sort-option" used to sort the report.
+ \layout Verbatim
+ 
+ 
+ \lang american
+ --standalone, -S Create a standalone, single-use server instance.
+  Use this option in a non-client/server environment or in a 
debugging/developmen
+ t environment.
+  NOTE: Until the Reports Server is operational, this mode is implied
+ \layout Verbatim
+ 
+ 
+ \lang american
+ --user <name>, -u Username used to log into the database.
+  Note that if specified, this will be used for all databases.
+  If not supplied, the program will prompt for username.
+ \layout Verbatim
+ 
+ 
+ \lang american
+ --version Displays the version information for this program.
+ \layout Verbatim
+ 
+ 
+ \lang american
+ Report bugs to address@hidden
+ \layout Verbatim
+ 
  \the_end