MLT/Miracle README
------------------

	Copyright (C) 2003-2004 Ushodaya Enterprises Limited
	by Charles Yates <charles.yates@pandora.be>
	and Dan Dennedy <dan@dennedy.org>

	MLT is a multimedia framework designed for television broadcasting, and 
	Miracle is a multi-unit video playout server with realtime effects.

	This document provides a quick reference for the minimal configuration,
	build and installation of MLT. See the docs directory for usage and
	development details.


Configuration
-------------

	Configuration is triggered by running:

	    ./configure 

	Usage is:

	./configure --help          - report all configure options
	./configure --prefix=[dir]  - target install directory (default: /usr/local)
	./configure --disable-[mod] - do not compile specified module(s)
	./configure --[other]       - pass through to children

	NB: This script must be run to register new services after a CVS checkout
	or subsequent update.


Compilation
-----------

	Once configured, it should be sufficient to run:

	    make

	to compile the system.


Testing
-------

	To execute the mlt tools without installation, or to test a new version
	on a system with an already installed mlt version, you should run:

	    . setenv

	NB: This applies to your current shell only and it assumes a bash or 
	regular bourne shell is in use.


Installation
------------

	The install is triggered by running:
	
	    make install 
	

More Information
----------------

	For more detailed information, please refer to docs/install.txt.