gnue/gnuef FAQ MANIFEST.in README README.curses...

[James Thompson]

CVSROOT:        /cvs
Module name:    gnue
Changes by:     James Thompson <address@hidden> 01/01/24 19:13:19

Modified files:
        gnuef          : FAQ MANIFEST.in README README.curses setup.py 
        gnuef/client   : gfclient 
        gnuef/doc      : techref.lyx 
        gnuef/samples/simple: form.gfd 
        gnuef/samples/zipcode: zipcode.gfd 
Added files:
        gnuef          : README.windows setup.cfg 
        gnuef/doc      : techref.ps 
        gnuef/images   : gnue-splash.xcf gnue.bmp gnuef-splash.bmp 
        gnuef/setupext : __init__.py install_data.py 

Log message:
        Updated docs
        changed -u text to -u pytext and -u newtext to -u text
        moved images arround a bit
        setup.py enhancements

CVSWeb URLs:
http://subversions.gnu.org/cgi-bin/cvsweb/gnue/gnuef/README.windows.diff?r1=NONE&r2=1.1
http://subversions.gnu.org/cgi-bin/cvsweb/gnue/gnuef/setup.cfg.diff?r1=NONE&r2=1.1
http://subversions.gnu.org/cgi-bin/cvsweb/gnue/gnuef/FAQ.diff?r1=1.1&r2=1.2
http://subversions.gnu.org/cgi-bin/cvsweb/gnue/gnuef/MANIFEST.in.diff?r1=1.2&r2=1.3
http://subversions.gnu.org/cgi-bin/cvsweb/gnue/gnuef/README.diff?r1=1.13&r2=1.14
http://subversions.gnu.org/cgi-bin/cvsweb/gnue/gnuef/README.curses.diff?r1=1.1&r2=1.2
http://subversions.gnu.org/cgi-bin/cvsweb/gnue/gnuef/setup.py.diff?r1=1.6&r2=1.7
http://subversions.gnu.org/cgi-bin/cvsweb/gnue/gnuef/client/gfclient.diff?r1=1.15&r2=1.16
http://subversions.gnu.org/cgi-bin/cvsweb/gnue/gnuef/doc/techref.ps.diff?r1=NONE&r2=1.1
http://subversions.gnu.org/cgi-bin/cvsweb/gnue/gnuef/doc/techref.lyx.diff?r1=1.1&r2=1.2
http://subversions.gnu.org/cgi-bin/cvsweb/gnue/gnuef/images/gnue-splash.xcf.diff?r1=NONE&r2=1.1
http://subversions.gnu.org/cgi-bin/cvsweb/gnue/gnuef/images/gnue.bmp.diff?r1=NONE&r2=1.1
http://subversions.gnu.org/cgi-bin/cvsweb/gnue/gnuef/images/gnuef-splash.bmp.diff?r1=NONE&r2=1.1
http://subversions.gnu.org/cgi-bin/cvsweb/gnue/gnuef/samples/simple/form.gfd.diff?r1=1.3&r2=1.4
http://subversions.gnu.org/cgi-bin/cvsweb/gnue/gnuef/samples/zipcode/zipcode.gfd.diff?r1=1.5&r2=1.6
http://subversions.gnu.org/cgi-bin/cvsweb/gnue/gnuef/setupext/__init__.py.diff?r1=NONE&r2=1.1
http://subversions.gnu.org/cgi-bin/cvsweb/gnue/gnuef/setupext/install_data.py.diff?r1=NONE&r2=1.1

Patches:
Index: gnue/gnuef/FAQ
diff -u gnue/gnuef/FAQ:1.1 gnue/gnuef/FAQ:1.2
--- gnue/gnuef/FAQ:1.1  Mon Dec 11 08:58:07 2000
+++ gnue/gnuef/FAQ      Wed Jan 24 19:13:19 2001
@@ -1,6 +1,6 @@
 Q:  I installed gnue forms but get an error about importing GFOptions.py
 
-A:  You need to install the python-gnue-base package.
+A:  You need to install the python-gnue-base package.  Available at 
www.gnue.org 
 
 Q:  I get an error similar to 
     IOError: [Errno 2] No such file or directory: 
'/usr/local/gnue/shared/gnuef-spash.bmp'
Index: gnue/gnuef/MANIFEST.in
diff -u gnue/gnuef/MANIFEST.in:1.2 gnue/gnuef/MANIFEST.in:1.3
--- gnue/gnuef/MANIFEST.in:1.2  Fri Dec 22 15:05:05 2000
+++ gnue/gnuef/MANIFEST.in      Wed Jan 24 19:13:19 2001
@@ -8,4 +8,7 @@
 include TODO 
 
 include client/gfclient
+include designer/GFDesigner.py
+recursive-include images *
 recursive-include samples *
+recursive-include setupext *
Index: gnue/gnuef/README
diff -u gnue/gnuef/README:1.13 gnue/gnuef/README:1.14
--- gnue/gnuef/README:1.13      Thu Jan 18 05:26:37 2001
+++ gnue/gnuef/README   Wed Jan 24 19:13:19 2001
@@ -20,6 +20,7 @@
                                    README file, but I really like it :)
                                    
 
+NOTE: SEE docs/techref.ps for more documentation
 Dependencies:
 
   General Requirements:
@@ -32,7 +33,7 @@
           (http://sourceforge.net/projects/pyxml)
   
 
-  Text Version Requirements:
+  pytext Version Requirements:
 
     pyncurses (http://pyncurses.sourceforge.net/)
 
@@ -53,6 +54,9 @@
        su
        python setup.py install
 
+    An PyGreSql module for win32 machines can be found at
+     http://highqualdev.com  GNUe Forms has not yet been 
+     tested with this module.
 
 To Test:
 
@@ -101,35 +105,3 @@
 
     python setup.py build
     python setup.py install
-
-GFD format notes:
-
-  to add an additional attribute to an element just, well, add it :)
-  Example: I wanted to add height and width to the form element
-
-    <form>
-    now becomes
-    <form height="300" width="300">
-
-  when the GFForm object instance is created height and width attributes
-  will be added and get be referenced as follows
-
-  a code snippet
-
-    fp = open(sys.argv[-1])
-    form = GFForm(fp)
-    fp.close()
-    print "Width : ",form.width
-    print "Height:", form.height
- 
-  As a side note: Since we are currently building .gfd files by hand
-  make sure you don't do <form hieght="300" width="300"> as it'll
-  happily accept it create the two attribute names you requested and
-  you'll be left wondering what the address@hidden@# is wrong with the program 
:)
-
-  **** NOTE ****
-  
-  There is no attribute validation currently.  Later this will likely be
-  done in a DTD.  So be extra careful. :)
-
-
Index: gnue/gnuef/README.curses
diff -u gnue/gnuef/README.curses:1.1 gnue/gnuef/README.curses:1.2
--- gnue/gnuef/README.curses:1.1        Fri Dec  8 13:49:58 2000
+++ gnue/gnuef/README.curses    Wed Jan 24 19:13:19 2001
@@ -1,4 +1,9 @@
-pyncurses is still incomplete.
+We are in the process of moving from pyncurses to the 
+curses module bundled with Python.  Neither module is 
+complete at this time.  The -u text option now uses the
+python module and is very rough, the -u pytext option
+is better at dealing with simple forms but will no
+longer be developed.
 
 To avoid a few of the artifacts use
 
Index: gnue/gnuef/client/gfclient
diff -u gnue/gnuef/client/gfclient:1.15 gnue/gnuef/client/gfclient:1.16
--- gnue/gnuef/client/gfclient:1.15     Thu Dec 21 13:14:35 2000
+++ gnue/gnuef/client/gfclient  Wed Jan 24 19:13:19 2001
@@ -28,7 +28,7 @@
        [-D tracefile] [--debug_file=tracefile] \\
        [-u uiType] [--user_interface=uiType] [-v] [--version]
 
-Supported uiTypes : gui, text, newtext (unstable)
+Supported uiTypes : gui, text (unstable), pytext
 
 Report bugs to address@hidden
 """
@@ -88,11 +88,11 @@
       else:
         SetOptions.ui_type='text'
 
-    if self.ui_type == 'text':
+    if self.ui_type == 'pytext':
       from gnue.forms import UIpyncurses
       ui=UIpyncurses.GFUserInterface(fp)
 
-    if self.ui_type == 'newtext' : 
+    if self.ui_type == 'text' : 
       from gnue.forms import UIcurses
       ui=UIcurses.GFUserInterface(fp)
 
Index: gnue/gnuef/doc/techref.lyx
diff -u gnue/gnuef/doc/techref.lyx:1.1 gnue/gnuef/doc/techref.lyx:1.2
--- gnue/gnuef/doc/techref.lyx:1.1      Sun Jan 21 10:50:23 2001
+++ gnue/gnuef/doc/techref.lyx  Wed Jan 24 19:13:19 2001
@@ -24,9 +24,25 @@
 
 \layout Title
 
-GNU Entrprise - GNUe Forms 
+GNU Entrprise - GNUe Forms
 \newline 
 Technical Reference
+\layout Abstract
+
+This is version 0.1.0 of the Technical Reference it covers GNUe Forms 0.0.5
+\layout Abstract
+
+It was written by James Thompson.
+ Edited by Derek Neighbors.
+\layout Abstract
+
+The current copy is maintained as a LyX 1.1.6 file.
+ If anyone knows of ways to get LyX to play nicer with regard to code samples
+ please let us know.
+ 
+\layout Abstract
+
+This document is covered by the GNU Free Documentation License Version 1.1
 \layout Author
 
 James Thompson
@@ -105,7 +121,7 @@
 \lang english
 Supports 2-Tier client/server designs for use outside the GNU Enterprise
  system.
- Also supports multi-tiered designs via GNUE Objects based upon CORBA.
+ Also supports multi-tiered designs via GEAS.
 \end_inset 
 </cell>
 </row>
@@ -642,8 +658,8 @@
 
 
 \lang english
-A graphical user interface based upon wxpython.
- Usable on X and Win32 systems.
+A graphical user interface based upon wxPython.
+ Works on X(GTK and Motif) or Win32 systems.
 \end_inset 
 </cell>
 </row>
@@ -711,7 +727,14 @@
 Development of GNUe Forms: Designer has not yet started.
 
 \series default 
- The GNUe Forms: Designer allows a person to easily create data entry screens
+ 
+\series bold 
+However there is a script located in the gnuef/designer directory of the
+ source distribution that will make creating forms a little easier until
+ the real Designer is developed.
+\layout Standard
+
+The GNUe Forms: Designer allows a person to easily create data entry screens
  to be used with the GNUE Forms client.
  With it the devleoper can simply paint the form and have the .gfd file 
generated
  for them.
@@ -725,18 +748,18 @@
  client platform.
 \layout Itemize
 
-Produce form diffs from an original form.\SpecialChar ~
- Allowing programmers to store local
- alterations separate from the basic form.
+Produce form diffs from an original form.
+ Allowing programmers to store local alterations separate from the basic
+ form.
 \layout Section
 
 Designing with GNUe Objects
 \layout Standard
 
 When working with the GNUe Forms: Designer to develop screens, the developer
- is actually working with GNU Enterprise business objects.
- Objects in GNU Enterprise are self-aware and make this information available
- to programs for browsing.
+ is actually working with GEAS objects.
+ GEAS objects are self-aware and make this information available to programs
+ for browsing.
 \layout Standard
 
 The GNUe Forms: Designer program queries all defined objects and generates
@@ -767,9 +790,9 @@
 \layout Standard
 
 The GNUe Form: Designer compiles this information and presents it to the
- developer via a graphical user interface.\SpecialChar ~
- This allows the screen developers
- to build forms via simple drag and drop operations.
+ developer via a graphical user interface.
+ This allows the screen developers to build forms via simple drag and drop
+ operations.
 \layout Chapter
 
 GFD Structure
@@ -805,6 +828,7 @@
 
 The gfd file supports 2 different methods of specifing tag attributes.
  You can use either method to define any object's attributes.
+ You can use both methods in the same gfd file without issues.
  The examples below will typically show the first method as it's less typing
  :)
 \layout Subsubsection
@@ -859,7 +883,7 @@
 
 \SpecialChar ~
 \SpecialChar ~
-<options>
+</options>
 \layout Standard
 
 </label>
@@ -868,7 +892,7 @@
 As you can see this is much more verbose and using it for the label doesn't
  make much sense.
  However it is very usefull when wanting to visually seperate infomation
- within the gfs file.
+ within the gfd file.
  Or when defining multi-line triggers.
 \layout Subsection
 
@@ -892,7 +916,7 @@
  a value of bar will be added 
 \layout Subsubsection
 
-Cavecats
+Caveats
 \layout Standard
 
 Since we are currently building .gfd files by hand make sure you don't do
@@ -2710,6 +2734,9 @@
 
 foreign_key="validator.state" foreign_key_description="description" 
style="dropdo
 wn">
+\layout Section
+
+Box
 \layout Subsection
 
 Attributes
@@ -2997,9 +3024,14 @@
 Attributes
 \layout Subsubsection
 
-Common
+Common attributes
 \layout Standard
 
+These attributes are common to all database objects.
+ The specific provider selected may add additional attributes that are required
+ to make that provider function.
+\layout Standard
+
 
 \begin_inset  Tabular
 <lyxtabular version="2" rows="3" columns="4">
@@ -3202,8 +3234,6 @@
 
 \layout Standard
 
-
-\lang english
 host
 \end_inset 
 </cell>
@@ -3212,8 +3242,6 @@
 
 \layout Standard
 
-
-\lang english
 string
 \end_inset 
 </cell>
@@ -3222,8 +3250,6 @@
 
 \layout Standard
 
-
-\lang english
 none
 \end_inset 
 </cell>
@@ -3232,8 +3258,6 @@
 
 \layout Standard
 
-
-\lang english
 The DNS name or IP address of the postgresql database server.
 \end_inset 
 </cell>
@@ -3852,11 +3876,14 @@
 \layout Section
 
 Trigger
+\layout Subsection
+
+Attributes
 \layout Standard
 
 
 \begin_inset  Tabular
-<lyxtabular version="2" rows="3" columns="4">
+<lyxtabular version="2" rows="4" 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="">
@@ -3946,7 +3973,7 @@
 \end_inset 
 </cell>
 </row>
-<row topline="true" bottomline="true" newpage="false">
+<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
 
@@ -3989,34 +4016,54 @@
 \end_inset 
 </cell>
 </row>
-</lyxtabular>
+<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
+
+src
 \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
 
-\layout Subsection
+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
 
-Attributes
 \layout Standard
 
-<trigger type=
-\begin_inset Quotes erd
+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
 
-\begin_inset Quotes erd
+Used to call named triggers.
+\end_inset 
+</cell>
+</row>
+</lyxtabular>
+
 \end_inset 
 
-></trigger>
+
 \layout Subsection
 
 Example
-\layout Standard
+\layout Subsubsection
 
+Simple Embedded
+\layout Standard
 
-\series bold 
-Note: Named triggers are also supported but I don't have an example and
- haven't dug into code to see how it's done.
+<entry>
 \layout Standard
 
 <trigger type ="Pre-FocusOut"> 
@@ -4026,6 +4073,59 @@
 \layout Standard
 
 </trigger>
+\layout Standard
+
+</entry>
+\layout Subsubsection
+
+Named
+\layout Standard
+
+This was taken from the sample/po form.
+\layout Standard
+
+<form>
+\layout Standard
+
+<trigger type="named" id="trggrAmount">
+\layout Standard
+
+# 
+\layout Standard
+
+#Calculate Amount 
+\layout Standard
+
+# import sys 
+\layout Standard
+
+blckPOItem.fields.ntryAmount=str(int(blckPOItem.fields.ntryQuantity)*float(blckPOIte
+m.fields.ntryUnitPrice)) 
+\layout Standard
+
+</trigger>
+\layout Standard
+
+
+\emph on 
+more form stuff
+\layout Standard
+
+<entry ......>
+\layout Standard
+
+<trigger type="Pre-FocusOut" src="trggrAmount" /> 
+\layout Standard
+
+</entry>
+\layout Standard
+
+
+\emph on 
+more form stuff
+\layout Standard
+
+</form>
 \layout Section
 
 Complete Example
Index: gnue/gnuef/samples/simple/form.gfd
diff -u gnue/gnuef/samples/simple/form.gfd:1.3 
gnue/gnuef/samples/simple/form.gfd:1.4
--- gnue/gnuef/samples/simple/form.gfd:1.3      Fri Dec 22 15:14:43 2000
+++ gnue/gnuef/samples/simple/form.gfd  Wed Jan 24 19:13:19 2001
@@ -15,7 +15,8 @@
     </block>
   </page>
   <page>
-    <block name="testing">
+    <block 
+      name="testing">
       <label text="Text Box 1" x="1" y="1" />
       <entry name="text1" x="1" y="2" width="10">
         <options>
Index: gnue/gnuef/samples/zipcode/zipcode.gfd
diff -u gnue/gnuef/samples/zipcode/zipcode.gfd:1.5 
gnue/gnuef/samples/zipcode/zipcode.gfd:1.6
--- gnue/gnuef/samples/zipcode/zipcode.gfd:1.5  Fri Dec 22 15:14:43 2000
+++ gnue/gnuef/samples/zipcode/zipcode.gfd      Wed Jan 24 19:13:19 2001
@@ -17,7 +17,7 @@
       <label text="City" x="1" y="1"/>
       <entry name="city" field="city" x="1" y="2" width="15" visibleCount="15" 
uppercase="">
        <options>
-         <tip>Full name of city</tip>
+         <option name="tip">Full name of city</option>
        </options>
       </entry>
 
Index: gnue/gnuef/setup.py
diff -u gnue/gnuef/setup.py:1.6 gnue/gnuef/setup.py:1.7
--- gnue/gnuef/setup.py:1.6     Fri Dec 22 10:55:22 2000
+++ gnue/gnuef/setup.py Wed Jan 24 19:13:19 2001
@@ -1,14 +1,26 @@
 #!/usr/bin/env python
-
+import string
 from distutils.core import setup
+from setupext import Data_Files, install_Data_Files
+imagefiles="""
+  recursive-include images *.bmp
+"""
+
+images = [
+        Data_Files(base_dir='/usr/local/gnue/',
+                   copy_to = 'shared',
+                   template = string.split(imagefiles,"\n"),
+                   preserve_path = 1)
+        ]
 
 setup (name = "python-gnue-forms",
-       version = "0.0.4",
+       version = "0.0.5",
        description = "GNU Enterprise Forms",
        long_description = "",
        author = "GNUe Forms Team",
        author_email = "address@hidden",
        url = "http://www.gnue.org";,
+#       data_files = images,
        packages = ["gnue.forms",
                    "gnue.forms.drivers",
                    "gnue.forms.drivers.geas",