IMPORTANT WARNING: 4.5 is a development version. Many features are missing. There are bugs in Slider2 and Slider4 that will prevent it from working. Other bugs are still lurking. I also used a development of automake with several patches. If you aren't trying to contribute to FWF you should probably consider using a different version. 4.0 from ftp.let.rug.nl:/pub/fwf is probably more stable. So is 4.3 from alpha.gnu.ai.mit.edu:/fwf (This file is divided into the parts: propaganda, stuff for installers, and stuff for hackers. Feel free to skip parts of it.) ***************************************************************** * * * The Free Widget Foundation Widget Release * * * ***************************************************************** This is the Free Widget Foundation widget release, a collection of no-cost, freely redistributable X graphical user interface widgets. The Free Widget Foundation is a grass-roots, all-volunteer effort. The Free Widget Foundation project was started summer 1990 in order to collect existing widgets in a well-publicized location to prevent duplication of effort. Numerous people have expressed interest in submitting widgets to the collection. The collection process is going slowly because of lack of time and organizational needs. The "Free Widget Foundation" is a pun on the "Free Software Foundation" title. While the two organizations share some similar goals, that is the improvement of the quality and quantity of freely-redistributable public software, this organization is in no way related to the Free Software Foundation or the GNU projects. In fact, we aren't even a "foundation" in the legal meaning of the word. ***************************************************************** Since the above introduction was written, a few things have changed. The FWF widget release now comes from FSF ftp servers, and the maintainer of FWF is also writing some GNU software. INSTALLATION ============ XPM --- At one point, XPM was optional for Xfwf users. However, you lose a lot of functionality if you don't have it, and I'm not going to lose any more time worrying about it--please get and install the XPM libary. If you do not have XPM, then your system has a bug. Report it to your vendor. (I wish I could say that I had followed the previous instruction...) Then get the library from ftp.x.org in the contrib directory. If xmkmf does not work well enough for you to build the library (which is very likely), then massage it until it works. (One day we may convince them to support autoconf...) If xmkmf doesn't work well, then report that as a bug to your vendor as well. Old Xfwf Files -------------- If you happen to have old Xfwf files lying around, they may cause you to experience technical difficulties. (If you've never installed Xfwf before this is not a problem.) Look for /usr/X11/include/Xfwf and /usr/local/include/Xfwf. If either of these exist, it would be wise to allow their existance to cease. Do something like $ rm -rf /usr/X11/include/Xfwf /usr/local/include/Xfwf It would also be nice to remove the old libraries and manpages. Sorting out the old man pages will be difficult. But the libaries should be /usr/X11R6/lib/libDir.a /usr/X11R6/lib/libfwf.a /usr/local/lib/libfwf.a Wbuild ------ If you have a version of wbuild prior to 3.1, please rename it so that `configure' will not find it. If you have a different prefix for wbuild and Xfwf (or more precisely, a different datadir), you may set the WBUILDDATADIR enviroment variable. For example, if you install wbuild with the default prefix and install Xfwf someplace else, do (in a Bourne shell) WBUILDDATADIR=/usr/local/share/wbuild ./configure INSTALL ------- See the file `INSTALL' for more information on compiling. Note that if you have the XPM libraries in a different place from the other X11 libraries, then use the CFLAGS and LDFLAGS to specify the location of XPM. On koa I use the following: CC=gcc CFLAGS='-I/dsk0/n/nemo/include -g -Wall -O' LDFLAGS='-L/dsk0/n/nemo/lib' HACKING ======= There are several other packages that you may wish to use if you are a hacker: XfwfMotif contains Motif widgets made by FWF. I don't support this package, so don't ask me about it. (In fact, if you send a message to the FWF mailing lists, I probably will respond to it unless I get the feeling that it is related to Motif.) Xfwfold contains some old obsolete widgets, test programs, and other materials. It doesn't compile. Please either modify your programs to use the new widgets or explain to me why you like the old widget better. XfwfDemo demonstrates the capabilities of the widgets in this distribution. XfwfTest contains some test programs that demostrate the widgets. wbuild is a tool used in writing widgets. Please use it for any new widgets you wish to contribute to Xfwf. appbuild simplifies the process of writing application programs with Xfwf. GNU E-scape is a WWW browser. It contains some high-level user interface widgets. If you're writing a copylefted program, please look there before you complain that we don't have a sophisticated enough text widget in Xfwf. [Note that you cannot even get a prerelease version at the moment.] I've also been trying to convert the X11 documentation that is a part of the xc tree to TeXinfo format to make it easier to read on the computer screen. (Ghostview is awkward.) Everything You Ever Wanted To Know About The Maintainer ======================================================= Well, not QUITE everything :-; Joel N. Weber II nemo@koa.iolani.honolulu.hi.us devnull@gnu.ai.mit.edu (after May 98)