libenviron.a
============
This library contains a nunber of functions that fall into various
categories:

- enhanced standard functions:	getopt(), ...
- compatibility functions:	strmfe(), country(), ...
- utility functions:		error(), warn(), logmsg(), ...
- extras:			tab handling, csv file handling, 
				socket wrappers, ...

Compatibility functions are mainly useful functions that are not 
part of the Linux standard libraries but are implemented by all DOS 
compilers.

Enhanced and Utility functions are there to save writing by implementing
functions that are needed in most programs.

The extras are sets of functions that work together to provide
larger functions such as the ability to handle tabbed formatting
or reading and writing CSV files.

Most programs I write use some of these functions, so I've released this
library as a prerequisite for modifying or compiling other Open Source
packages I've released.

This version of the library was originally developed with Borland compilers
and subsequently modified to wotk with the djgpp port of the GNU gcc compiler.

Installation
============
If you're using the djgpp port of gcc you can use the binary version
of this library:
- Download environ-1.0.zip and unzip it.
- Copy the lib/libenviron.a library and the include/environ.h header
- into places where the compiler can find them. 

If you're using a different compiler or are going to develop programs with
it, you'll need its source in order to install the headers and compile the
library.

Download environ_srce-1.0.zip. and unzip it.

If you're using the djgpp port of gcc and have a suitable make program
you can compile the sources 'as is':
- change directory into environ
- edit Makefile so the LOCAL, LINC and LLIB variables match your
  development set-up. 
- run 'make all' in the environ directory. This compiles the 
  library functions, creates the archive and installs it and the
  environ.h header file

The environ/harness directory contains test harnesses and utility
programs. These can be compiled once the library and header have 
been installed:
- change directory into environ/harness
- edit Makefile so the lib and inc variables match your
  development set-up and the 'install' recipe installs the
  utilities in a suitable place. 
- run 'make all' in the environ/harness directory. This compiles the 
  library functions, creates the archive and installs it and the
  environ.h header file
- run 'make install' in the environ/harness directory to install the
  utilities.
- You can now run the harnesses and utilities to exercise the
  library functions.

Borland compilers have a slightly different set of library functions.
The differences are encapsulated in the files in the 'borland' directories.
Add them to the libraries by copying the contents of
- environ/borland         into environ
- environ/harness/borland into environ/harness

which will overwrite the matching files with Borland-compatible versions.
Then compile and install as described above.

Documentation
=============
The environ_docs-1.0.tar archive includes the complete documentation set 
for this library.

This includes manpages for the disptime and national utilities and for
the chopsearch, csv and country functions. The rest of the documentation
consists of a set of linked web pages. The entry point to this page 
set is the index.html page. There are no hyperlinks to pages outside
the doc directory, so the page set can be copied to any place that's more
convenient for web browser or webserver access.

Contact
=======
Author: Martin Gregorie, martin@gregorie.org


