The purpose of this file is to provide an overview of the MaMA, SaM,
and OMa applications kindly donated to the MAEstro distribution by its
developers from Sun Microsystems in the Netherlands (see the section
called "HISTORY" for more information about the developers).


(This file is adapted from information written by the developers.)

		Introducing MaMA, SaM and OMa Version 1.0


PRODUCT HIGHLIGHTS
------------------
****************************************************************************
*								           *
*	o  Full integration between the MAEstro multimedia authoring       *
*          environment and FrameMaker       	                           *
*								           *
*	o  Fully integrated in OpenWindows Version 3.0, including Classing *
*          Engine, Drag & Drop and Level 3 Internationalization            *
*								           *
*       o  MaMA - MAEstro and Maker Association: the missing link between  *
*          MAEstro and FrameMaker                                          *
*								           *
*       o  SaM - Stand-alone MaMA: for automatic playing of any number of  *
*          FrameMaker documents                                            *
*								           *
*       o  OMa - Open MaMA: take control of MaMA out of other environments *
*          e.g. from shells or even from FrameMaker                        *
*								           *
*	o  localized for the Dutch language, easy localizable for other    *
*          languages						           *
*								           *
*	o  Free software, no license required                              *
*									   *
****************************************************************************


ANNOUNCEMENT BRIEF
------------------
MaMA is a media editor for the MAEstro Multimedia Authoring Environment.

MaMA allows FrameMaker document pages to be integrated into
multimedia presentations, leveraging existing investments in FrameMaker
documentation and presentations. MaMA is fully capable of exploiting
FrameMaker's HyperText features.

Together with other media editors provided by MAEstro, you can now build
a presentation, using FrameMaker documents controlled by MaMA and, for
example, voice as comment to the FrameMaker document pages, controlled by
DTR (the MAEstro Digital Tape Recorder media editor for digital audio
files). Other media editors in MAEstro include, but are not limited to,
vcrEdit and cdEdit.

SaM is the stand-alone version of MaMA. It can be used when the MAEstro
environment is not available or not needed. SaM typically can be used
to automatically turn pages or jump to hyperlinks of FrameMaker
documents. For example, with FrameMaker you make your sheets for a
presentation. SaM now allows you to show these sheets in an order you
define, with a user-specified time until the next sheet will be shown.
When a presentation for SaM is made it can repeatedly be played for use
in demo-rooms, etcetera.

OMa is a tool with which especially SaM can be controlled from the 
command line. So SaM is "open on the backside". This also applies to
MaMA, but MaMA depends on the MAEstro protocol and will be controlled
by the central authoring application MAEstro provides.
OMa and SaM together can be used to make inter-active presentations
with FrameMaker documents.

-----------------------------------------------------------------------
FEATURES					BENEFITS
-----------------------------------------------------------------------

o Fully integrated in OpenWindows Version 3.0	Easy installation, plug
						and play environment.
						No time lost installing
						and maintaining MaMA.

o Links to FrameMaker				Leveraging mainstream
						DTP software to create
						an efficient and highly
						productive environment.

o FrameMaker version 2.1.1 & 3.0-X & 3.1 	No time lost due to 
  supported					investments in different 
						versions of FrameMaker.

o Inter-application communication via ToolTalk	Network wide communication
						between applications.

o consistent with other media editors		Easy acquaintance with other
						MAEstro applications.


HARDWARE AND SOFTWARE CONSIDERATIONS
------------------------------------

  - The complete source code for MaMA, SaM and OMa requires about 5 Mb
    memory.  The stripped executables only take 350 Kb memory each.

  - A running FrameMaker is needed when playing a presentation.

  - MAEstro is needed when using MaMA. It is not needed when only
    SaM is used.

  - A Sun SPARCstation IPX or better is preferable to play your
    presentations on.


VERSIONS
--------

  - MaMA and SaM are tested for the FrameMaker version 2.1.1 and
    3.0-X.  MaMA and SaM also support the use of the 3.1 OPEN LOOK
    version. There are different versions of MaMA and SaM to control
    the different FrameMaker versions. The MaMA and SaM version for
    FrameMaker 3.0-X can also be used for FrameMaker 3.1.


IMPLEMENTATION DETAILS
----------------------

  - MaMA and SaM are written in ANSI-C. The code can be compiled
    using acc (ANSI-C compiler) or gcc (Gnu ANSI-C compiler).  The
    communication with MAEstro is via the MAEstro inter-application
    messaging system, which is currently based upon RPC messages.  The
    communication from MaMA and SaM to FrameMaker is via RPC messages.
    MaMA is prepared to handle ToolTalk messages, so communications
    will be via ToolTalk messages as soon as FrameMaker listens to 
    ToolTalk messages.



CONTACTS
--------

For more information about the following software components, please
contact:

MAEstro		George Drapeau (MAEstro project leader)
                	(maestro@sioux.stanford.edu)

MaMA/SaM/OMa	George Drapeau of MAEstro
       			(drapeau@sioux.stanford.edu)

                Martien van Steenbergen 
			(Martien.Vansteenbergen@Holland.Sun.COM)

FrameMaker	comments@frame.com


HISTORY
-------

MaMA (MAEstro and Maker Association) was a project at 
Sun Microsystems Nederland B.V. where the authors performed
their graduation for the HIO Enschede. Martien van Steenbergen, 
the MaMA supervisor at Sun, got the authors interested in a 
MAEstro/FrameMaker link. After the feasibility was investigated, the
project was started and lasted for three months until June 1992. The 
graduation project resulted in the three applications: MaMA, SaM and
OMa.


ABOUT THE AUTHORS
-----------------

Hendrik K. Blokhuis is a 21 year old HIO graduate, who has had a 5 month
industrial training at HCS IA, Apeldoorn. where he worked on a "Space 
experiment simulator" and 5 month industrial training at Sun Microsystems 
Nederland B.V. Amersfoort (5 months), where he created a Office automation 
demonstration environment.

Simon L. Voogd is a 25 year old HIO graduate, who has had a 5 month 
industrial training at the National Physics Laboratory, London, UK., 
where he worked on the standardization of the Vienna Development Methodology.
The second industrial training he performed at Paninfo AG, Zurich, Switzerland
(6 months), where he helped with the implementation of backup/restore tool 
for large UNIX systems.

Both authors have gained much experience in GUI's, multimedia, etc. and 
project management during the 3 months graduation project at Sun Microsystems
Nederland B.V., when they were working on the MaMA project.

Interests of both the authors lay in the field of multimedia, GUI's, 
application development, etc..


About HIO Enschede
	At the HIO Enschede a vast part of computer science is taught. 
	The education is UNIX-based and a lot of experience with 
	UNIX and C is gathered through the education. 
	The graduation subjects are: 
	Computer Networks, Computer Performance, Operating Systems, 
	Artificial Intelligence, Database Management, Compilers, 
	Marketing and Law.


LIABILITY
---------

Copyright (c) 1992 Sun Microsystems Nederland B.V. and HIO Enschede

Permission to use, copy, modify, and distribute this software and
its documentation for any purpose is hereby granted without fee, provided
that (i) the above copyright notices and this permission notice appear in
all copies of the software and related documentation, and (ii) the name
Sun may not be used in any advertising or publicity relating to
the software without the specific, prior written permission of Sun.

THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND,
EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY
WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

IN NO EVENT SHALL SUN BE LIABLE FOR ANY SPECIAL, INCIDENTAL,
INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND, OR ANY DAMAGES
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER OR NOT
ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF LIABILITY,
ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
SOFTWARE.



QUESTIONS AND ANSWERS
---------------------

    Q1: How do I create hyperlinks in FrameMaker?

    A1: See chapter 3 of the "FrameMaker Reference" guide.


    Q2: How will MaMA be supported?

    A2: George Drapeau, the principal author of MAEstro at Stanford,
	cannot commit to any level of support for MaMA, but will distribute    
        MaMA, and will try to support as best as he can, given his limited  
        resources, but cannot guarantee any level of support. If others 
        contribute changes and improvements, however, he will be happy to 
        distribute them as part of the MAEstro release.


    Q3: Why does MaMA or MAEstro not use ToolTalk?

    A3: When developing MAEstro, ToolTalk was not available. It, therefore,
        was impossible to build the inter-application messaging protocol
        upon ToolTalk.
        MaMA and SaM are able to receive ToolTalk messages. They both
        have been made ready to listen to a ToolTalk protocol. OMa
        is the tool to use for sending ToolTalk messages to either MaMA
        or SaM.


    Q4: Why is there no Action "Goto Page Nr" supported by MaMA?

    A4: FrameMaker can receive a message "Goto Page", but this results 
        in a popup window asking to specify the page number. This means 
        user inter-action, which could endanger the time notion of a 
        presentation.
        The way to jump to pages in a FrameMaker document is to use the 
        Action "Jump To Hyperlink" with a name specified. The advantage
        is that you can always be sure to jump to the right page even if
        some pages have been inserted or deleted before desired one.


    Q5: Can the MAEstro multimedia authoring environment be used for
        making inter-active presentation?

    A5: Although the MAEstro messaging protocol supports such
	development, no one has yet written a MAEstro "authoring
	application" that provides for interactivity on the viewer's
	part.  One of the basic notions of MAEstro is that
	interactivity is in the creation process, so the current
	software release includes tools biased toward that end, as
	opposed to most multimedia software which tends to focus more
	on viewer interactivity (or "structured presentation").
        not allow you to make inter-active presentations. When you, however,
	
        However, if you want to make a presentation that includes
	viewer interactivity using only FrameMaker documents, it is
	possible to do so.  For this you have to use SaM (the
        stand-alone version of MaMA) and OMa. By putting OMa commands under
        FrameMaker hyper buttons, you can control SaM. For example, you can
        put the command "OMa -play" under a hyperbutton called
        "Press when finished reading" in your FrameMaker document.
        When the user presses this button in the FrameMaker document the 
        presentation will continue.


    Q6: Why are different versions of MaMA and SaM required for different 
        versions of FrameMaker?

    A6: FrameMaker is "open on the backside", other applications
        can control FrameMaker by RPC messages. However, FrameMaker 2.1.1
        uses another RPC protocol than FrameMaker 3.0-X. To support both
        version different versions of MaMA and SaM are needed.


    Q7: Why does MaMA not compile under (K&R) C?

    A7: ANSI C is considered to be a better alternative to K&R C. 
        The effort to also support K&R C is comparable to obtaining 
        and ANSI C compiler. Please remember that a free ANSI C compiler 
        can be obtained from the Free Software Foundation.


    Q8: How and when will FrameMaker support ToolTalk?

    A8: At this time, it is unknown if, when and how FrameMaker will
        support ToolTalk. Please contact your local FrameMaker 
        Sales Office or send email to comments@frame.com.


    Q9: Which machines are preferable to be used for MaMA and SaM?

    A9: It is preferable to use a SPARCstation IPX or better for MaMA and 
        SaM. These machines contain enough memory to make smooth 
        presentations with FrameMaker. MaMA and SaM are targeted at Sun
        SPARCstations, they support ToolTalk, full desktop integration and
        OPEN LOOK user interfaces, for perfect user-friendliness.


   Q10: How could MaMA be developed in only three months?

   A10: The authors could focus on the functionality of the application 
	rather than the environment. 
	Sun Microsystems Inc. provides a very powerful high-level and 
	rich environment.

	OPEN LOOK GUI
		Simple, consistent and efficient graphical user interface,
		augmented by the OPEN LOOK Style Guide, a very valuable
		piece of documentation.

	ToolTalk
		Inter-application communication interface for network 
		environments, not bound to just the local system.

	Classing Engine
		Identifying the characteristics of desktop objects.
		Provides consistency throughout applications and a
		predictable behaviour.

	Drag and Drop
		Operation on desktop objects in an intuitive way by 
		using direct manipulation. Provides an easy and
		efficient way of handling your data.

	X11/NeWS
		Industry standard environment for developing the next 
		generation of desktop tools.

	XView
		Free X toolkit implementation of the OPEN LOOK Spec. Easy
		to program and maintain.

	Devguide
		Application for easy making Graphical User Interfaces in
		complete accordance with the OPEN LOOK Spec.

	SPARCstations
		Multimedia ready: CD-rom, video, high resolution colors,
		hifi audio quality, etc.
		Based upon the leading SPARC RISC CPU.

	FrameMaker, OpenMaker
		Desktop publisher to easily create and maintain professional
		documentation.
		OpenMaker provides easy access to FrameMaker documents by
		RPC messages.

	MAEstro
		Multimedia Authoring Environment in which it is possible
		to create and maintain multimedia documents by the use
		of tools (media editors) in stead of programming lower-
		level code.


	All together, having such a rich environment and powerful hardware,
	it is possible to make very interesting applications in a short spell.
