---------------------------
The \TNT\EXAMPLES Directory
---------------------------

The \TNT\EXAMPLES directory contains a number of sample TNT DOS Extender
programs, most of which are described in the documentation that comes
with the SDK.  This file, \TNT\DOCS\EXAMPLES.TXT, describes the contents
of each directory.

If there are differences between the code reproduced in the manuals and
the code on the distribution disks, the code on the distribution disks
is correct.

Each example directory contains MS-DOS batch files for building all the
examples in that directory.  The batch files are named according to
compiler and program style:

MSCDOS.BAT	Builds DosStyle programs using the Visual C++, 32-bit 
		Edition compiler.

MSCNT.BAT	Builds NtStyle programs using the Visual C++, 32-bit 
		Edition compiler.

BCDOS.BAT	Builds DosStyle programs using the 32-Bit Borland C++ 
		compiler.

BCNT.BAT	Builds NtStyle programs using the 32-Bit Borland C++ 
		compiler.

HCDOS.BAT	Builds DosStyle programs using the MetaWare High 
		C/C++ compiler HC386.

WCDOS.BAT	Builds DosStyle programs using the WATCOM C/C++32 
		compiler.

WCNT.BAT	Builds NtStyle programs using the WATCOM C/C++32 
		compiler.

For example, to build NtStyle versions of all the programs in the
EXAMPLES\C directory with the Visual C++, 32-bit Edition compiler:

	C:\>cd \tnt\examples\c
	C:\TNT\EXAMPLES\C>mscnt

Of course, to build and run any example programs, you must also have (1)
the \TNT\BIN directory and the appropriate compiler BIN directories on
your executable PATH, (2) the \TNT\INCLUDE and appropriate compiler
INCLUDE directories in the INCLUDE, and (3) the \TNT\LIB and the
appropriate compiler LIB directories in the LIB environment variable.
For the 32-Bit Borland C++ compiler, the BCC32.CFG and TLINK32.CFG
configuration files must contain this information.  Please refer to the
C/C++ User's Guide to TNT DOS Extender for more information on building
programs.

Most of the example directories also contain a RUNALL.BAT file which
will execute the programs built using the command files in that
directory.

-------------------------------
The \TNT\EXAMPLES\ADS Directory
-------------------------------

The ADS directory contains the C source files needed to build the
"Towers of Hanoi" sample AutoCAD Development System (ADS) program with
the Microsoft Visual C++, 32-Bit Edition compiler.  These files are
redistributed with the permission of Autodesk, Inc.

ADS.H		Header file for ADS programs.

ADSCODES.H	Header file for ADS programs.

ADSDLG.H	Header file for ADS programs.

ADSLIB.H	Header file for ADS programs.

BUILD.BAT       Batch file to build the TOWER program with the Microsoft
		Visual C++, 32-Bit Edition compiler.

BUILDALL.BAT	Builds all ADS sample programs that come with AutoCAD
		using Visual C++

TOWER.C		ADS program to solve the "Towers of Hanoi" problem.


-------------------------------
The \TNT\EXAMPLES\ASM Directory
-------------------------------

The ASM directory contains simple assembly language programs that make
TNT DOS-Extender and DOS system calls.

BUILDALL.BAT	Builds all the sample programs.

DOSDEMO.ASM     This program performs a variety of MS-DOS system calls
		from protected mode.  It makes screen, keyboard, and
		file I/O system calls.  The file TEST.SCR can be used as
		input to this program.

HELLO.ASM       A short application which prints out the string "Hello
		world" on the screen.  This example illustrates how to
		make MS-DOS system calls.

PECHO.ASM       A program which echoes its command line arguments to the
		screen.  This example illustrates how to access the
		MS-DOS command line from a protected-mode program.  For
		example, the command:
		        PECHO TESTING 1 2 3
	        displays "TESTING 1 2 3" on the screen.

RMHELLO.ASM     A short real-mode program that uses 80386 instructions
		and 32-bit instruction operands.

SCRTEST.ASM     This program demonstrates how to access directly the
		physical screen memory from a protected-mode program,
		using segment selector 001Ch.  The program clears the
		screen and displays the PC character set on the screen
		in a banner box.

TEST.SCR	sample input for DOSDEMO.EXE


---------------------------------
The \TNT\EXAMPLES\BCDLL Directory
---------------------------------

The \EXAMPLES\BCDLL directory contains a sample Dynamic Link Library to
be build with the 32-Bit Borland C++ compiler.

DLLTEST.C	Main program that exports data to the DLL.

DLLTEST1.IMP    386|LINK commands identifying objects imported by
		DLLTEST.

DLLTEST1.XPO    386|LINK commands identifying objects exported from
		DLLTEST.

DLLTEST2.LNK	TLINK32 commands for linking DLLTEST.

MYDLL.C		DLL that exports a function to the main program.

MYDLL1.IMP      386|LINK commands identifying objects imported by MYDLL.

MYDLL1.XPO      386|LINK commands identifying objects exported from
		MYDLL.

MYDLL2.DEF      Module definition file for MYDLL to be used with
		TLINK32.

MYDLL2.LNK	TLINK32 commands for linking MYDLL.


-----------------------------------
The \TNT\EXAMPLES\BCWPIPE Directory
-----------------------------------

The \EXAMPLES\BCWPIPE contains the Borland implementation of the Windows
interface to the temperature conversion program described in Chapter 5
of the Windows Interface Guide.

BCCTOF4.BAT	Batch file to build the 16-bit C program from the
		command line.

CTOF-WIN.IDE	Project file for the Borland IDE.

CTOF4.C		16-bit C implementation of the Windows side of the
		interface.

CTOF4.DEF	Module definition filed used for linking.

CTOF4.ICO	Icon file.

CTOF4.RC	Resource descriptions for the Resource Compiler.

CTOF4.RSP	Linker response file referenced by BCCTOF4.BAT.

RESOURCE.H	C header file describing the resources processed by the
		Resource Compiler.


---------------------------------
The \TNT\EXAMPLES\BENCH Directory
---------------------------------

The \EXAMPLES\BENCH directory contains the Benchmark example described
in Chapter 4 of the Windows Interface Guide.

BENCH.EXE	The Visual Basic program.

DOBENCH.C	The benchmark driver program.

FLTBENCH.C	The floating point benchmarks.

INTBENCH.C	The integer benchmarks.

MAIN.FRM	Visual Basic form for the user input form.

MAIN.TXT        Text for the code associated with the user input form.

PERF-BAS.TXT	Text for the code module.

PERF-FRM.TXT    Text for the code associated with the graphical display
		form.

PERF.BAS	Code module for the Visual Basic program.

PERF.FRM	Visual Basic form for the graphical display form.

PERF.MAK	Visual Basic make file.

PIPE.C		Encapsulated WinPipe routines.

PIPE.H		Header file for the encapsulated WinPipe routines.

WAITING.FRM	Visual Basic form for the waiting message form.

WAITING.TXT     Text for the code associated with the waiting message
		form.

There are a number of files with names of the form

	[INT|FLT][BC|MW|VC|WC][16|32].[EXE|PIF]

where

	INT	integer benchmark
	FLT	floating point benchmark

	BC	32-Bit Borland C++ compiler
	MW	MetaWare High C/C++ compiler
	VC	Microsoft Visual C++, 32-Bit Edition compiler
	WC	WATCOM C/C++32 compiler

	16	16-bit compiler
	32	32-compiler

	EXE	executable file
	PIF	Program Information File

These are the compiled benchmark programs.  All benchmarks are compiled
DosStyle; for example, INTBC32.PIF is the Program Information File for
the integer benchmarks compiled with the 32-bit Borland C++ compiler.


-----------------------------
The \TNT\EXAMPLES\C Directory
-----------------------------

The C directory contains simple C programs that make TNT DOS Extender
and DOS system calls, and illustrate some basic concepts of the TNT DOS
Extender environment.

CHGDIR.C        A DosStyle program that uses INT 21h APIs not available
		to NtStyle programs to set the current directory.

FREEMEM.C       Demonstrates methods for determining how much free
		memory is available.

HELLO.C		The standard "Hello world" C program.

ISTNT.C		Demonstrates how to determine whether you are running
		under TNT DOS-Extender or Windows NT.

LIBTEST.C       A simple program that calls C library routines, TNT DOS-
		Extender system call routines (_dx_*) from DOSX32.LIB,
		and DOS system call routines (_dos_*) from DOS32.LIB (or
		from the C run-time library, for the MetaWare and WATCOM
		compilers).

MEMSTATS.C	A simple program that uses the _dx_config_inf() and
		_dx_vm_stats() system calls to print out memory usage
		statistics.  This program can be built both DosStyle
		and NtStyle.

MIXPRENV.C      A "hybrid" NtStyle program that dynamically determines
		whether it is running under TNT DOS Extender.  If it is,
		the DosStyle interface is used, otherwise the NtStyle
		interface is used.  Because of the dynamic
		determination, this program can run native under Windows
		NT even though it makes  INT 21h calls.  (The INT 21h
		calls are never executed in Windows NT.)

NTPRENV.C       An NtStyle program that prints the DOS environment
		strings.

NTPURE.C        A "pure" NtStyle program that can be run under both
		Windows NT and TNT DOS Extender.

NTTEST.C        A simple program that demonstrates using both INT 21h
		and NtStyle Win32 API subset calls to get the current
		date and time.

PRINTENV.C      A DosStyle program that prints the DOS environment
		strings and illustrates techniques for accessing FAR
		memory from a protected-mode program.

REALVECS.C      Prints out the real-mode interrupt vector table,
		illustrating techniques for accessing conventional
		(real-mode) memory from a protected-mode program.

SHARCHLD.C	Child program that shares memory with SHAREMEM.C

SHAREMEM.C	Demonstrates sharing memory between NtStyle processes.


--------------------------------
The \TNT\EXAMPLES\CALC Directory
--------------------------------

The \EXAMPLES\CALC directory contains the simple interest calculator
example described in Chapter 4 of the Windows Interface Guide.

CALC-BAS.TXT	Text for the code associated with the code module.

CALC-FRM.TXT	Text for the code associated with the form.

CALC.BAS	Visual Basic code module.

CALC.EXE	Visual Basic program.

CALC.FRM	Visual Basic form.

CALC.MAK	Visual Basic make file.

INTEREST.C      TNT DOS-Extender programs that computes the interest.

INTEREST.PIF    Program Information file for the TNT DOS-Extender
		program.


--------------------------------
The \TNT\EXAMPLES\CTOF Directory
--------------------------------

The \EXAMPLES\CTOF directory contains the temperature conversion utility
described in Chapter 3 of the Windows Interface Guide.

CTOF-BAS.EXE    Visual Basic program for the version of the temperature
		conversion utility that uses the WinPipe API.

CTOF-BAS.TXT    Text for the Visual Basic code associated with the
		version of the temperature conversion utility that uses
		the WinPipe API.

CTOF-FRM.TXT    Visual Basic form for version of the temperature
		conversion utility that uses the WinPipe API.

CTOF1.C         "Pure" C-language version of the temperature conversion
		utility.

CTOF1.EXE       Program for the "pure" C-language version of the
		temperature conversion utility.

CTOF2.EXE       Program for the "pure" Visual Basic version of the
		temperature conversion utility.

CTOF2.FRM       Form for the "pure" Visual Basic version of the
		temperature conversion utility.

CTOF2.MAK       Make file for the "pure" Visual Basic version of the
		temperature conversion utility.

CTOF2.TXT       Text for the code associated with the form for the
		"pure" Visual Basic version of the temperature
		conversion utility.

CTOF3.BAS       Visual Basic code module for the version of the
		temperature conversion utility that uses the WinPipe
		API.

CTOF3.C         TNT DOS-Extender version of the temperature conversion
		utility that uses the WinPipe API.

CTOF3.EXE	Executable for CTOF3.C

CTOF3.FRM       Form for the Visual Basic version of the temperature
		conversion utility that uses the WinPipe API.

CTOF3.MAK       Visual Basic make file for the version of the
		temperature conversion utility that uses the WinPipe
		API.

CTOF3.PIF       Program information file for the TNT DOS-Extender
		version of the temperature conversion utility that uses
		the WinPipe API.

UGLY.EXE        Program with the incorrectly specified KeyPress event
		procedures.


---------------------------------
The \TNT\EXAMPLES\CUSER Directory
---------------------------------

The CUSER directory contains the sample programs described in the C/C++
User's Guide to TNT DOS Extender.

COLORS.C	Sample program using the Win32 Console API.

CRITER.C, CRITHAND.ASM
		Demonstrates installing a critical error handler.

EXCEP.C, EXCEP2.C, EXCEP3.C
		Demonstrates structured exception handling with the
		Microsoft Visual C/C++, 32-Bit Edition and 32-Bit
		Borland C++ compilers.

IOSAMPLE.C      Sample program using the Win32 Serial Communications
		API.

LIST.C, PHAR_MEM.C
		Sample memory allocation programs.

PIPE_IT.C, PIPECHLD.C
		Sample program using NtStyle pipes.

PVIDEO.C        Protected-mode version of RVIDEO.C that uses real-mode
		FAR pointers.

PVIDEO2.C       Protected-mode version of RVIDEO.C that uses the screen
		segment, 001Ch.

RVIDEO.C        Real-mode program that accesses video memory directly.

SIGNAL.C        Demonstrates installing a CTRL/C handler with the
		signal() function.

SIMPLE.CPP      Simple C++ program that shows class constructors and
		destructors executing in protected mode.

TERM.C		Demonstrates termination handling with try-finally.

TEST.SCR	Response file for running the SIGNAL program.

TIMER.C, GETDS.ASM
		Sample program that takes over the timer tick interrupt.

-------------------------------
The \TNT\EXAMPLES\DLL Directory
-------------------------------

The \DLL directory contains the sample programs described in Chapter 12,
"Building and Using Dynamic Link Libraries," of the TNT DOS-Extender
Reference Manual.

PHAR_MEM.C      Sample memory allocation program modified to count calls
		to malloc().

PRINT_FX.C, PRINT_PS.C
		Stub "printer drivers" to demonstrate run-time dynamic
		linking.

PTEST.C		Driver program for PRINT_FX and PRINT_PS.

TRACEDLL.C      DLL code to replace VirtualAlloc() (or whatever Win32
		routines is called by malloc() ) with a front-end that
		counts the number of calls.


---------------------------------
The \TNT\EXAMPLES\ERRNO Directory
---------------------------------

The \EXAMPLES\ERRNO directory contains a sample program that illustrates
referencing the errno global variable set by routines in the C run-time
library.  The build files in this directory build the program all 
possible ways with each compiler.

ERRNO.C		Program referencing errno.


------------------------------------
The \TNT\EXAMPLES\FLTBENCH Directory
------------------------------------

The \EXAMPLES\FLTBENCH directory contains a sample floating point
benchmark program.

DOBENCH.C       Driver and timing routines for running the benchmarks

FLTBENCH.C	Main program and the benchmark functions.


-----------------------------------
The \TNT\EXAMPLES\FULLSCR Directory
-----------------------------------

The \EXAMPLES\FULLSCR directory contains a collection of subroutines and
a driver program illustrating how to perform full- screen I/O from
protected mode.

FULLSCR.C       Main program that determines how long it takes to write
		"hello world!" at random locations and in random colors
		all over the screen 30,000 times.

SCREEN.C        Collection of subroutines that perform the actual screen
		I/O.

SCREEN.H	Header file for screen I/O routines.


---------------------------------
The \TNT\EXAMPLES\GDEMO Directory
---------------------------------

The example programs in the GDEMO directory illustrate calling real-mode
libraries from a protected-mode program.  This example is also described
in Chapter 9 of the TNT DOS-Extender Reference Manual.  You can build
the protected-mode GDEMO.EXE program with any supported 32-bit C/C++
compiler.  Because you must use either the 16-bit Microsoft C/C++
version 7.0 compiler or the 16-bit Microsoft Visual C++ compiler to
build the real-mode GSERVER.DRV program, this program is included in the
example directory.

GDEMO.C         The main protected mode C program that makes calls to
		real-mode Microsoft C graphics routines.

GGLUE.C, PROT.ASM
		Protected-mode glue code for handling cross mode
		function calls.

GRAPH.H         This file is not distributed on the SDK disks, but is
		required in order to build the GDEMO example.  You must
		copy it from the INCLUDE directory for your copy of the
		16-bit Microsoft C compiler.

GSERVER.BAT     Builds real-mode GSERVER.DRV with the 16-bit Microsoft
		C/C++ version 7.0 compiler.

GSERVER.C       The real mode Microsoft C program that links in the
		graphics library.

GSERVER.DRV	Real-mode 16-bit graphics server.

GSERVER.H       A C header file that defines the communication protocol
		between the real- and protected-mode code.

REAL.ASM        Real-mode glue code for handling cross mode function
		calls.


---------------------------------
The \TNT\EXAMPLES\HCDLL Directory
---------------------------------

The \EXAMPLES\HCDLL directory contains a sample Dynamic Link Library to
be built with the MetaWare High C/C++ compiler.

DLLTEST.C	Main program that exports data to the DLL.

DLLTEST.IMP 	386|LINK commands identifying objects imported by
		DLLTEST.

DLLTEST.LNK 	386|LINK commands for linking DLLTEST.

MYDLL.C		DLL that exports a function to the main program.

MYDLL.IMP 	386|LINK commands identifying objects imported by MYDLL.

MYDLL.LNK 	386|LINK commands for linking MYDLL.

WRITESTR.ASM    Assembly language routine to write a string to the
		screen during DLL initialization.


------------------------------------
The \TNT\EXAMPLES\INTBENCH Directory
------------------------------------

The \EXAMPLES\INTBENCH directory contains a number of popular integer
benchmark routines.

INTBENCH.C	Main program and the benchmark functions.

DOBENCH.C       Driver and timing routines for running the benchmarks.


------------------------------------
The \TNT\EXAMPLES\INTHNDLR Directory
------------------------------------
The \EXAMPLES\INTHNDLR directory contains the example interrupt handlers
described in Appendix B of the TNT DOS-Extender Reference Manual.  It
includes the following sample programs:

CCMAIN.C        Main routine for CTRLC.EXE. that calls through to
		assembly language program in CTRLC.ASM.

CRITERR.ASM     Demonstrates how to find a real mode stack frame from a
		protected-mode handler for the MS DOS critical error
		interrupt.

CTRLC.ASM       Demonstrates how to correctly call C code from an
		interrupt handler for the MS DOS CTRL C interrupt.

ERR387.ASM      Demonstrates processing a hardware interrupt (IRQ13, the
		coprocessor interrupt) and returning.

ICHAIN.ASM      Demonstrates how to chain to a previous handler for 
		INT 21h.

SERIO.ASM       Demonstrates how to write bimodal handlers (one real-
		mode and one protected-mode handler) to service a
		hardware interrupt (IRQ4, serial port 1) that occurs
		frequently.

TIMEINT.C,TIMEINTA.ASM
		Times the overhead for interrupt processing.

----------------------------------
The \TNT\EXAMPLES\LOADER Directory
----------------------------------

The \EXAMPLES\LOADER directory contains a sample DosStyle program that
demonstrates the use of the Load EXE File system call (2529h).  (This
call is not available for NtStyle programs.)

FARHELLO.ASM    A simple program that terminates with a FAR return,
		rather than exiting to DOS.  This behavior makes it
		suitable for loading and executing with LOAD.EXE.

LOAD.C		The example loader program.

LOAD2.ASM	Glue code used to transfer control to the loaded file.

The LOAD.EXE program takes a single command-line argument, the name of
the file to load and execute.  For example, to load and execute
FARHELLO.EXE, type:

	C:\>load farhello.exe
 
This example shows how you can use the 2529h call from within your
DosStyle application to load and execute an EXE file as an overlay or
child program.  In this example, we call the child program with a FAR
call, and when the child has completed execution, it returns with a FAR
return.  You can, of course, make the interface between the application
and child process more complex depending on your needs.

The example child program which we build here is called FARHELLO, and it
simply writes the string "Hello world" on the console and does a FAR
return back to the application.  Note that it does not do an INT 21h,
subfunction 4C to exit - this would cause both the application and child
to exit.  It instead does a FAR return to get back to the application.


---------------------------------
The \TNT\EXAMPLES\MCTOF Directory
---------------------------------

The \EXAMPLES\MCTOF directory contains the Windows front-end for the
temperature conversion program built using Microsoft Foundation Classes
and the Microsoft AppWizard, as described in Chapter 5 of the Windows
Interface Guide.

MAINFRM.H, MAINFRM.CPP
		These files contain the frame class CMainFrame, which is
		derived from CFrameWnd and controls all SDI frame
		features.

MCTOF.CPP       Main application source file that contains the
		application class CMctofApp.

MCTOF.DEF       This file contains information about the application
		that must be provided to run with Microsoft Windows.

MCTOF.H         Main include file for the application that declares the
		CMctofApp application class.

MCTOF.MAK       Project make file compatible with the Visual C++
		Workbench and also compatible with the NMAKE program
		provided with the Professional Edition of Visual C++.

MCTOF.RC        Listing of all of the Microsoft Windows resources that
		the program uses.

MCTOFDOC.H, MCTOFDOC.CPP
		These files contain the CMctofDoc class.

MCTOFVW.H, MCTOFVW.CPP
		These files contain your CMctofView class.  CMctofView
		objects are used to view CMctofDoc objects.

MYDIALOG.H, MYDIALOG.CPP
		Implementation of the main program dialog.

README.TXT	Text file generated by AppWizard describing the files
		created and used by AppWizard.  README.TXT contains more
		detailed descriptions than you are currently reading.

RESOURCE.H      This is the standard header file, which defines new
		resource IDs.

STDAFX.H, STDAFX.CPP
		These files are used to build a precompiled header (PCH)
		file named STDAFX.PCH and a precompiled types (PCT) file
		named STDAFX.OBJ.

RES\MCTOF.ICO	Program icon.

RES\MCTOF.RC2	Program resources.


---------------------------------
The \TNT\EXAMPLES\MDRAW Directory
---------------------------------

The \EXAMPLES\MDRAW directory contains the sample mouse program that
illustrates linking real-mode code into a protected-mode executable.
This program is described in Chapter 9 of the TNT DOS-Extender Reference
Manual.  The batch files in this directory build both the realcopy and
realbreak versions of MDRAW.  The realcopy version is named MREAL1.EXE
and the realbreak version is named MREAL2.EXE.

MDRAW.C		The sample mouse program.

MREAL.ASM	The real-mode code for the mouse program.

REALBRK.C       The RealBreak() function, used by the realbreak version
		of MDRAW to translate a protected-mode code address to a
		real-mode code address.

REALCOPY.C      The realcopy() function, used by the realcopy version of
		MDRAW to allocate conventional memory and copy the
		real-mode code and data down.

---------------------------------
The \TNT\EXAMPLES\MOUSE Directory
---------------------------------

The \EXAMPLES\MOUSE directory contains a simple program that illustrates
calling a real-mode interrupt handler from protected mode.  Once the
program has made sure that a mouse is available, it displays the current
mouse position as the mouse is moved around the screen.  Pressing any
mouse button terminates the program.  This program uses in-line assembly
language to call the mouse driver.

MOUSE.C		Mouse program.


-----------------------------
The \EXAMPLES\MSDLL Directory
-----------------------------

The \EXAMPLES\MSDLL directory contains a sample Dynamic Link Library to
be built with the Microsoft Visual C++, 32-Bit Edition compiler.

DLLTEST.C	Main program that exports data to the DLL.

DLLTEST1.IMP    386|LINK commands for identifying objects imported by
		DLLTEST.

DLLTEST1.XPO    386|LINK commands for identifying objects exported from
		DLLTEST.

DLLTEST2.DEF    Module definition file identifying objects exported by
		DLLTEST; used when compiling and linking separately.

DLLTEST2.LNK	Microsoft LINK commands for linking DLLTEST.

DLLTEST3.DEF    Module definition file identifying objects exported by
		DLLTEST; used when compiling and linking in one step
		with CL.

MYDLL.C		DLL that exports a function to the main program.

MYDLL1.IMP      386|LINK commands for identifying objects imported by
		MYDLL.

MYDLL1.XPO      386|LINK commands for identifying objects exported from
		MYDLL.

MYDLL2.DEF      Module definition file identifying objects exported by
		MYDLL.

MYDLL2.LNK	LINK commands for linking MYDLL.


-----------------------------------
The \TNT\EXAMPLES\MSWPIPE Directory
-----------------------------------

The \EXAMPLES\MSWPIPE contains the Microsoft C implementation of the
Windows interface to the temperature conversion program described in
Chapter 5 of the Windows Interface Guide.

CTOF-WIN.MAK	Project file for Microsoft Visual Workbench.

CTOF4.C		16-bit C implementation of the Windows side of the
		interface.

CTOF4.DEF	Module definition filed used for linking.

CTOF4.ICO	Icon file.

CTOF4.LNK	Linker response file referenced by MSCTOF4.BAT.

CTOF4.RC	Resource descriptions for the Resource Compiler.

MSCTOF4.BAT	Batch file to build the 16-bit C program from the
		command line.

RESOURCE.H	C header file describing the resources processed by the
		Resource Compiler.


------------------------------------
The \TNT\EXAMPLES\PHARLAPX Directory
------------------------------------

The \EXAMPLES\PHARLAPX directory contains a sample programs calling
routines in the PHARLAPX API.

CALLBACK.ASM    Callback routine which increments a variable pointed to
		by the far pointer passed as an argument.

CALLBACK.H	Header file for CALLBACK.ASM

NAMETEST.C	Test of name registration functions.

RCVPKT.C	Receives packets from a message queue.

SNDPKT.C	Allocates a message queue and send packets to it.

VMHND.C		Gets VM handle for current Virtual Machine

VMKEY.C         Sends the specified key to the specified Virtual Machine
		in ASCII only


------------------------------------
The \TNT\EXAMPLES\REALCOPY Directory
------------------------------------

The \EXAMPLES\REALCOPY directory contains a program that illustrates
calling installing a real-mode interrupt handler in an NtStyle program.
The techniques illustrated in this program can be used for sharing any
real-mode code in an NtStyle program.

BCREAL.BAT	Batch file for building the real-mode code with the
		16-bit Borland C++ compiler

BIMODAL.H	Header file that defines data structures shared by the
		real- and protected-mode portions of the program

MSCREAL.BAT	Batch file for building the real-mode code with the
		16-bit Microsoft Visual C++ compiler

PROT.C		Protected-mode program that installs the real-mode
		interrupt handler

REAL.C		Real-mode interrupt handler

REALA.ASM	Real-mode assembly language "glue" code


-----------------------------------
The \TNT\EXAMPLES\REALMEM Directory
-----------------------------------

The \EXAMPLES\REALMEM directory contains a program that illustrates
calling the TNT DOS-Extender real-mode memory functions.

REAL.ASM	Assembly language glue routines.

REALMEM.C	Program to test real-mode memory functions.


---------------------------------
The \TNT\EXAMPLES\SB386 Directory
---------------------------------

The \EXAMPLES\SB386 directory contains sample programs described in the
386|SRCBug Reference Manual.  The MSCDOS.BAT command file builds only
the EASYBUG.EXE program.  Because it uses FAR pointers, the KABOOM.EXE
program can only be built with MetaWare High C/C++ or WATCOM C/C++32.

DEBUG.SCR       Debug script for a sample debugging session with 
		KABOOBUG.EXE.  This debug script is described in Chapter 5
		of the 386|SRCBug Reference Manual.

EASYBUG.C	A program with a very simple bad pointer bug.  This program
		is used as an example in Chapter 1 of the 386|SRCBug 
		Reference Manual.

KAB2BUG.C	The I/O module with 2 bugs.

KABOOM1.C	The main module of the KABOOM game.

KABOOM2.C	The I/O module without bugs.


-----------------------------------
The \TNT\EXAMPLES\STRTEST Directory
-----------------------------------

The \EXAMPLES\CALC directory contains the string reversing example
described in Chapter 3 of the Windows Interface Guide.

STR-BAS.TXT	Text for the code associated with the code module.

STR-FRM.TXT	Text for the code associated with the form.

STRREV.BAS	Visual Basic code module.

STRREV.EXE	Visual Basic program.

STRREV.FRM	Visual Basic form.

STRREV.MAK	Visual Basic make file.

STRTEST.C	TNT DOS-Extender programs that reverses the strings.

STRTEST.PIF     Program Information file for the TNT DOS-Extender
		program.


----------------------------------
The \TNT\EXAMPLES\SYSINF Directory
----------------------------------

The \EXAMPLES\SYSINF directory implements many of the Win32 functions in
the System Information API, as described in Chapter 67, "System
Information," of Volume 2 of the Microsoft Win32 Programmers Reference.

MAIN.C		Simple program to test the calls in the DLL.

README          A short description of the API functions implemented
		and the differences from the Win32 implementation.

SYSINF.BOR	386|LINK file for linking Borland C++ version of SYSINF.DLL

SYSINF.C	Implementation of the System Information API.

SYSINF.MSC	386|LINK file for linking Visual C++ version of SYSINF.DLL


-----------------------------------
The TNT\EXAMPLES\ETS\TERM Directory
-----------------------------------

The \TNT\EXAMPLES\TERM directory contains a sample terminal emulation
program.  This program illustrates installing a bimodal interrupt
handler in an NtStyle program.

BCREAL.BAT	Batch file to build the real-mode code with the 16-bit
		Borland C++ compiler

COMISR.C	8250 Serial I/O chip interrupt handler.

INTIFACE.ASM    Assembly language utility routines for setting up the
		stack frame so you can do most of your
		interrupt/exception processing in C.

INTIFACE.H	C header file for the function in INTIFACE.ASM.

IO.H            Definitions for interfacing to the 8250 serial port and
		the 8259 interrupt controller.

MSCREAL.BAT	Batch file for building the real-mode code with the
		16-bit Microsoft Visual C++ compiler.

QUEUE.C		32-bit queue manipulation utility routines.

QUEUE.H		Header file for the functions in QUEUE.C.

QUEUE16.C 	16-bit queue manipulation utility routines

REAL.C, REAL.H	Real-mode interrupt handler

REAL16.ASM	16-bit assembly language glue routines

TERM.C		Terminal emulation program.


---------------------------------
The \TNT\EXAMPLES\TVDEMO Directory
---------------------------------

The \EXAMPLES\TVDEMO directory contains a batch files to build the
TVDEMO sample program distributed by Borland.


BUILD.BAT 	Batch file to build TVDEMO as a TNT DOS Extender program.

COREDMY.C       A replacement version of the coreleft() function, for
		use with this example only.

GETFILES.BAT	Batch file to copy the Borland files to this directory.

TVOBJS.LNK	Linker response file identifying objects needed for
		Turbo Vision applications.  This file may be used with
		386|LINK and TLINK32.


-------------------------------
The \TNT\EXAMPLES\VDS Directory
-------------------------------

The \EXAMPLES\VDS directory contains the sample program described in
section 10.10 of the TNT DOS-Extender Reference Manual, demonstrating
how to check if Virtual DMA Services (VDS) are present.

DMA.C           Sample program that prints out the VDS interface version
		number and supported features.


---------------------------------
The \TNT\EXAMPLES\WCDLL Directory
---------------------------------

The \EXAMPLES\WCDLL directory contains a sample Dynamic Link Library to
be built with the WATCOM C/C++32 compiler.

DLLTEST.C	Main program that exports data to the DLL.

DLLTEST.IMP     386|LINK commands identifying objects imported by
		DLLTEST.

DLLTEST.LNK	386|LINK commands for linking DLLTEST.

MYDLL.C		DLL that exports a function to the main program.

MYDLL.IMP       386|LINK commands identifying objects imported by MYDLL.

MYDLL.LNK	386|LINK commands for linking MYDLL.

WRITESTR.ASM    Assembly language routine to write a string to the
		screen during DLL initialization.


-----------------------------------
The \TNT\EXAMPLES\WINDOWS Directory
-----------------------------------

The \EXAMPLES\WINDOWS directory contains the sample programs described
in Chapter 11, "Programming for DPMI Compatibility," and Appendix C,
"Accessing Windows from TNT DOS Extender," of the TNT DOS-Extender
Reference Manual.

DPMIINFO.C      Prints out the DPMI version number and supported
		capabilities.

DPMITELL.C	Demonstrates making DPMI calls directly.

GETCLIP.C	Reads text from the Windows clipboard.

IDLE.C          Demonstrates using the Windows Release Time Slice
		service to make a program cooperate better with Windows
		multitasking.

INTERUPT.C      Real-mode program that times how long it takes to issue
		one million software interrupts to a do-nothing
		interrupt handler.

ISWIN.C		Checks if running under Windows 3.x, and prints out the 
		Windows version number and mode.

ISWIN3E.C	Checks if running under Windows 3.x enhanced mode.

MEMAVAIL.C      Allocates all memory to see how much is available.

POKE_OFS.C      Maps the video memory into the protected-mode data
		segment, and writes to it with a NEAR pointer.

POKEB800.C      Writes to the video memory using a protected-mode FAR
		pointer.

PUTCLIP.C	Writes text to the Windows clipboard.

TASKTEST.C      Demonstrates using the Windows Critical Section
		services.

TEST.SCR	Sample data for the PUTCLIP.EXE program.

WINCLIP.C, WINCLIP.H
		Worker routines, and header file with prototypes, used
		by PUTCLIP and GETCLIP.

WINTASK.C, WINTASK.H	
		Worker routines, and header file with prototypes, used
		by TASKTEST.


