A simple example of using the BOOLE libraries
---------------------------------------------

In the example/ directory, you will find the file simparse.c.  It is
an extremely simple example of how to use the BOOLE libraries.  After
compiling BOOLE, you should be able to execute

	cd example
	make
	simparse

and see the messages that BOOLE generates while taking the difference
of the two cones.  This run will leave three output files.  cone1.trim
and cone2.trim are the B-reps of the original two cones; cone3.trim is
the B-rep of their difference.

Simparse writes its output using the function write_solid in
simwrite.c.  The file format used there for B-reps of solids is a
straightforward ASCII representation, used internally at UNC for a
viewer.  Upon request, the output file format will be documented
here.  

The release version of BOOLE does not ship with the capacity to read
input files of any sort.  The reason for this is that our parsing
routines contain copyrighted code which we cannot freely distribute
(and which is difficult to port anyway).

---------------------------------------------------------------------
Please address all feedback concerning BOOLE to geom@cs.unc.edu, with
the word BOOLE in the subject.