File: README

package info (click to toggle)
gnue-forms 0.5.11-2
  • links: PTS
  • area: main
  • in suites: sarge
  • size: 3,384 kB
  • ctags: 1,577
  • sloc: python: 12,904; sql: 579; makefile: 28
file content (89 lines) | stat: -rw-r--r-- 2,998 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
GNUe Forms: A tool of the GNUe Project (www.gnue.org)

Introduction
------------
GNUe Forms is a data-aware user-interface generator. In more specific terms,
Forms, using a clean XML-based definition, can display the same functional user
interface in various physical mediums, whether GUI, HTML, console, or via a
telephone-response system. Forms is designed from the ground up to describe a
functional, database-backed interface, with no emphasis on particular widget
sets. A form should be equally usable in a console/text-based environment as it
is in a GUI setting.

Like all GNUe tools, Forms runs on most modern platforms and can communicate
with the vast majority of modern SQL-compliant database backends. With a modular
user interface kit, new interface types can be quickly and easily added. Form's
primary user interface is the wxPython (http://www.wxpython.org) toolkit, which
allows us to support Windows, GTK, Mac OS/X, and OS/2 out of the box. The GNUe
team is also coordinating native KDE/QT, web-based HTML, native MS Windows,
text-only curses, and native GTK2 user interfaces. Forms includes support
for Python-based events or triggers, for real-time validation of user data.

Forms will seemlessly work with GNUe AppServer, GNUe Navigator, and GNUe
Reports if they are present. However, as part of GNUe's modular framework, Forms
does not require any other GNUe tools to function.

Forms is currently in use in several locations, including commercial,
non-profit, and academic sites.


Compatability
-------------
GNUe Forms has been successfully used on
  * Debian GNU/Linux
  * Gentoo GNU/Linux
  * FreeBSD
  * RedHat GNU/Linux
  * SuSE Linux
  * Slackware
  * Solaris 2.5.1
  * Windows 98/ME/NT/XP


Installation
------------
Linux/Unix/BSD Users should read INSTALL file

Windows Users should read INSTALL.win32


Running GNUe Forms
------------------
If you installed then just call the program

   $ gnue-forms -u text|gui filename.gfd

If you run without -u option it will default to gui (wxPython)

Other samples can be found under samples

To run data aware scripts you must make sure your GNUE_CONNECTIONS
environment variable is set to point to a connections file. See
doc/Connections.txt in the gnue-common package for more information.

Also you must have the tables created for samples that are data
aware.  You can do this by running the associated .sql script for
a sample.
  ex: psql
      \i scriptname.sql

Installation
------------
Please see INSTALL for installation instructions.

License
-------
GNU Enterprise is free software.  See the file `COPYING' for the terms and
conditions for copying, distribution and modification.

Notes
-----
[1] SLOWER MACHINES
    If gnue-forms seg faults when you run it, try running with the -s option.
    If the seg faults stop happening when using that flag, you can add the
    following to your gnue.conf file:

        [forms]
        disableSplash = 1

    Note: this has now been reported on some faster machines!