This is the README file for MathSpad 0.60 .

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

To install MathSpad, you need to run the Install script. It will look
for a C and C++ compiler, compile the system, check if errors occurred
and install it. Afterwards (with your consent) an email message is sent to 
Eindhoven in order to keep track of the level of interested, the systems
it compiles on and any installation problems.

To install the program execute the command:

	./Install

It will install the system in the /usr/local directory if you have the
permission to do that. Otherwise the system will be installed in the
current directory. You can specify the full path as an argument if
you want to use a different location.

If you don't want the message to be sent or you are more familiar
with the GNU configure scripts, you can use the sequence

	./configure
	make all
	make check
	make install


Testing
-------

After successfully installing the system, you need to test if everything
works (and if the system is useful for you). You can do this with the
command

	src/mathpad manual &

The program will display a welcome document explaining what the system
offers you and how to go further.

If the warning 'Unable to add fontpath.' or 'Cannot load font ...' occurs,
you may need to do some extra work after you have decided to use the
program. The main problem with the installation is letting the Xserver
know where the extra fonts are located. MathSpad changes the font path
of the Xserver (if needed) but this will not always work:

  * If you run MathSpad on a remote host, it will not know which
    directory contains the fonts on your local host. You can use the
    environment variable MATHPADFONTPATH to specify the correct
    directory on your local host (where the Xserver is running).

  * If you are using an X terminal, MathSpad is not able to change the
    font path because it needs to add a font server to the font path.
    You can set up your own font server or ask the system manager to
    adjust the configuration of the standard font server. There is an
    example configuration file for xfs in the lib/mathpad/fonts
    directory.

  * If you are using an X emulator (for MS Windows, for example), you need to
    convert the BDF fonts to the correct format. The X emulator should
    have a utility for this.


Cleaning Up
-----------

Once everything is working satisfactorily you may clean up by removing a 
number of files that are no longer necessary.  The procedure is very simple
but depends on whether or not the directory in which you have installed 
MathSpad is the same as the directory in which the Install program is located.
If they are the same then run the CleanUp program. If they are not
(for example, if you have installed MathSpad in /usr/local) then all you need 
to do is to remove the directory containing the Install program (lock, stock 
and barrel).


Suggestions, comments, wishes, bugs
-----------------------------------

If you have suggestions, comments or wishes, or if you have found bugs,
you can send them to mathpad@win.tue.nl and someone (I) will respond
as soon as possible.


Richard Verhoeven.
