README file for the terminal-input library

DESCRIPTION
===========
This library contains a couple of functions (and their helpers) 
that simplify reading from the keyboard when using the shell.

The available functions are:

* flush-and-read(query :: <string>) => ans :: <string>

  This function flushes your parameter to the screen and then returns
  what the user enters at the terminal as a <string>.

* read-number(query :: <string>) => ans :: <integer>

  Same thing as flush-and-read, but in this case returns an <integer>
  from the user.  Read-number allows configuration from outside (The
  user can override *too-low* and *too-high* (exported variables that
  reference functions for behaviors past the established boundaries)
  for more descriptive error messages) and in:  it has several
  optional keyword parameters. 
  
  low:          the lowest <integer> allowed
  high:         the highest
  out-of-range: an optional function called instead of *too-low* or
		*too-high* when any boundary condition is surpassed.


INSTALLATION
============
I recommend you install this program in a directory like games/.
(You're not going to use it for enterprise application delivery, are
you?)  Follow the below steps to build the library.

$ gzip -cd terminal-input-1.0.1.tar.gz | tar xvf -
$ cd terminal-input
$ make

COPYRIGHT
=========
Dylan sources created by Douglas M. Auclair, dauclair@hotmail.com
Dylan sources copyright (c) 2000, Douglas M. Auclair under the LGPL 
(http://www.fsf.org/copyleft/lgpl.html)