README file for libmat
----------------------

Introduction
------------ 

This library contains functions for manipulating 4x4 matrices and 3D and 4D
vectors. These are most commonly used in 3D graphics, for which these
calculations are fundemental. I'm in the process of experimenting with 3D,
and use these functions a lot. So I've assembled them into a separate
library.

The makefile, uses several UN*X/GNU tools, and might have to be changed
considerably for non-UN*X/GNU platforms. If anyone writes a makefile for
another platform, I'll be happy to include it the distribution.


Installing the library
----------------------

Read the Makefile. Change HDEST and LDEST to your preferences (they should
work pretty well on Linux systems).

Tip for GCC users: Set the environment variables C_INCLUDE_PATH and
LIBRARY_PATH to help GCC find your include- and library files.

Do a "make" to build the library.

Login as root, change to the source directory, to do a "make install". You
might want to check beforehand that no other library/header file with the
same name exists in the installation directories, *since they will be
replaced*.

The man-page should be copied to somewhere like /usr/local/man/man3 by
hand (as root). One day I'll put it in the makefile.


Removing the library
--------------------

Login as root, change to the source directory, and do a "make uninstall" to
remove the shared library and header file. You can than delete the source
code.


Contacting the author
---------------------

Please send bugs, patches, features you'd like to see etc. to me.
You can contact me at the following addresses.

email:         rsmit06@ibm.net
smail-mail:    R. Smith
               Dr. Hermansweg 36
               5624 HR Eindhoven
               The Netherlands

