README file for liblist
-----------------------

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

As mentioned in the LSM file, this is a library for double linked lists. I
wrote this primarily for use in my own programs, since I found that I was
frequently re-writing linked-list code in several programs. There are
probably tons of linked-list code out there ;-) but I'll publish this anyway.

It has been developed and tested on a Linux system, but should work on any
platform with an ANSI C compiler.

The makefile, however 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.

Documentation for this library consists of a man-page and (of course :-)
the source code. I might write a LaTeX manual someday, if people ask. 
IMHO the function names are rather self-explanatory. 


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

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

Do a "make" in the source directory 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.

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


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

