								22 Dec 83

				Contents

	This is a short overview of the files in the IBM-PC interrupt-
driven COM: package, and related software.

$CONTENTS		This file.

BEAUTY.H		A set of macros and type definitions which
			enhance C program portability and reliability.
			The macros define an enhanced set of character
			and integer data types.  Edit this file to
			select your programming "model" (long pointers
			vs. short pointers).

BMAC.MAC		Assembly language macros which encapsulate the
			subroutine call interface.  The macros define
			names for subroutine arguments and temporary
			variables on the stack.  This version interfaces
			with Lattice C (aka Microsoft C).  Both large
			small programming "models" are supported.  A
			seperate version of BMAC could be created to
			interface to IBM Pascal, if desired.

BMACTST.ASM		This program tests the BMAC macros.

COM_PKG.ASM		The interrupt-driven COM package.

DOS.MAC			This file comes from the Lattice C distribution.
			It defines which programming "model" is being used,
			for the benefit of assembly routines.  It defines
			the PSECTs used for code and data.  Edit this file
			to select your programming "model".  This version
			of DOS.MAC fixes a "bug" in the standard Lattice C
			version.

EXIO.ASM		These routines provide additional machine I/O
			functions beyond the Lattice-supplied inp() and
			outp().  The new functions solve certain interrupt-
			and DMA-related problems in devices which require
			multi-I/O control sequences.  These routines are
			not used by the rest of the distribution at
			present, but may be used in the future.

EXMEM.ASM		These routines provide additional physical memory
			access.  Memory is accessed with 20-bit addresses.
			All of physical memory mey be accessed, regardless
			of the programming "model".

EXMEM.H			This file defines the p_addr (physical address)
			data type, and defines the return values of some
			of the EXMEM functions.

INT_PKG.ASM		These routines save and restore interrupt vectors.
			"Chained" vectors are not directly supported.
			Vectors may be saved/restored in one of three ways:
			DOS 1, DOS 2, or no DOS.

LPT_PKG.ASM		An interrupt driver and interface package for the
			line printer.  It uses the same circular buffer
			scheme as the COM package.  It is primarily
			intended for special applications, such as printing
			graphics.

TITLE.MAC		These macros provide functional replacements for
			the standard TITLE and SUBTTL macros.  A table of
			contents appears in the symbol table at the end
			of an assembly listing.

TRUTH.H			Contains type definitions for the bool (boolean)
			data type.

TSTCOM.C		A test program for the COM package.  Allows the
			IBM PC to act like a glass TTY connected to a host
			via COM1:.  This program is more useful when you
			are running the ANSI terminal driver.  There is
			no protection against DOS character traps
			(control-C, etc.).

TSTCOM2.C		A second test program for the COM package.  It
			allows the IBM PC to approximate an (expensive)
			null modem between COM1: and COM2:.

TSTEXMEM.C		This program tests the routines in EXMEM.  For
			complete confidence, the test should be run
			under the control of a debugger to verify the
			results.

TSTINT.C		A test program for INT_PKG.

TSTLPT.C		A test program for LPT_PKG.
