
                  32-bit Unicode Console API "read me!"

            Copyright (c) 1999-2000 Jonathan de Boyne Pollard.
         c/o 1 Queen's Close KENILWORTH  CV8 1JR, United Kingdom

              Jonathan de Boyne Pollard, FIDONET#2:257/609.3
              Jonathan de Boyne Pollard, FIDONET#1:109/921.70
          Jonathan de Boyne Pollard <J.deBoynePollard@tesco.net>


    Guarantee and Software licence
    

    The 32-bit Unicode Console API is copyrighted software, with all
    rights reserved by the author, which the author encourages everyone to
    share and to use freely.  The terms and conditions of the software
    licence, and the guarantee information, are contained in the on-line
    help document CONCALLS.INF.


    Installation
    

    To install the Console API simply unpack the distribution archive into
    a directory of your choice.

        PKZIP -extract -dir=curr CONAPI C:\CONAPI\ *

    ( This assumes that the distribution archive that you received was in
      ZIP format, and that you are using PKZIP version 2.50 for OS/2. )

    This will extract the files that comprise the utilities into various
    subdirectories of C:\CONAPI.  You will then need to add the relevant
    subdirectories to the LIBPATH and BOOKSHELF environment variables, and
    possibly the INCLUDE, LIB, IPATH, OS2_INCLUDE, or LIBOS2 environment
    variables as well, depending from your compiler.

        Add C:\CONAPI\TAU\BOOK to your BOOKSHELF environment variable
		Add C:\CONAPI\OS2\DLL to your LIBPATH directive

		Prepend C:\CONAPI\TAU\Include\OS2 to your C++ compiler's
			include path
		Add C:\CONAPI\OS2\Lib;C:\CONAPI\TAU\Lib to your C++ compiler's
			library path

    Using the Console API
    

	Using the Console API is simple.  Simply define the INCL_CONSOLE macro
	before the first inclusion of the <os2.h> header.  This will enable
	the declarations of the console API functions and types.

	Notice that with the modified <bse.h> that is supplied, defining the
	INCL_BASE enabling macro will now no longer automatically enable the
	declarations for the VIO, KBD, and MOU subsystems when <os2.h> is
	included.  To use the 32-bit VIO, KBD, and MOU subsystems, explicitly
	define the INCL_VIO, INCL_KBD, and INCL_MOU macros.

	The 16-bit subsystems are not available unless you explicitly retain
    your old <bsesub.h> header from the OS/2 Developers' Toolkit.
    Because, if you have followed the installation instructions, your C++
    compiler will locate the <bsesub.h> header supplied with this package
    before any other, it is suggested that you rename your old <bsesub.h>
    header to <bsesub16.h> and explicitly include it by that name.

	To link to the 32-bit VIO, KBD, and MOU subsystems, include the
	CON3216.LIB import library in the files passed to your linker.

	To link to the 32-bit Unicode Console API, include the CONCALLS.LIB
	import library in the files passed to your linker.


    Getting help after installation
    

    The on-line documentation is in the book CONCALLS.INF.  To read it,
    either double-click on the file on your Workplace Shell desktop or run
    the command

        VIEW CONCALLS

    at the command line.
