YIFF Sound Systems

                      Installation Instructions


	* NOTICE: YOU DO NOT HAVE TO BUILD THE THE YIFF SOUND  *
	* SERVER IF YOU JUST WANT TO BUILD LIBY2. LIBY2 DOES   *
	* NOT REQUIRE THAT THE YIFF SOUND SERVER BE INSTALLED. *


    Basic Installation Overview:

	Step 1: (optional) Build the YIFF Sound Server.
	Step 2: (optional) Build libY2.
	Step 3: (optional) Build the YIFF utility programs.
	Step 4: (optional) Build the YIFF Configuration program.
	Step 5: (optinoal) Set up the YIFF Sound Server.


    1. (optional, Linux only) Build the YIFF Sound Server:

	Go to the yiff subdirectory and edit the <makefile>
	(where <makefile> is the appropriate Makefile for
	your system) as needed.

	For adding libkmid support, make sure you add
	-DHAVE_LIBKMID to the CFLAGS line and -lkmid to
	the LIB line.

	Then run 'make clean' then 'make -f <makefile>'.

	If compile is successful, then type 'make install' (su to
	root as needed).

	Note that the default configuration file is no longer installed
	automantically, you will need to manually install yiffrc
	to either /usr/etc or /etc if you do not have one already.


    2. (optional) Build libY2:

	Go to the libY2 subdirectory and run `make clean' then
	'make -f <makefile>', where <makefile> is the appropriate
	Makefile for your system.

	If compile is successful, then type 'make install' (su to
	root as needed). This will install the library in
	/usr/lib, manual pages in /usr/man/man3, and header files
	in /usr/include/Y2.


    3. (optional, requires step 2) Build the YIFF utility programs:

	Go to the yiffutils subdirectory and run `make clean' then
	'make -f <makefile>', where <makefile> is the appropriate 
        Makefile for your system.

	If compile is successful, then type 'make install' (su to
	root as needed).


    4. (optional, requires step 2) Build the YIFF Configuration program:

	Go to the yiffconfig subdirectory and run `make clean' then
	`make -f <makefile>', where <makefile> is the appropriate
        Makefile for your system.

	If compile is successful, then type 'make install' (su to
	root as needed).


    5. (optional, requires step 1) Set up the YIFF Sound Server:

	If you have built the YIFF Configuration Wizard, then
	run yiffconfig (make sure you are in X snf su to root).
	Or you may manually edit the configuration file
	/usr/etc/yiffrc.

	IMPORTANT: The Audio mode value `cycle' needs to be set to
	a precise value for each Audio mode. The `out of the box'
	configuration values for the Audio modes should work in
	most cases, however if they do not (ie causes gaps or breaks
	in the Sound stream) then you will have to modify the values.

	Cycle values too small will cause a delay before an audio
	is played, cycle values too big will cause clicks in the
	audio.


    Notes:

	Misc data files in the `stuff' subdirectory are not installed
	automatically, if you wish to have those installed then manually
	go to the `stuff' subdirectory and run `make install'.