packages icon
README file for libar
---------------------

Introduction
------------
This library implements a flexible array, that grows as needed. You can
store objects of any size in the array as long as their sizes are all the same.
(as with any array). Of course the array is limited to the amount of (virtual)
memory available.

The installation procedure also installs a manual page for the library. You
can read it with the command `man 3 libar'.

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 the directory where the header-file (HDEST),
libraries (LDEST) and manualpage (MANDIR) will be installed 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 include the locations mentioned in the makefile to help GCC
find your include- and library files once you start using the library.

Do a "make all" to build the library.

Login as root, change to the source directory, and 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 istallation procedure installs both a static and a shared version of
the library. If you want to link with the shared library, use `-lar' when
linking. To use the static library, use `-lar'.


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

Login as root, change to the source directory, and do a "make uninstall" to
remove the shared library, header file and manual page. 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.

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