			    Wbuild (1.17)
			    =============
Wbuild is a tool for easier creation of widgets for use with the X
Toolkit. It converts a compact description of a widget into a C file,
two header files and documentation.

				Goals
				=====
The implementation of widgets basically follows an object-oriented
model of programming, but much of the benefit is lost in the large
amount of boilerplate C code that has to be added to make it work.
Wbuild is an attempt to make widget programming more object-oriented,
by generating the supporting C code automatically.

A second goal is to allow `literate programming', in the style of WEB.
Documentation may be interleaved with code and it will be converted
into a TeX document when the widget is generated.

			     Compilation
			     ===========
Wbuild itself doesn't use Xlib, or any other part of X. Therefore I
haven't included an Imakefile, only a Makefile. You should be able to
just say `make'. The Makefile contains some comments about various
flags that you may want to set.

				Files
				=====
Most of these files were generated from other files: the .c files from
the .web files with Spidery WEB; the .e files from the .c file
with cproto; the .1 manual file from a .sgml file (not included) with
SGML2LaTeX and sgmls.

README		This file
Makefile
debug.c		Some routines for debugging output
debug.e		Headerfile: exports from debug.c
debug.web	The original of debug.c (not used)
generate.c	The generate routine
generate.e	Headerfile: exports from generate.c
generate.web	The original of generate.c (not used)
parse.y		Grammar, must be converted with yacc or bison
scan.l		Lexical scanner, must be converted with lex or flex
types.c		Some global type definitions, included in all other files
types.web	The original of types.c (not used)
util.c		Routines for hashing etc.
util.e		Headerfile: exports from util.c
util.web	The original of utils.c (not used)
wbuild.1	The manual page
wbuild.c	Main program
wbuild.web	The original of wbuild.c (not used)
wbuildmac.tex	TeX macros, used in wbuild-generated TeX files

			    Implementation
			    ==============
Wbuild was written using (Spidery) WEB. The WEB source is included in
the distribution, but isn't used. Instead, the C source files are
pre-generated (and prettyprinted with cb), so that anybody with a C
compiler should be able to compile them.

The parser was created with bison, but should work with yacc. The
scanner works with flex, but for some unknown reason fails with lex.

			      Copyright
			      =========
Copyright by Bert Bos. This version (1.17) of wbuild can be copied and
used freely by everybody.  It may not be sold.


7 Dec 1992				Bert Bos <bert@let.rug.nl>
