home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / progc / fmm_demo.arj / READ.ME < prev    next >
Text File  |  1991-11-17  |  4KB  |  98 lines
  1.  
  2. The files in FMM-DEMO.ZIP are the files on the demonstration disk for
  3. Dolphin Software's Far Memory Manager & Debugging Library, a C function
  4. library supporting Microsoft C and Borland/Turbo C++.  On the demonstration
  5. disk the files are divided among the root directory and three subdirectories
  6. (\DEMO_EXE, \DEMO_SRC and \DOC), but in this ZIPped version the files
  7. are distinguished simply by suffix (.C, .EXE and .TXT).  Keep this in
  8. mind when reading the following:
  9.  
  10.    Notes to accompany the demonstration disk for Dolphin Software's
  11.         Far Memory Manager & Debugging Library (Version 1.70)
  12.  
  13. The demonstration disk is organized as follows:
  14.  
  15. The root directory contains two files: READ_ME.TXT (this file) and
  16. ORDERFRM.TXT (an order form).
  17.  
  18. The \DEMO_EXE subdirectory contains the VALIDATE.EXE program (see below)
  19. and eight executable files: FMALLBUG.EXE, TINYBUG.EXE, LOG_DEMO.EXE,
  20. NEG_IND.EXE, HEAPFREE.EXE, HEAPWALK.EXE, WIN2.EXE and WIN2MONO.EXE.
  21.  
  22. The \DEMO_SRC subdirectory contains the C source code for these programs
  23. (other than VALIDATE.EXE).
  24.  
  25. The \DOC subdirectory contains the contents-at-a-glance, the full
  26. contents, Chapters 1 and 2 from the documentation and the first half of
  27. Chapter 6.  The contents of these are as follows:
  28.  
  29. Chapter 1:  Introduction
  30.  
  31.      1.1  Organization of this Documentation
  32.      1.2  A Quick Outline of What this Library is All About
  33.      1.3  Description of Features
  34.          (a)  Reliable far memory allocation
  35.          (b)  Dynamic allocation of multi-dimensional arrays
  36.               in far memory
  37.          (c)  Variable array index bases and negative array indices
  38.          (d)  Array bounds checking
  39.          (e)  Representation of memory areas as 2-D and 3-D arrays
  40.          (f)  Extensive error checking
  41.          (g)  Diagnostic information in a memory allocation log
  42.          (h)  Automatic detection of errors with program termination
  43.          (i)  Reports of far heap structure
  44.  
  45. Chapter 2:  The Use of the Library as a Debugging Tool
  46.  
  47.      (a)  Introduction
  48.      (b)  The Windowing System
  49.      (c)  The Debugging Process
  50.  
  51. Chapter 6:  The Demonstration Programs
  52.  
  53.      (a)  TINYBUG.C
  54.      (b)  LOG_DEMO.C
  55.      (c)  FMALLBUG.C
  56.      (d)  NEG_IND.C
  57.      (e)  HEAPFREE.C
  58.      (f)  HEAPWALK.C
  59.  
  60. The library disk contains the source code for further demonstration
  61. programs.  The full documentation for the library is supplied in a
  62. printed manual with the library disk.
  63.  
  64. The executable versions of the demo programs may be run as they stand.
  65. Except for WIN2.EXE they are described in Chapter 6 of the documentation
  66. (see the file \DOC\CHAP6A.TXT).  WIN2.C is a fully debugged version of a
  67. program with bugs which is given in Chapter 2 (see \DOC\CHAP2.TXT).
  68. Chapter 2 is a debugging tutorial which shows how WIN2.C is reached from
  69. the initial, buggy, program.  WIN2.EXE and WIN2MONO.EXE are executable
  70. forms of WIN2.C.  WIN2.EXE is for a system with a color video adaptor,
  71. WIN2MONO.EXE is for a monochrome display adaptor.
  72.  
  73. The source code for the demonstration programs is provided to show how
  74. the functions in the library are used to obtain the results that may be
  75. seen by running the .EXE files.  The source code may be compiled with
  76. the Microsoft C compiler (Versions 5.10 - 6.00A) and with the Borland/-
  77. Turbo C++ compilers only if the header file L_MEM.H is present.  This
  78. header file is not supplied on the demonstration disk; it is provided on
  79. the Far Memory Manager library disk, along with the source code for
  80. further demonstration programs.
  81.  
  82. If you did not receive the demo disk directly from Dolphin Software then
  83. the VALIDATE.EXE program (in subdirectory \DEMO_EXE) may be run to check
  84. that the file sizes and dates of the executable versions of the demo
  85. programs have not been changed).  VALIDATE.EXE even checks to see that
  86. its own size and date are unmodified.
  87.  
  88. The files in the \DOC subdirectory are from the documentation for the
  89. library and are copyrighted by Dolphin Software.  In fact, the whole
  90. demonstration disk [and the file FMM-DEMO.ZIP] is copyrighted by Dolphin
  91. Software.  However a general license is hereby granted to distribute
  92. this demonstration disk [and .ZIP file] freely, so long as it is not
  93. modified and nothing is charged for this beyond the cost of distribution.
  94.  
  95. Dolphin Software, 48 Shattuck Square #147, Berkeley, CA 94704, USA
  96.            voice mail: 510-464-3009       fax: 510-644-2651
  97.  
  98.