%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

	     MagicPoint - an X11 based presentation tool

			    April 12, 2001

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

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 one of the alpha releases of MagicPoint.  We're planing to add
a 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 codes is derived from other people's works,
and may have different distribution policies.  Be sure to check the
comments in the source codes.


%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

			     INSTALLATION

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

Since MagicPoint extensively uses fonts in various sizes, we recommend
you to install good font rendering systems in your system.  

THIS DOCUMENT ASSUMES THAT YOU WILL USE MAGICPOINT WITH **TRUETYPE**
FONTS. YOU SHOULD INSTALL *FREETYPE* BEFORE YOU INSTALL MAGICPOINT.

To install "libttf.a", see:
	http://www.freetype.org/

 If you want to use other rendering systems, read "README.fonts" or
"README.fonts.jp".

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

Follow the steps below to make MagicPoint:

English or European:
	% ./configure

Japanese:
	% ./configure --enable-freetype-charset16

	% xmkmf
	% make Makefiles
	% make

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

Note: if you have to use a non-standard compiler, you must declare
      your compiler by using "env" command, like:

	% env CC=gcc ./configure		# force gcc
	% env CC=shlicc2 ./configure		# force shlicc2 (bsdi3)

      We cannot make a guess in the configure script, since "imake"
      may dislike the compiler that was guessed by configure.  This
      applies to, for example, Solaris without the Sun compiler
      license (gcc-only environment).


Note: If you are willing to use the iso-8859-x character set (i.e. you
      would like setlocale() to be called at startup), specify the
      "--enable-locale" option.

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

It's a good idea to preview sample files before installation. For more
information, see "sample/README" or "sample/README.jp", which
describes how to install TrueType fonts.

To visualize the sample{,-jp}.mgp file, type:

	% ./mgp sample/sample.mgp
	% ./mgp sample/sample-jp.mgp

To visualize the tutorial{,-jp}.mgp file, type:

	% ./mgp sample/tutorial.mgp
	% ./mgp sample/tutorial-jp.mgp

WE STRONGLY RECOMMEND TO BUY TRUETYPE FONTS IF YOU WANT TO GIVE YOUR
PRESENTATION WITH BEAUTIFUL FONTS.

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

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

	% su
	# make install
	# make install.man

If you want to paste EPS figures 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/

Stable release packages are available from:
	ftp://ftp.Mew.org/pub/mgp/

You can use anonymous CVS to catch up the latest. See:
	http://www.Mew.org/mgp/anoncvs.html

To join the mailing-list for MagicPoint, See:
	http://www.Mew.org/mgp/ml.html

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
