-----------------------------
DJGPPASM.DOC Example Programs
-----------------------------

     These example programs contain the sources listed in djgppasm.doc.  For
some of the files, minor changes have been made to reflect the incremential
aspect of the document (nasmtest.cc contains all of the revisions).

     All of these examples require NASM 0.94+.  If you don't have it, read
DJGPPASM.DOC to get the latest version.
                                       
Compiling the examples (if you have C++)
----------------------

     If you have the make utility available, just type "make".  There is a 
makefile set up to create all of the examples.  If you don't have make, there
is a batch file named "makeall.bat" that will do the same thing.

Compiling the examples (if you don't have C++)
----------------------

     The examples in here make use of C++, so they won't compile if you don't
have C++ available.  There are a two modifications you'll have to make to do
this:

  1.  Rename all *.cc files to *.c (also in makefile or makeall.bat)
  2.  Edit all *.asm files and remove the C++ name-mangling:

     (name mangling occurs with two underscores and a bunch of letters)
     _InitSomething__FPcUi      ->       _InitSomething
     _DoNothing__Fv             ->       _DoNothing
     _AddFour__FUi              ->       _AddFour

  3.  Delete all occurrences of extern "C" 

     The examples should then compile fine.

Source-code comments
--------------------

     Because the examples are dissected in djgppasm.doc, I didn't put too 
much effort into commenting the code.  If you find it difficult to see what
the program is doing, even with djgppasm.doc, send me some comments and I'll
try to clear it up for you.

Closing notes
-------------

 - The latest version of DJGPPASM.DOC is always available from the URL:

http://www.ucalgary.ca/~mmastrac/djgppasm.doc

 - The latest version of these examples is always available from the URL:

http://www.ucalgary.ca/~mmastrac/djnasmex.zip

 - If you have any questions, concerns, compliments or chest pains, feel free 
   to contact the author at:

mmastrac@acs.ucalgary.ca

 
 
 
 
 - Revised by Matthew Mastracci, 04/20/1997