
------------------ M a M A  /  S a M  /  O M a - installation ------------------

RUNNING THE DEMO
----------------

After unpacking:

	% setenv MaMAHOME <install_dir>
	% set path = ($MaMAHOME/{MaMA,OMa} $path)

Now start FrameMaker 3.1A, the OPEN LOOK version, current documents
only work with this version.

Then start SaM:

	% cd $MaMAHOME
	% SaM Demo/SaMandOMa_Editlist

	SaM will be started and loaded with the demo. Clicking the play
	button runs the demo.

Try it together with MAEstro's TimeLine:

	When you already have the MAEstro environment installed, you can
	also have a MaMA demo. Type:

	% TimeLine &
	% MaMA ./Demo/MaMA_Editlist

	MaMA will be started and loaded with the demo. Clicking the play
	button runs the demo. Also using TimeLine gives the opportunity 
	to see the demo

	For these demos you need the FrameMaker 3.1A version.


INSTALLING
----------

	set $MaMAHOME to the install directory
	e.g. /Volume/MaMA
	set $GUIDEHOME to the directory where Devguide resides
	set $FMHOME to the directory where your FrameMaker version resides

	cd $MaMAHOME/MaMA

	"make CE"		# installs the Classing Engine attributes 

        quit File Manager and start a new one. This is needed because only
	then File Manager knows the new Classing Engine attributes

	add $MaMAHOME/MaMA to $HELPPATH

	"make MaMA"		# for an executable of MaMA

	"make SaM"		# for an executable of SaM (Stand-alone MaMA)

	"cd $MaMAHOME/OMa; make OMa"	# for an executable of OMa

!!!	Before you "make MaMA" or "make SaM" be aware that you link the
	proper MaMA_client*.c file.
	you can do this by editing the Makefile and look at lines 40-45.

	If you want to use the DUTCH version, type: "mv $MaMAHOME/MaMA/DUTCH_LOCAL C"
        and "setenv HELPPATH $MaMAHOME/MaMA/C" and start MaMA/SaM from $MaMAHOME/MaMA.
	

Usage
-----

	MaMA:

	-p <port #>	connects to specified port number.
	-h <hostname>	connects to the specified hostname.
	   <filename>	loads the specified editlist file, while starting.


	SaM:

	   <filename>	loads the specified editlist file, while starting.


	OMa:

	-m <hostname>	(Needs to be the first arg. and sends the message
			 to the machine called <hostname>)
	-open <editlistfile>             _
	-play                             \
	-pause                             \
	-stop                               \
	-select_nr <#>                       |-> Send this message
	-select_label <editlabel>           /
	-repeat_on                         /
	-repeat_off                      _/

NOTES
-----

	PREFERENCES

	You can set preferences like the command FrameMaker needs to 
	launch, and the auto mount directories, which will be chopped off
	of the directory names.


	LOADING FRAMEMAKER DOCS

	Beware that loading FrameMaker documents demands quite some time,
	and sometimes some user interaction.
	Therefore it is preferable to open the documents by FrameMaker
	and iconify them, before the presentation is played. this way the
	documents only have to pop up, instead of loaded.



BUGS
----

	The CLOSE action for FrameMaker 3.0 documents is QUITting the document.
	This is a FrameMaker bug, and should be altered by Frame Technology in
	due time.

	Zooming pages dirties a FrameMaker document, this causes a notice
	when quitting a document. You will be asked to save the changes.
	This is not necessary, also this is a FrameMaker bug.

	When adding something to the code, which asks for a 'gxv', you
	should touch all '.c'-files to avoid XView warnings.

	For bugs/errors/fixes please send an error report to MAEstro
	(e-mail: maestro@sioux.stanford.edu)


--------------------------------------------------------------------------------

CONTENTS

ANNOUNCEMENT
CDPlayer			CD player that listens to MUTE ToolTalk message
Demo				Demo MaMA and SaM EditLists
Image				Lots of imageas used in docs & code
MaMA				Home of MaMA and SaM, should equal $MaMAHOME
MaMA/DUTCH_LOCAL		Dutch locale of MaMA and SaM
MaMA/Objects.MaMA		*.o for MaMA goes here
MaMA/Objects.SaM		*.o for SaM goes here
MaMA/bin.sh			CE installation and RPC generation
MaMA/include			All include files, including icons & glyphs
MaMA/include/images		Icons and glyphs
MaMA/include/CE			CE template
Mute				Mute, one-button ToolTalk MUTE App
OMa				Home of OMa, Open MaMA; command line IF to MaMA
PostScript			UserGuide and GraduationReport
Presentation			Presentation used during graduation meeting
