RenderWare(tm) v1.4 FCS Libraries
                    =================================

----------------------------------------------------------------------------
These libraries are copyright Criterion Software Limited 1995. All Rights
Reserved. You may not disassemble, decompile or reverse engineer these
libraries.

These libraries are furnished under a license agreement or a non-disclosure
agreement. The software may be used or copied only in accordance with the
terms of the agreement. It is against the law to copy the software on any
medium except as specifically allowed in the license or non-disclosure
agreement.

RenderWare is a trademark of Canon Inc.
----------------------------------------------------------------------------

This directory contains the libraries of the RenderWare(tm) v1.4 release
for MS-Dos.

Library Naming
--------------

The names of the libraries located in this directory are derived using
the following naming scheme:

    RW<platform><calling convention><numeric type><kernel type>.LIB

Where:
    <platform>           is 'W' for Microsoft Windows 3.1 libraries and
                            'D' for DOS libraries.

    <calling convention> is 'R' for the register based argument passing and
                            'S' for stack based argument passing.

    <numeric type>       is 'X' for fixed-point libraries and
                            'L' for floating-point libraries.

    <kernel type>        is 'P' for production libraries and
                            'D' for debugging libraries.

For example,

    RWWRXP.LIB is the MS Windows 3.1, register based calling convention,
               fixed-point, production version of the library.

and,

    RWDSLD.LIB is the DOS, stack based calling convention, floating-point,
               debugging version of the library.

All the libraries have identical APIs and, therefore, share the same include
files (found in the \rw\include\ directory of this distribution).

Platform
--------

Simply link against the version of the library for the platform you wish to
build for.

Calling Convention
------------------

Simply link against the library whose calling convention matches the one
used by your application.

Numeric Type
------------

See the main readme for this distribution (\rw\readme.txt) and Chapter 2 of
the RenderWare reference manual for a discussion of the fixed and floating-
point versions of RenderWare. Having decided whether to use fixed or floating-
point RenderWare (and having modified your application if necessary) simply
link against the appropriate library.

Kernel Type
-----------

Two versions of the RenderWare library kernel are available to developers. The
production and debugging versions. The debugging version contains considerably
more parameter validation and error checking than the production version. The
debugging version also issues messages about errors and potential problems to
a debugging stream. The debugging libraries are particularly useful in
identifying missed API level error conditions, tracing the parsing of problem
scripts, and when requesting technical support from the RenderWare technical
support group.

This additional error checking and validation causes the debugging library to
be considerably larger and slower than its production equivalent. Therefore,
is is essential that the production kernel be used in all production builds.
The debugging kernel must only be used during the application development process.

It is important to note, however, that the debugging kernel is designed to
behave externally in exactly the same way as the production kernel. The flow
of control is the same in both libraries. The debugging kernel will not attempt
to abort an operation if its additional error checking detects an error. Instead,
it attempts to issue informational messages which will assist the developer and
RenderWare technical support to identify the problem.

To use the RenderWare debugging kernel simply relink your application against
the appropriate debugging library. No recompilation is necessary. For
more information on the debugging kernel see Chapter 1 of the RenderWare
reference manual.

                    =================================