Welcome to the CARL Software Distribution. In the Sun3 version,
you should have extracted a file called Install.ms, which describes the issues
involved in installation. Actually, there are only a few issues
to be concerned about.

The first  pertains to include files. In the subdirectory called include,
you will find a subdirectory called carl, and a file called whoami.h.
 The following files should be edited to reflect the characteristics
of your system:
	include/carl/config.m4
	include/carl/defaults.h
	include/carl/paths.h
	include/whoami.h

The config.m4 file sets the pathnames for certain target directories that must
exist on your system for the installation to work.  You should either create
the directories that are named in config.m4, or you should edit the file
to contain directories that do exist on your system.  The only
modification you should probably have to make in config.m4 is the
setting for m4ROOTNAME. This will define the root of the directory
where almost all CARL files and programs will go. The SNDFILESYSTEM
that you select should be bicsf for the Sun3, unless you are very
brave or very foolish.

 The defaults.h file contains information
regarding your converters, especially the sampling rate. Be sure the
definitions therein are applicable to you. Finally, the whoami.h file identifies
the  sysname and cpu type of your system, ex. snoball and SUNCPU.   You can
keep CARL defined if you have customized the sampling rate information in
defaults.h to be the same as the CARL converters.
THe contents of the include directory will be copied into /usr/include.
That is where they should go, that is where they will go by default.

The second issue is the necessity of a Fortran compiler. We use the
f77 compiler. On a Sparc we use Sparcworks Fortran. The Fortran libraries
are necessary for the compilation of the libieee library and certain
other programs such as pvoc, lpc, and certain sig and filter programs. 
If a Fortran compiler is not available on your system, you will not get
much of the functionality of the CARL Distribution. You should be able
to compile cmusic and a few other utilities, however. If you do have a
Fortran compiler and libraries available,
be sure you also have plenty of space in /tmp, as Fortran tends to
fill up tmp space. Make sure that the static library names for FORTLIBS
listed in config.m4 are actually the same as the libraries on your system.

Issue 3: in the directory src/frm/spect, the spect program is a nice
little program for visualizing wave forms. It was written to depend
on the libplot.a library that once came with 4.3BSD UNIX.  If you happen
to have this library, you can uncomment the spect program from the
Makefile.m4 file in that directory, and include the program in your
build. It is not included by default.

Issue 4: in the src/sunprogs directory, two programs are not included
in the build by default. The sunplot program requires the SunCore Library
lcore. If you happen to have such a beast, you can include sunplot in
your build. The program sun2vax must be compiled on a Vax to be of use
to you. If you have a Vax, then you win.

The last issue is simple. Run make -f Makefirst in the installation directory.
All else is automatic if the pathnames in config.m4 refer to valid directories.

The Install.ms document gives more information on the installation process.

Regards,

Susan Fichera
Systems Programmer,  CARL Project


NOTES: 3/2/93 - I have added a copy of the libieee.a archive randon
library to the libieee directory. Users who do not have access to
a Fortran compiler can allow this library file to be used in
the make instead.
