Jen'93 - Serial port CONIO.H (JENSERIO), version 1.00.

COPYRIGHT NOTICE.

Copyright 1993 by Maarten Hofman. These files may be used freely for private
use. It is allowed to use these files commercially under the condition that you
are a registered user and that my name appears in your programme. Please do not
distribute these sourcecodes, or modified versions thereof, without this README
file. Registering will give you the most recent version of this package. How to
register is mentioned at the end of this README file.

WHAT IS JENSERIO?

JENSERIO is a collection of C-routines with names and functionality similar to
routines in the conio.h library of Turbo C. I decided against using the same
names, because this would give conflicts with the original library. Instead,
all functions are prepended with a 'j' which replaces the 'c' (of console) if
it was present. A lot of function weren't implemented, because they were too
difficult or because I didn't see any use for them. It uses the ANSI escape
codes, and should be compatible with most ANSI terminals. The start and stop
bits, the baudrate and the parity have to be set before using the functions
from this package, this can be done using the MODE command.

JENSERIO was written with the Xaal'Tiqincis project in mind, a project of which
you will hear more in the future.

CONTENTS.

This package contains the following files:

SERIO.C   - The file that needs to be in your project if you use JENSERIO.
SERIO.H   - The file containing the prototypes. Include this if you use 
            JENSERIO.
SERIAL.H  - Used by SERIO.C. You don't need to include this one.
SERIODM.C - Demonstration programme of JENSERIO. Doesn't show much, but gives
            an idea of the usage.
README    - This file.
SERIO.DOC - Small documentation file of the functions in SERIO.C.

The files were tested using Turbo C++ 3.0, but should work on most other C
compilers.

HOW TO USE THIS PACKAGE.

To check the demonstration programme: put SERIO.C and SERIODM.C in a project 
and compile this. It's possible that some warnings appear, but it should work. 
It's possible that you want to COM1: instead of COM2:, this needs to be changed
in the init_serio() function in SERIODM.C.

If your compiler doesn't support seperate compilation or projects, then it's
always possible to #include SERIO.C. Some #include commands will become 
superfluous by this, and should be removed.

If anything is unclear, or you discover bugs in this package, please do not
hesitate to inform me. My address is written at the bottom of this README file.

UPCOMING MODIFICATIONS.

Later versions of this package will possibly include:
* More functions of the CONIO.H.
* ANSI-colour.
* Other terminal emulations (VT52).
* Better CR/LF handling.
* Less bugs (I hope).

REGISTERING

Registering gives you the newest version of this package and information about
upcoming versions (and maybe other programmes). Registering can be done by
sending $5 to me (address mentioned below) indicating that you are interested
in the JENSERIO package. If you have acces to internet, you'll receive the
sources by Email, please include your Email-address. Otherwise you should
include a self-addressed, stamped envelope and an additional $1 for the disk.
People living in Holland: please pay using dutch guilders.

Email address: maarten@einstein.et.tudelft.nl

Address: Maarten Hofman
         Hendrik Tollensstraat 126
         2624 BJ Delft
         Holland
