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

	     MagicPoint - an X11 based presentation tool

			    September 9, 2003

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

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 1: 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.

Note 2: If you have libraries installed at odd places, use the option
      --with-searchpath=/your/odd/path. E.g. if you have installed libfreetype
      on MAcOS X from Fink, use ./configure --with-searchpath=/sw
      Multiple directories need to be included in quotes and seperated with
      spaces.

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

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

Alternatively you can build a native package (RPM, DEB, PKG, ...) for
your operating system with the EPM package manager (freely available
from http://www.easysw.com/epm/) and install this package. The configu-
ration file for the packages is "mgp.list".

The EPM method has the advantage that you can uninstall magicpoint later
if you no longer need it or want to upgarde to a new version. The following
commands for instance generate a Debian package and a RPM package on linux
systems:

	% su                    # necessary on Debian only
	$ epm -f deb -nm mgp    # creates DEB in subdirectory linux-*/
	$ epm -f rpm -nm mgp    # creates RPM in subdirectory linux-*/

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://member.wide.ad.jp/wg/mgp/

Stable release packages are available from:
	ftp://sh.wide.ad.jp/WIDE/free-ware/mgp/

To join the mailing-list for MagicPoint, See:
	http://member.wide.ad.jp/wg/mgp/ml.html
	http://member.wide.ad.jp/wg/mgp/ml-jp.html (in Japanese)
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
