	     MagicPoint - an X11 based presentation tool

			  September 4, 1998

MagicPoint is an X11 based presentation tool.  It is designed to make
simple presentations easy while to make complicated presentations
possible.  Its presentation file (whose suffix is typically .mgp) is
just text so that you can create presentation files quickly with your
favorite editor (e.g. Emacs).

This is alpha release of MagicPoint.  We're planing to add version
control mechanism of .mgp file for forward compatibly.  But currently,
such a mechanism is missing. Please use this package at your own risk.

MagicPoint is completely free but absolutely no warranty. For more
information, please refer to COPYRIGHT or COPYRIGHT.jp.  Please note
that some of the source code is derived from other people's work, and
may have different distribution policy.  Be sure to check the comment
in the source code.


			     INSTALLATION

Since MagicPoint extensively uses fonts in various sizes we recommend
you to have good font rendering capability in your system.  Please
refer to README.fonts for detail.

- Short summary for non-Japanese readers:

We recommend you to either:

    (1) compile MagicPoint with FreeType linked, or
    (2) use X11 server with good outline font capability.

The former one is recommended.  For the latter case, it should be okay
if you have adobe Type1 font in X11 font directory.  There are some
advanced methods, such as modified X11 server.

- Short summary to Japanese readers:

We recommend you to either:

    (1) compile MagicPoint with FreeType and VFlib linked, or
    (2) compile MagicPoint with FreeType linked, or
    (3) compile MagicPoint with VFlib linked, or
    (4) use X11 server with outline English/Japanese font capability.

At this moment, MagicPoint uses FreeType only for English fonts, and
VFlib only for Japanese fonts.  Therefore, Approach (1) is the best.
(4) needs some special software as standard X11 server will not render
Japanese scalable font files.


Follow the steps below to make MagicPoint:

	% ./configure
	% xmkmf
	% make Makefiles
	% make

Note1: if you have vflib installed AND you do NOT want to compile the
vflib support into the binary, try the following option: 
	% ./configure --disable-vflib

Note2: if you have FreeType installed AND you do NOT want to compile the
FreeType support into the binary, try the following option: 
	% ./configure --disable-freetype

Invoking `configure' updates Imakefile.  So, do NOT forget to invoke
`xmkmf' every time you update Imakefile.

It's a good idea to preview a sample file before installation.

	% ./mgp sample/tutorial.mgp

For more information, see sample/README or sample/README.jp.

When you believe that everything is OK, install MagicPoint as follows:

	% su
	# make install
	# make install.man

If you want to paste EPS figure into your presentation, you will need to
install ghostscript or alike.

			     FOR MORE INFO

Official home page of MagicPoint is "http://www.Mew.org/mgp/".

Latest packages are available from "ftp://ftp.Mew.org/pub/MagicPoint/"
as well as this home page.

Please send comments to the developer mailing-list "mgp@Mew.org".

There are two mailing list for magicpoint users:
	mgp-users@Mew.org	(language: English)
	mgp-users-jp@Mew.org	(language: Japanese)
For subscription, please send an email to
	mgp-users-ctl@Mew.org	or
	mgp-users-jp-ctl@Mew.org
with "# guide" in the email body (without quotes).
