
                 DOS32   Version 3.00 beta


   NOTE: This is DOS32 v3.00 beta and may not be registered until
         the final version 3.00 is released.


                                              Written by Adam Seychell



                        Compiling the libraries

All the libraries and example source code can be assembled using the
either TASM or MASM. To assemble using MASM you must define a text macro
'masm'. To do this use the -D option on the command line. For example;

ML -Dmasm  <filename.ASM>







Here's the complete list of files distributed with the program:

    DOS32.EXE           The DOS extender loader.

    DLINK.EXE           The DOS32 32bit OMF linker.

    DOS32.DOC           The complete documentation for DOS32  (must be read)

    PMODE.DOC           A crash course in protected mode programming

    PMODE2.DOC          A description of Protected Mode by Yann Stephan.

    WHATS.NEW           What is new in this version.

    README.1ST          The text file you are reading right now.

    STUB.EXE            An example stub loader
    STUB.ASM            with it's source code.

    BIN2HEX.COM         A program to dump a file in hexidecimal numbers
                        in the format used by assemblers.

    EXERID.EXE          Utility to remove wasted header space for .EXE files
                        created by some linkers  e.g TLINK (tm) or LINK (tm)


\EXAMPLES         The examples directory


     M0.BAT     An batch file for building a DOS32 program
                    using Turbo Assembler and Turbo Linker
     M0_M.BAT   Same as above with using Microsoft Assembler 6.x

     EG0.ASM    These are example 32bit programs using DOS32.
     EG1.ASM      The EXE's are also here.
     EG2.ASM      run them to see what they do
     EG3.ASM
     EG4.ASM
     EG5.ASM
     EG6.ASM
     EG7.ASM   <-- This fills GUS's DRAM via DMA
     EG10.ASM   <-- A demontration of The Debugger

        The following example programs require parts of the library.

     MODPLAY.ASM    A stupid MOD player
     MODPLAY.EXE




\LIB                 This directory contains a library for some
                      useful routines and macros for the DOS extender.

     DEBUG.OBJ          Version 1.1 of the 32bit protected mode debugger
     GUS.ASM            Gravis Ultrasound initalizing routines !
     GUS.TXT            Info on about GUS.ASM
     GUS.INC
     MOUSE.ASM          Routine for setting up a mouse event handler.
     MOUSE.INC
     SQRT.ASM           Calclates the square root.
     SQRT.INC
     RANDOM.ASM         A random number generator.
     RANDOM.INC
     DMA.ASM            8237 DMA contoller stuff.
     DMA.INC
     MACROS.386         Useful macros for the library.


\PAL             Peter Andersons library

     Not included in this beta version of DOS32.


------------------- End of file list ---------------------------------------


TASM & TLINK is a trade mark of Borland International.
MASM & LINK is a trade mark of Microsoft corp.
