gnue/docbook/articles gnue_forms_article.lyx

[James Thompson]

CVSROOT:        /cvs
Module name:    gnue
Changes by:     James Thompson <address@hidden> 01/01/16 13:53:02

Modified files:
        docbook/articles: gnue_forms_article.lyx 

Log message:
        Article updates

CVSWeb URLs:
http://subversions.gnu.org/cgi-bin/cvsweb/gnue/docbook/articles/gnue_forms_article.lyx.diff?r1=1.1&r2=1.2

Patches:
Index: gnue/docbook/articles/gnue_forms_article.lyx
diff -u gnue/docbook/articles/gnue_forms_article.lyx:1.1 
gnue/docbook/articles/gnue_forms_article.lyx:1.2
--- gnue/docbook/articles/gnue_forms_article.lyx:1.1    Tue Jan 16 12:14:02 2001
+++ gnue/docbook/articles/gnue_forms_article.lyx        Tue Jan 16 13:53:02 2001
@@ -24,7 +24,7 @@
 
 \layout Title
 
-Cross Platform Data Aware Applications In Minutes
+therCross Platform Data Aware Applications In Minutes
 \layout Author
 
 by Derek Neighbors
@@ -66,8 +66,8 @@
 \layout Standard
 
 GNU Enterprise Forms consists of two parts.
- The first part is the forms definition file (.gfd) and second a forms painter
- that reads the .gfd and paints a GUI from it and processes triggers and
+ The first part is the forms definition file (.gfd) and second a forms client
+ that reads the .gfd and creates a GUI from it and processes triggers and
  datahandling.
  We will explore the forms definition in greater detail as it is the portion
  that it altered to make data aware business applications a snap.
@@ -156,19 +156,366 @@
 <tagname> <!-- this is my comment -->
 \layout Subsection
 
-<form> Tag
+<form>
+\layout Subsubsection
+
+Description
+\layout Standard
+
+The form tag is the main enclosing tags in a .gfd file.
+ 
+\layout Subsubsection
+
+Syntax
+\layout Standard
+
+<form height=
+\begin_inset Quotes erd
+\end_inset 
+
+
+\begin_inset Quotes erd
+\end_inset 
+
+ width=
+\begin_inset Quotes erd
+\end_inset 
+
+
+\begin_inset Quotes erd
+\end_inset 
+
+ title=
+\begin_inset Quotes erd
+\end_inset 
+
+
+\begin_inset Quotes erd
+\end_inset 
+
+ author=
+\begin_inset Quotes erd
+\end_inset 
+
+
+\begin_inset Quotes erd
+\end_inset 
+
+ version=
+\begin_inset Quotes erd
+\end_inset 
+
+
+\begin_inset Quotes erd
+\end_inset 
+
+ description=
+\begin_inset Quotes erd
+\end_inset 
+
+
+\begin_inset Quotes erd
+\end_inset 
+
+> </form>
+\layout Description
+
+author The author of the form displayed on the About screen.
+\layout Description
+
+version The version of the form displayed on the About screen.
+\layout Description
+
+title The title to be displayed on form window
+\layout Description
+
+height The height of the form in text rows.
+\layout Description
+
+width The width of the form in text columns.
+\layout Description
+
+description A brief description of the form displayed on the About screen.
+\layout Subsubsection
+
+Example
+\layout Subsubsection
+
+Notes
 \layout Subsection
+
+<page>
+\layout Subsubsection
+
+Description
+\layout Standard
+
+The visual seperator of a form.
+ Currently all available clients present this a seperate pages.
+\layout Subsubsection
+
+Syntax
+\layout Standard
+
+<page></page>
+\layout Subsubsection
+
+Example
+\layout Subsubsection
 
-< block> Tag
+Notes
 \layout Subsection
+
+< block>
+\layout Subsubsection
+
+Description
+\layout Standard
+
+A logical seperator of fields on a form.
+ Provides the mechanism for linking master records with detail records as
+ this block level.
+\layout Subsubsection
+
+Syntax
+\layout Standard
+
+<block name="" datasource="" readonly=
+\begin_inset Quotes erd
+\end_inset 
+
+
+\begin_inset Quotes erd
+\end_inset 
 
-<label> Tag
+ master=
+\begin_inset Quotes erd
+\end_inset 
+
+
+\begin_inset Quotes erd
+\end_inset 
+
+ detail=
+\begin_inset Quotes erd
+\end_inset 
+
+
+\begin_inset Quotes erd
+\end_inset 
+
+>
+\layout Description
+
+name The name of the widget.
+ No blocks or datasources can share the same name without causing namespace
+ collisions in user triggers.
+\layout Description
+
+datasource The name of a datasource to which this block is tied.
+\layout Description
+
+readonly If set then none of the entry widgets inside this block can be
+ modified via the user interface.
+\layout Description
+
+master If this block is a detail block then this attribute contains a link
+ to it's master's field.
+ The link is presented in the form block.field.
+\layout Description
+
+detail If this block is a detail block then thes attribute contains the
+ name of this block's field that references the field given in the master
+ attribute
+\layout Subsubsection
+
+Example
+\layout Subsubsection
+
+Notes
 \layout Subsection
 
-<entry> Tag
+<label>
+\layout Subsubsection
+
+Description
+\layout Subsubsection
+
+Syntax
+\layout Standard
+
+<label x=
+\begin_inset Quotes erd
+\end_inset 
+
+
+\begin_inset Quotes erd
+\end_inset 
+
+ y=
+\begin_inset Quotes erd
+\end_inset 
+
+
+\begin_inset Quotes erd
+\end_inset 
+
+ width=
+\begin_inset Quotes erd
+\end_inset 
+
+
+\begin_inset Quotes erd
+\end_inset 
+
+ justification=
+\begin_inset Quotes erd
+\end_inset 
+
+
+\begin_inset Quotes erd
+\end_inset 
+
+>
+\layout Description
+
+x The text column starting position of the widget .
+ Based upon leftmost column of screen being 0.
+ 
+\layout Description
+
+y The text row starting position of the widget.
+ Based upon the top row of the screen being 0.
+\layout Description
+
+width The width of the label in text columns.
+ Defaults to the width of the text.
+ Only really usefull when used with the justification attribute.
+\layout Description
+
+justification The justification of the label.
+ Can be one of the following left, right, or center.
+ Requires that the width attribute be set.
+\layout Subsubsection
+
+Example
+\layout Subsubsection
+
+Notes
 \layout Subsection
+
+<entry>
+\layout Subsubsection
+
+Description
+\layout Subsubsection
+
+Syntax
+\layout Standard
+
+<entry name="
+\begin_inset Quotes erd
+\end_inset 
+
+ field="" x="" y="" height=
+\begin_inset Quotes erd
+\end_inset 
+
+
+\begin_inset Quotes erd
+\end_inset 
+
+ width="" max_length="" lowercase=
+\begin_inset Quotes erd
+\end_inset 
+
+
+\begin_inset Quotes erd
+\end_inset 
+
+ uppercase="" visibleCount="" numeric="" hidden=
+\begin_inset Quotes erd
+\end_inset 
 
-<combobox> Tag
+
+\begin_inset Quotes erd
+\end_inset 
+
+ foreign_key=
+\begin_inset Quotes erd
+\end_inset 
+
+
+\begin_inset Quotes erd
+\end_inset 
+
+foreign_key_description="" style="">
+\layout Description
+
+x The text column starting position of the widget .
+ Based upon leftmost column of screen being 0.
+ 
+\layout Description
+
+y The text row starting position of the widget.
+ Based upon the top row of the screen being 0.
+\layout Description
+
+height The height of the entry in text rows.
+\layout Description
+
+width The width of the entry in text columns.
+\layout Subsection
+
+<box>
+\layout Subsubsection
+
+Description
+\layout Standard
+
+A basic widget that provides a border arround a section of a page with an
+ optional label.
+\layout Subsubsection
+
+Syntax
+\layout Standard
+
+<box x="" y="" width="" height=
+\begin_inset Quotes erd
+\end_inset 
+
+" label=""/>
+\layout Description
+
+x The text column starting position of the widget .
+ Based upon leftmost column of screen being 0.
+ 
+\layout Description
+
+y The text row starting position of the widget.
+ Based upon the top row of the screen being 0.
+\layout Description
+
+height The height of the box in text columns.
+\layout Description
+
+width The width of the box in text columns.
+\layout Description
+
+label An optional text label that will be displayed on the border.
+\layout Subsubsection
+
+Example
+\layout Subsubsection
+
+Notes
+\layout Subsection
+
+<options> and <option>
+\layout Standard
+
+Used inside of other tags as an alternative to attributes assigned within
+ a tag.
 \layout Section
 
 Making Your Form Data Aware
@@ -186,9 +533,27 @@
 \layout Subsection
 
 <database> Tag
+\layout Standard
+
+<database name="" provider="" dbname="" host=""/>
 \layout Subsection
 
 <datasource> Tag
+\layout Standard
+
+<datasource name="" database="" table="" order_by="" prequery="" sql=
+\begin_inset Quotes erd
+\end_inset 
+
+
+\begin_inset Quotes erd
+\end_inset 
+
+/>
+\layout Description
+
+sql Hard coded sql statement.
+ Curently not active in code.
 \layout Section
 
 Embedded Form Manipulation
@@ -239,7 +604,7 @@
  to create an UML diagram in DIA and have it create your objects, tables
  and forms w/ no additional work.
  GNU Enterprise Forms will also support a wider widget set over time as
- well as an WWW painter.
+ well as an WWW client.
  Entity support is also planned that would allow for easy localization with
  minimal effort.
 \layout Standard