		SCCSid "@(#)README 2.3 11/16/93 LBL"

Hello and welcome to the Radiance synthetic imaging system.  This is
the eighth release, Version 2.3, and it includes all source files.
Radiance is free, copyrighted software developed at Lawrence Berkeley
Laboratory in California and EPFL in Switzerland.

To find out what's new in this release, check the document in doc/notes
called ReleaseNotes.  Also, be sure to read the BUGS file in the same
directory for information on known bugs and workarounds for various systems.

IMPORTANT:  Be sure to get whatever is in the pub/patch directory on hobbes'
anonymous ftp account or the second file on your tar tape and follow the
instructions in the README file therein.

We have attempted to make it easier for you (and for us) to install
the software on differently configured systems using a global make
script.  To install the software, just type:

	makeall install

You can clean up the .o files and so forth with:

	makeall clean

Or, if you are confident you can do both at the same time with:

	makeall install clean

You can give other make options at the end of the command as well.  For
example, the -n option will tell you what makeall is going to do without
actually doing it.

The makeall script asks you questions about your system and where you
want to install the executables and library files.  The pathnames you
give should be relative to root for the programs to work properly.  You
may also use the tilde ('~') character to give paths starting with
someone's home directory.

If you do NOT have X11 support, please read the note "noX11.help" in
this directory.  It explains what to change to make things work.

Although it is set automatically by makeall, individuals may want to
set the RAYPATH environment variable manually.  This variable tells
Radiance where to look for auxiliary files, and usually includes the
current directory as well as the system library (ray/lib in this
distribution).  As you develop auxiliary files yourself, it is often
useful to add in your own library directory before the system directory.
An example setting such as this would go in a user's .login file:

	setenv RAYPATH .:${HOME}/mylib:/usr/local/lib/ray

After installing the software, you may want to start by reading the
basic documentation contained in "doc/ray.1".  Use troff with the "-ms"
macro package.  There is also a tutorial called "doc/tutorial.1".
Unfortunately, the figures for these two documents were done on a
Macintosh and cannot be transferred to a troff file.  The figures can
be found in the file "doc/mac.sit.hqx".  Included therein is also an
incomplete draft of a more comprehensive user's manual which is
currently being written.  Comments on this document are welcome.

Individual manual pages may be found in the subdirectory "doc/man1".
You may want to copy these to the system manual directory, or set the
MANPATH variable on systems that support it.  To print out the manual
pages, use the "-man" macro package. 

For your convenience, we have also included the reference manuals and
man pages in PostScript form in the doc/ps subdirectory.  If you have a
question, the answer is probably in one of these manuals, but you must
read everything very carefully.  Also, read the file doc/notes/ReleaseNotes
for information about this release and changes from previous versions.

Good luck, and if you have any questions or comments, please contact
me at:

	Lawrence Berkeley Lab
	1 Cyclotron Rd., 90-3111
	Berkeley, CA  94720
	tel:  (510) 486-4757
	fax:  (510) 486-4089
	GJWard@lbl.gov

-Greg Ward
