recio, Version 2.14, Release June 14, 1996.
Copyright (C) 1994-1996, William Pierpoint.


Description
-----------
The recio library consists of a set of a hundred functions that make it 
simple to read and write text files in which each line is treated as a data 
record, and each record is subdivided into fields.  Fields may be delimited 
either by a character, such as a comma, or by column positions.  Field 
types available are integer, unsigned integer, long, unsigned long, float, 
double, time_t, struct tm, character, and string.  Recio is easy to learn 
because (1) functions are based on analogous counterparts in stdio and 
(2) function names are based on a consistent set of mnemonics.


Getting Started
---------------
First check the MANIFEST file for brief one line descriptions of the files 
in this release.

Learning the recio functions will be easier if you read the documentation 
in the following order:

TUTOR.TXT  - Introductory material including some simple example programs.
USAGE.TXT  - Shows the typical order in which functions are used.
SPEC.TXT   - Specification of all functions and macros.  Use as reference.
TIPS.TXT   - Tips and ideas on using the recio functions.
DESIGN.TXT - Design and development notes.

To save disk space, this package contains the executable for only one of 
the test programs.  Source for other test programs is included.  To make 
all the test programs, see MKTEST.BAT.  This package also contains the 
libraries for only the SMALL and LARGE memory models.  To make libraries 
for all memory models, see MKLIBS.BAT.

All you need to do to use the recio functions in your application is to

#include "recio.h"

in your source code and link using the recio library for the memory model 
you are using.  For example, if using the small memory model, link with 
RECIOS.LIB.  If you use a compiler other than Borland C 3.1, you will need 
to recompile the source code.

If you use the recio library regularly, then you may wish to copy recio.h 
to your compiler's INCLUDE directory and copy the recio libraries to your 
compiler's LIBRARY directory.  You can then 

#include <recio.h>

in your source code and link to the recio library using the compiler's 
default paths.


Source Code
-----------
Complete C source code for recio is provided.  To recompile, you will need 
an ANSI-C compatible compiler.  This release used Borland C 3.1.  MKLIBS.BAT 
will generate all the libraries for this compiler.  Modify the MAKEFILE to 
reflect your setup and to set the memory model.  To use another compiler, 
you will need to generate libraries or object code for that compiler.  To 
port to another compiler, you may find useful information in the file
PORTABLE.


Distribution
------------
This is free software; you can redistribute it and/or modify it under the 
terms of the GNU General Public License, Version 1, February 1989, as 
published by the Free Software Foundation.

This software is distributed in the hope that it will be useful, but 
WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY 
or FITNESS FOR A PARTICULAR PURPOSE.  More details on the GNU General 
Public License can be found in the file COPYRITE.

You should have received a copy of the GNU General Public License along 
with this program; if not, write to the Free Software Foundation, Inc., 
675 Mass Ave, Cambridge, MA 02139, USA.


Archive
-------
The latest public version of the recio library is available from the 
Simtel software repository on the Internet.

For World Wide Web users, the URL (uniform resource locator) is: 

http://www.simtel.net/simtel.net/

and the ftp URL is: 

ftp://ftp.simtel.net/


Author
-------
Bill Pierpoint
wpierpoint@aem-east.com
