-------------------------------------------------------------------------
	                    	Linux X Builder (L-X-B) 
This is the file lxb.README for the program lxb version 0.2.  (10/95)
-------------------------------------------------------------------------


SUMMARY:
	lxb is an X/Motif interactive graphical user interface builder. With 
	it you can build a GUI made up of Motif widgets instantiated by 
	clicking on icons, move and resize them with the mouse, edit their 
	resources, and move about in the widget heirarchy via the arrow keys. 
	Once the GUI is built, pressing a button will produce all required C 
	source files to build the GUI, and an X resource file and Makefile.


PLEASE NOTE:
	This version of lxb is not completed. Not all Motif widgets are 
	included, nor can all resources be edited. However, all instantiated 
	widgets are declared as global, so that you can more easily write any 
	additional code required. 

	I am releasing this software now, even though it is incomplete, since 
	it will take a great deal of time and work to produce a GUI builder
	comparable to one of the commercial ones. Hopefully, with what 
	capabilities this software does currently have it will be useful for 
	someone. 

	I am only releasing the executable at this time.


INSTALLING lxb:
	Once you unzip and untar the archive lxb-0.2bin.tar.gz you will have
	the files:

		lxb:					The executable
		Lxb-ad:				The X application defaults
		lxb.README:		This file
		lxb.INSTRUCT:	Instructions on how to use lxb.

	The X application defaults for lxb can be placed any of many places, 
	depending on how you do your X resources.

	Install the executable somewhere your "path" refers to.


SUPPORTED PLATFORMS:
	As the name suggests, only Linux systems. However, I may shortly have
	a Solaris 2.4 version available.

	My system has the Slackware 2.2 distribution installed as a base,
	with the kernel upgraded to 1.2.8; XFree86 3.1.1 (X11R6), libc4.5.26, 
	gcc 2.5.8. Your system's milage may vary. 


X11/MOTIF VERSION:
	The version of Motif I am using is 2.0, but Motif 1.2 should work also.
	I'm using X11R6 and that is what the Makefile assumes. X11R5 should 
	work just fine also, but you'll have to alter the Makefile.


HOW TO USE LXB:
	See the file INSTRUCT.


DEFICENCIES:
	-	A callback editor is not provided as of yet.
	- No test mode.
	-	No display of widget heirarchies is provided yet. Use editres.
	-	Not all widgets are available yet.
	-	Not all resources can be edited yet.
	-	Widget names are not user assignable yet.
	-	No choices are given as to the scope of the variables yet.
	-	And many more, when compared to a commercial $3000+ GUI builder.


WORKAROUNDS:
	All widgets in the created GUI application are declared global.
	This was done so that the user may more easily change resources
	that I have not yet been able to provid the capability of editing, 
	adding callback functions to, etc.

	Also, the program editres may be useful if you desire to see
	widget heirarchies.


TO KEEP IN MIND:
	It's very possible that new versions of lxb released in the future, 
	for several releases, at least, may not read the save files (*.lxb) 
	created with older versions of lxb.

	AND, REMEMBER, this is an ALPHA version of incomplete software.


TO BE DONE:
	A whole lot.


BUGS:
	Of course.


NO WARRANTY OF ANY KIND:
	This program is distributed in the hope that it will be useful,
	but WITHOUT ANY WARRANTY; without even the implied warranty of
	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.


WEB SITE
	The Web page for lxb is http://www.umn.edu/g257/parki005/lxb.html.
	Further information including screen shots can be found there.


-------------------------------------------------------------------------
Please send any bug reports and comments to:

	bruce.parkin-1@umn.edu.

-------------------------------------------------------------------------
