gnue/designer/doc DevelopersGuide-Forms.lyx

[Jason Cater]

CVSROOT:        /cvsroot/gnue
Module name:    gnue
Changes by:     Jason Cater <address@hidden>    02/01/07 19:03:07

Modified files:
        designer/doc   : DevelopersGuide-Forms.lyx 

Log message:
        added text on general concepts, portability, and field formatting 
(masks) to developers guide

CVSWeb URLs:
http://savannah.gnu.org/cgi-bin/viewcvs/gnue/gnue/designer/doc/DevelopersGuide-Forms.lyx.diff?tr1=1.1&tr2=1.2&r1=text&r2=text

Patches:
Index: gnue/designer/doc/DevelopersGuide-Forms.lyx
diff -c gnue/designer/doc/DevelopersGuide-Forms.lyx:1.1 
gnue/designer/doc/DevelopersGuide-Forms.lyx:1.2
*** gnue/designer/doc/DevelopersGuide-Forms.lyx:1.1     Thu Nov 15 01:42:12 2001
--- gnue/designer/doc/DevelopersGuide-Forms.lyx Mon Jan  7 19:03:07 2002
***************
*** 27,38 ****
  GNUe Designer: Form Developer's Guide
  \layout Abstract
  
! This is version 0.1.0 of the Form Developer's Guide; it covers GNUe Designer
!  0.1.0.
!  
! \layout Abstract
  
- This document is covered by the GNU Free Documentation License Version 1.1
  \layout Section
  
  Introduction
--- 27,44 ----
  GNUe Designer: Form Developer's Guide
  \layout Abstract
  
! This is version 0.1.1 of the Form Developer's Guide; it covers GNUe Designer
!  0.1.1 and GNUe Forms 0.1.1.
!  This document is covered by the GNU Free Documentation License Version
!  1.1
! \layout Standard
! 
! 
! \begin_inset LatexCommand \tableofcontents{}
! 
! \end_inset 
! 
  
  \layout Section
  
  Introduction
***************
*** 201,283 ****
  \layout Subsection
  
  Data Sources
  \layout Subsection
  
  Blocks and Entries
  \layout Subsection
  
  Pages and Visual Elements
  \layout Subsection
  
  Designing for Multiple Architectures
  \layout Section
  
  Creating Your First Form
  \layout Subsection
  
  Overview
  \layout Subsection
  
  Creating the Data Sources
  \layout Subsection
  
  Creating the Pages
  \layout Subsection
  
  Creating the Blocks
  \layout Subsection
  
  Creating Entries
  \layout Subsection
  
! Layout out the Pages
  \layout Subsection
  
  Running the Form
  \layout Section
  
  Working with Master/Detail
  \layout Subsection
  
  Overview
  \layout Subsection
  
  Defining Master/Detail Data Sources
  \layout Subsection
  
  Master/Detail Considerations
  \layout Subsection
  
  Advanced Relationships
  \layout Subsubsection
  
  Master/Detail/Detail
  \layout Subsubsection
  
  Reverse Master/Detail
  \layout Section
  
  Understanding Events
  \layout Subsection
  
  Overview
  \layout Subsection
  
  Form's Event Model
! \layout Subsection
  
! Designing for Multiple Interfaces
  \layout Section
  
  Integration with other GNUe Tools
  \layout Subsection
  
  Running Reports
  \layout Section
  
  Advanced Topics
  \layout Section
! \start_of_appendix 
  Writing Custom Wizards
  \layout Subsection
  
--- 207,1327 ----
  \layout Subsection
  
  Data Sources
+ \layout Standard
+ 
+ A Data Source links data to our form.
+  Usually, a data source points to a table if using a relational database,
+  or a data object if using an object database.
+  A form can have several data sources if pulling data from multiple locations,
+  or no data sources at all if the form does not reference outside data.
+  
+ \layout Standard
+ 
+ If a form does not have a data source, a virtual data source is created.
+  The commit, rollback, and query functions do not serve a purpose against
+  virtual data sources.
+  This is particularly useful for 
+ \begin_inset Quotes eld
+ \end_inset 
+ 
+ action
+ \begin_inset Quotes erd
+ \end_inset 
+ 
+  forms that simply cause actions to occur, but do not directly manipulate
+  data.
+ \layout Standard
+ 
+ Data Sources can be linked to each other in a master/detail fashion via
+  a foreign key.
+  In essence, each time the 
+ \begin_inset Quotes eld
+ \end_inset 
+ 
+ master
+ \begin_inset Quotes erd
+ \end_inset 
+ 
+  data source changes, the 
+ \begin_inset Quotes eld
+ \end_inset 
+ 
+ detail
+ \begin_inset Quotes erd
+ \end_inset 
+ 
+  data source is automatically requeried to bring up records related to the
+  
+ \begin_inset Quotes eld
+ \end_inset 
+ 
+ master
+ \begin_inset Quotes erd
+ \end_inset 
+ 
+ .
+  See the chapter on master/detail relationships for more information.
+  
  \layout Subsection
  
  Blocks and Entries
+ \layout Standard
+ 
+ TODO
  \layout Subsection
  
  Pages and Visual Elements
+ \layout Standard
+ 
+ TODO
  \layout Subsection
  
  Designing for Multiple Architectures
+ \layout Standard
+ 
+ TODO
  \layout Section
  
  Creating Your First Form
  \layout Subsection
  
  Overview
+ \layout Standard
+ 
+ In this chapter, we will create our first full-featured form.
+  
  \layout Subsection
  
  Creating the Data Sources
+ \layout Standard
+ 
+ TODO
  \layout Subsection
  
  Creating the Pages
+ \layout Standard
+ 
+ TODO
  \layout Subsection
  
  Creating the Blocks
+ \layout Standard
+ 
+ TODO
  \layout Subsection
  
  Creating Entries
+ \layout Standard
+ 
+ TODO
  \layout Subsection
  
! Laying out the Pages
! \layout Standard
! 
! TODO
  \layout Subsection
  
  Running the Form
+ \layout Standard
+ 
+ TODO
  \layout Section
  
  Working with Master/Detail
  \layout Subsection
  
  Overview
+ \layout Standard
+ 
+ TODO
  \layout Subsection
  
  Defining Master/Detail Data Sources
+ \layout Standard
+ 
+ TODO
  \layout Subsection
  
  Master/Detail Considerations
+ \layout Standard
+ 
+ TODO
  \layout Subsection
  
  Advanced Relationships
  \layout Subsubsection
  
  Master/Detail/Detail
+ \layout Standard
+ 
+ TODO
  \layout Subsubsection
  
  Reverse Master/Detail
+ \layout Standard
+ 
+ TODO
  \layout Section
  
  Understanding Events
  \layout Subsection
  
  Overview
+ \layout Standard
+ 
+ TODO
  \layout Subsection
  
  Form's Event Model
! \layout Standard
  
! TODO
  \layout Section
  
  Integration with other GNUe Tools
  \layout Subsection
  
+ Calling Forms in Navigator
+ \layout Standard
+ 
+ TODO
+ \layout Subsection
+ 
  Running Reports
+ \layout Standard
+ 
+ TODO
  \layout Section
  
  Advanced Topics
+ \layout Subsection
+ 
+ Formatting Fields
+ \layout Subsubsection
+ 
+ Overview
+ \layout Standard
+ 
+ Forms supports two types of format masks: display masks and input masks.
+  A display mask defines how the field data will be formatted for display.
+  An input mask defines how the user will edit a field's value.
+  Input mask elements are a subset of display mask elements -- in other words,
+  all input masks can also be used as display masks, but not all display
+  masks can be used as input masks.
+  
+ \layout Standard
+ 
+ Note: if first character of a format is '&', then rest of date defines a
+  preset format (settable by developer? in gnue.conf or geas?).
+ \layout Standard
+ 
+ e.g., in gnue.conf:
+ \layout Standard
+ 
+ FormatDate_longdate = "A, b d, Y"
+ \layout Standard
+ 
+ Then, in the client, the format string could be:
+ \layout Standard
+ 
+ "&longdate"
+ \layout Standard
+ 
+ This allows reuse of common format masks throughout the application.
+ \layout Subsubsection
+ 
+ Formatting Numeric Fields
+ \layout Standard
+ 
+ TODO
+ \layout Subsubsection
+ 
+ Formatting Date/Time Fields
+ \layout Standard
+ 
+ 
+ \begin_inset  Tabular
+ <lyxtabular version="2" rows="31" columns="3">
+ <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="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
+ 
+ Element
+ \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
+ 
+ Input?
+ \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
+ 
+ 
+ \backslash 
+ 
+ \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
+ 
+ Yes
+ \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
+ 
+ Next character is a literal
+ \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
+ 
+ a
+ \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
+ 
+ Yes
+ \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
+ 
+ Abbreviated weekday name (Sun..Sat) 
+ \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
+ 
+ A
+ \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
+ 
+ \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
+ 
+ Full weekday name (Sunday..Saturday)
+ \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
+ 
+ b
+ \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
+ 
+ Yes
+ \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
+ 
+ Abbreviated month name (Jan..Dec)
+ \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
+ 
+ B
+ \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
+ 
+ \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
+ 
+ Full month name (January..December)
+ \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
+ 
+ c
+ \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
+ 
+ \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
+ 
+ Century (20,21)
+ \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
+ 
+ d
+ \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
+ 
+ Yes
+ \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
+ 
+ Day of month, left padded with zeros (01..31)
+ \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
+ 
+ D
+ \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
+ 
+ \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
+ 
+ Day of month, non-padded (1..31)
+ \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
+ 
+ h
+ \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
+ 
+ Yes
+ \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
+ 
+ Hour (24-hour format), left padded with zeros (00..23)
+ \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
+ 
+ H
+ \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
+ 
+ \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
+ 
+ Hour (24-hour format), non-padded (0..23)
+ \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
+ 
+ g
+ \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
+ 
+ Yes
+ \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
+ 
+ Hour (12-hour format), left padded with zeros (01..12)
+ \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
+ 
+ G
+ \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
+ 
+ \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
+ 
+ Hour (12-hour format), non-padded (1..12)
+ \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
+ 
+ j
+ \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
+ 
+ Yes
+ \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
+ 
+ Day of year, left padded with zeros (001..366)
+ \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
+ 
+ J
+ \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
+ 
+ \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
+ 
+ Day of year, non-padded (1..366)
+ \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
+ 
+ m
+ \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
+ 
+ Yes
+ \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
+ 
+ Month, left padded with zeros (01..12)
+ \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
+ 
+ M
+ \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
+ 
+ \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
+ 
+ Month, non-padded (1..12)
+ \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
+ 
+ i
+ \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
+ 
+ Yes
+ \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
+ 
+ Minute, left padded with zeros (01..59)
+ \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
+ 
+ I
+ \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
+ 
+ \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
+ 
+ Minute, non-padded (1..59)
+ \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
+ 
+ p
+ \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
+ 
+ Yes
+ \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
+ 
+ am/pm designation (lowercase)
+ \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
+ 
+ P
+ \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
+ 
+ \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
+ 
+ AM/PM designation (uppercase)
+ \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
+ 
+ s
+ \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
+ 
+ Yes
+ \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
+ 
+ Seconds, left padded with zeros (00..59)
+ \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
+ 
+ S
+ \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
+ 
+ \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
+ 
+ Seconds, non-padded (0..59)
+ \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
+ 
+ u
+ \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
+ 
+ Yes
+ \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
+ 
+ Week number of year with Sunday as first day of week, left padded with zeros
+  (01..52)
+ \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
+ 
+ U
+ \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
+ 
+ \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
+ 
+ Week number of year with Sunday as first day of week, non-padded (1..52)
+ \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
+ 
+ v
+ \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
+ 
+ Yes
+ \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
+ 
+ Week number of year with Monday as first day of week, left padded with zeros
+  (01..52)
+ \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
+ 
+ V
+ \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
+ 
+ \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
+ 
+ Week number of year with Monday as first day of week, non-padded (1..52)
+ \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
+ 
+ w
+ \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
+ 
+ Yes
+ \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
+ 
+ Day of week with Sunday as first day of week (0=Sunday) (0..6)
+ \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
+ 
+ W
+ \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
+ 
+ Yes
+ \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
+ 
+ Day of week with Monday as first day of week (0=Monday) (0..6)
+ \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
+ 
+ Yes
+ \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
+ 
+ Year (1900..2100)
+ \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
+ 
+ Yes
+ \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
+ 
+ Year, using 2-digit notation (00..99) When used as an input mask, forms tries
+  to reasonably guess the century.
+  (TODO: Elaborate) 
+ \end_inset 
+ </cell>
+ </row>
+ </lyxtabular>
+ 
+ \end_inset 
+ 
+ 
+ \layout Standard
+ 
+ Predefined literals: "/-.:, "
+ \layout Standard
+ 
+ Examples: 01/01/2001: "m/d/y" Friday, June 1, 2001: "A, b d, Y"
+ \layout Subsubsection
+ 
+ Formatting Text Fields
+ \layout Standard
+ 
+ TODO
+ \layout Subsection
+ 
+ Designing for Multiple Interfaces
+ \layout Standard
+ 
+ A form definition, when designed within reasonable guidelines, can be run
+  on a plethora of system architectures and a wide variety of user interfaces.
+  By using the approach taken in this guide, most of your forms will, by
+  default, run on a graphical workstation (X11, Windows, Mac), in a text-based
+  session (telnet or ssh), or via a web browser (HTML).
+  This section provides 
+ \layout Standard
+ 
+ This list, while not exhaustive, should give you a good idea of common 
portabili
+ ty pitfalls.
+  As with all things in GNUe, you will always have a choice on how to implement
+  your application.
+  GNUe is not about forcing rules on developers, but about providing viable
+  options.
+  There will be instances where the following suggestions simply are not
+  feasible or practical.
+  In any event, these are simply suggestions on getting the most out of Forms.
+ \layout Description
+ 
+ Images Do not make your application dependent on displayed images.
+  It would be acceptable, and appropriate, to display pictures for 
informational
+  purposes.
+  For example, when doing parts lookups, it would be appropriate to display
+  a picture of the part for reference use.
+  However, it would be normally be inappropriate to prevent the form from
+  working if this image could not be displayed.
+  (TODO: Better example?)
+ \layout Description
+ 
+ OS-specific\SpecialChar ~
+ trigger\SpecialChar ~
+ code Python, the default trigger language, provides an
+  extensive library of cross-platform functions.
+  For example, it provides a library of file-access routines that work on
+  all its supported platforms.
+  This is really a broad category as trigger code has all the power of Python
+  behind it.
+  
+ \layout Description
+ 
+ Custom\SpecialChar ~
+ widgets It is often tempting to use a new whiz-bang widget available
+  on a certain platform/widget set.
+  This will surely make your application hard to migrate to other 
platforms/inter
+ faces, as well as restrict your ability to upgrade to a newer Forms version.
+  Form's widget-set was carefully selected to be as multi-platform as possible,
+  while still providing all the functionality most forms will need.
+  If your application widgets are not supported by forms, there's a good
+  chance that your form could be more functional with a slight rethinking
+  of its design.
+  Remember: a goal of Forms is to be usable on as many platforms as possible,
+  not to exploit all the features of a particular platform.
  \layout Section
! 
  Writing Custom Wizards
  \layout Subsection
  
***************
*** 289,295 ****
   Templates and Wizards are Python scripts conforming to a basic design.
  \layout Subsection
  
! Format of a Wizard/Template Packages
  \layout Standard
  
  A valid package must contain at least three elements:
--- 1333,1339 ----
   Templates and Wizards are Python scripts conforming to a basic design.
  \layout Subsection
  
! Format of a Wizard/Template Package
  \layout Standard
  
  A valid package must contain at least three elements: