3
This is the Free Software distribution of the XForms Library, a
4
graphical user interface toolkit for X Window Systems.
6
It should work under X11 R4, R5 & R6. XForms is free software. It is
7
licensed under the GNU LGPL (Lesser General Public License) version 2.1.
8
See the file COPYING.LIB for the gory details.
14
XForms 1.0.93 is a version in preparation for XForms 1.1.0. While
15
it is labeled as a "development version" we believe that it per-
16
forms correctly and has less bugs than older versions.
18
For more information, read the file ChangeLog.
24
The XForms homepage is accessible at
28
The sources can be downloaded from the project page at
32
See the "Download Area" on that page. On this page you should
33
select the file named 'xforms.latest_stable.tar.gz' (which will
34
point to the latest stable release, including bug-fixes that may
35
have become necessary) to download the sources - unless you're
36
prepared to take part in testing the "bleeding edge" versions
37
that have a name containing '-preX' (where X is some number),
38
indicating that it is a pre-release on the way to a new stable
45
There is a mailing list for XForms. To subscribe (or unsubscribe)
52
xforms-development-request@nongnu.org
54
with a subject line consisting of just 'subscribe' or 'unsubscribe'.
56
To use the mailing list, send your message to
58
xforms-development@nongnu.org
60
Remember your message will be sent to many people. Please DO NOT send
61
subscribe/unsubscribe messages to the list, send it to
62
xforms-request@nongnu.org
64
The archive of the mailing list can be found at
68
Messages sent to the mailing list before August 2009 are at
76
You should be able to compile XForms on any 'reasonable' flavour of
79
XForms relies on some other libraries, namely
82
* libXpm, version 4.7 or newer.
83
* libjpeg, 6.0b or newer.
86
You will find generic installation instructions common to all
87
autoconf-based packages in the file INSTALL. In general, all it takes
88
to compile and install XForms is
94
There are some features that you may want to control:
96
o --disable-gl that makes sure that gl support is not built even if
97
you have proper GL libraries installed.
99
o --enable-demos that adds "demos/" to the list of directories to
100
build. It contains various program demonstrating the use of the
103
For more complicated cases, ./configure takes the following specific
106
o --with-extra-lib=DIRECTORY that specifies the path where XForms will
107
find extra libraries (Xpm, jpeg...) it needs. Defaults to NONE
108
(i.e. search in standard places). You can specify several
109
directories, separated by colons.
111
o --with-extra-inc=DIRECTORY that gives the place where XForms will find
112
headers. Defaults to NONE (i.e. search in standard places).
113
You can specify several directories, separated by colons.
115
o --with-extra-prefix[=DIRECTORY] that is equivalent to
116
--with-extra-lib=DIRECTORY/lib --with-extra-inc=DIRECTORY/include
117
If DIRECTORY is not specified, the current prefix is used.
119
o --enable-optimization=VALUE enables you to set optimization to a
120
higher level as the default (-O), for example --enable-optimization=-O3.
122
o --disable-optimization - you can use this to disable compiler
123
optimization of LyX. The compile may be much quicker with some
124
compilers, but XForms applications will run more slowly.
126
o --enable-debug will add debug information to your binary. This
127
requires a lot more disk space, but is a must if you want to try to
128
debug problems in XForms. The default is to have debug information
129
for development versions and prereleases only.
131
o --enable-bwc-bs-hack enables some workarounds for incompatibilities
132
that may keep very old programs using XForms from working correctly.
133
Please only use as a last resort.
135
Moreover, the following generic configure flags may be useful:
137
o --prefix=DIRECTORY specifies the root directory to use for
138
installation. [defaults to /usr/local]
140
o --enable-maintainer-mode enables some code that automatically
141
rebuilds the configure script, makefiles templates and other useful
142
files when needed. This is off by default, to avoid surprises.
144
Note that the --with-extra-* commands are not really robust when it
145
comes to use of relative paths. If you really want to use a relative path
146
here, you can prepend it with "`pwd`/".
148
If you do not like the default compile flags used (-g -O on gcc), you can
149
set CFLAGS variable to other values as follows:
151
./configure CFLAGS='-O2' <other-options>
153
Similarly, if you want to force the use of some specific compiler, you can
154
give a value to the CC variable.
156
The following option might be useful in desperate cases:
158
o --enable-warnings that make the compiler output more warnings during
159
the compilation. Opposite is --disable-warnings.