home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 9 / 09.iso / l / l040 / 13.ddi / README < prev    next >
Encoding:
Text File  |  1992-10-28  |  8.6 KB  |  226 lines
  1.                  Borland Pascal with Objects 7.0
  2.                    Run-time Library Source Code
  3.                  -------------------------------
  4.  
  5. Please read this document carefully. It is the only documentation
  6. for the Borland Pascal with Objects run-time library source code.
  7.  
  8.  
  9. TABLE OF CONTENTS
  10. -----------------
  11.  
  12. 1. System requirements
  13. 2. Run-time library source code support policy
  14. 3. Installing the run-time library source code
  15. 4. Run-time library source code overview
  16. 5. Building the run-time library
  17. 6. Modifying the run-time library source code
  18.  
  19.  
  20. 1. SYSTEM REQUIREMENTS
  21. ----------------------
  22.  
  23.   The Borland Pascal with Objects run-time library source code
  24.   requires:
  25.  
  26.     o MS-DOS 3.0 or later
  27.     o 2Mb of available extended memory
  28.     o 80286 or later processor
  29.     o approximately 1.6Mb of disk space (source only)
  30.     o Borland Pascal with Objects 7.0
  31.  
  32.  
  33. 2. RUN-TIME LIBRARY SOURCE CODE SUPPORT POLICY
  34. ----------------------------------------------
  35.  
  36. IMPORTANT: Borland Technical Support will not answer questions or
  37. provide any assistance relating to this product. This product is
  38. provided "as is."
  39.  
  40. If you find a genuine problem with the source code, please send a
  41. written description to our Technical Support Department by one of
  42. two methods:
  43.  
  44.     1. Type GO BPROGA on the CompuServe bulletin board system for
  45.        instant access to the Borland forums.
  46.  
  47.     2. Or you can write to:
  48.  
  49.           Borland International
  50.           Borland Pascal RTL Source Code Technical Support
  51.           P.O. Box 660001
  52.           1800 Green Hills Road
  53.           Scotts Valley, CA 95067-0001
  54.  
  55.     Please include the following information in your
  56.     correspondence:
  57.  
  58.       A.  Product name and serial number from your original
  59.           distribution disk.
  60.  
  61.       B.  Computer brand, model, and the brands and model numbers
  62.           of any additional hardware.
  63.  
  64.       C.  Operating system and version number. The version number
  65.           can be determined by typing VER at the DOS prompt.
  66.  
  67.       D.  Contents of your AUTOEXEC.BAT file.
  68.  
  69.       E.  Contents of your CONFIG.SYS file.
  70.  
  71.       F.  A complete description of the problem.
  72.  
  73.  
  74. 3. INSTALLING THE RUN-TIME LIBRARY SOURCE CODE
  75. ----------------------------------------------
  76. The Borland Pascal with Objects run-time library source code
  77. installation program, INSTALL.EXE, sets up the run-time library
  78. source code on your system. To use INSTALL on Drive A, for
  79. example, place the distribution disk in Drive A and type
  80.  
  81.   A:INSTALL
  82.  
  83. You can select the base directory for the run-time library by
  84. selecting the "Run-time library directory" option, and entering
  85. the desired path.  The install program will create several other
  86. directories below the directory you specify.
  87.  
  88. The MAKEFILE included with the run-time library assumes that you
  89. have installed Borland Pascal with Objects to the \BP directory,
  90. and that you will accept the default RTL directory of \BP\RTL.
  91. If you change either of these paths, you need to modify the
  92. RTL's MAKEFILE accordingly. The remainder of this document
  93. assumes that you are using the default directories.
  94.  
  95.  
  96. 4. RUN-TIME LIBRARY SOURCE CODE OVERVIEW
  97. ----------------------------------------
  98. The source and object modules contained in this package
  99. correspond to Borland Pascal with Objects 7.0.  We assume that
  100. you own a copy of Borland Pascal with Objects 7.0 (including
  101. Turbo Assembler 3.2), which you need to compile the run-time
  102. library sources.
  103.  
  104. Borland Pascal with Objects' run-time library consists of source
  105. code for the standard units, the Turbo Vision and ObjectWindows
  106. application frameworks, and the Windows 3.1 interface files.
  107. Sources are not supplied for following items: the 8087 emulator
  108. part of the System unit, the assembly language parts of the
  109. Overlay unit, the Graph unit, the .BGI or .CHR files, the GRAPH3
  110. unit, or the TURBO3 unit.
  111.  
  112. Also included in the run-time library source code package is the
  113. file MAKEFILE, which contains a script for building the entire
  114. run-time library and application frameworks. In order to process
  115. this script, you need the MAKE.EXE utility which comes with
  116. Borland Pascal with Objects 7.0.
  117.  
  118.  
  119. 5. BUILDING THE RUN-TIME LIBRARY
  120. --------------------------------
  121. For each run-time library component, MAKEFILE defines which object
  122. files depend on which source files, and what commands to execute
  123. to update those object files. To do a "make" of the run-time
  124. library source code, first make sure that MAKE.EXE, BPC.EXE, and
  125. TASM.EXE are on your DOS PATH; then change to the \BP\RTL
  126. directory and type:
  127.  
  128.    MAKE
  129.  
  130. MAKE will execute all necessary commands to completely update the
  131. run-time libraries (TURBO.TPL, TPP.TPL, and TPW.TPL), Turbo
  132. Vision, ObjectWindows, and the Windows 3.1 interface.
  133.  
  134. Don't be alarmed if MAKE doesn't assemble or compile anything;
  135. that's just an indication that everything is up-to-date (i.e.,
  136. all object files are more recent than their corresponding source
  137. files).
  138.  
  139. The compiled versions of the run-time libraries and application
  140. frameworks are written to directories under the \RTL\BIN
  141. directory.  Below is a map of the directory structure, and what
  142. files you should expect to find there:
  143.  
  144.   \RTL\BIN        - contains TURBO.TPL, TPP.TPL and TPW.TPL
  145.   \RTL\BIN\TPU    - contains the .TPU files from TURBO.TPL
  146.   \RTL\BIN\TPP    - contains the .TPP files from TPP.TPL
  147.   \RTL\BIN\TPW    - contains the .TPW files from TPW.TPL
  148.   \RTL\BIN\TV     - contains the Turbo Vision .TPU/.TPP files
  149.   \RTL\BIN\OWL    - contains the ObjectWindows .TPW files
  150.   \RTL\BIN\WIN31  - contains the Windows 3.1 .TPW files
  151.  
  152. In order to use the newly built versions of the run-time library,
  153. you must copy the file(s) to the appropriate working directory.
  154. By default, the .TPL files should be copied to the \BP\BIN
  155. directory, and the Turbo Vision, ObjectWindows and Windows 3.1
  156. interface files to the \BP\UNITS directory.
  157.  
  158.  
  159. Creating a debug version of the run-time library
  160. ------------------------------------------------
  161. You can build a version of the run-time library which contains
  162. debug information, by using the following command line:
  163.  
  164.   MAKE -DDEBUG
  165.  
  166. Note: If you have already built the RTL, you will need to
  167. instruct MAKE to do a build instead of a make.  Use the -B switch
  168. to force MAKE to rebuild all files even if they are up to date:
  169.  
  170.   MAKE -B -DDEBUG
  171.  
  172. Once you have compiled the debug version, you can use the IDE's
  173. integrated debugger (or other debugger) to trace into the RTL
  174. itself. To allow the IDE to find RTL assembler source, use the
  175. Options|Directories menu to set the INCLUDE directory path to
  176. \BP\RTL and then re-compile your program.
  177.  
  178.  
  179. Building parts of the run-time library
  180. --------------------------------------
  181. You can build specific parts of the run-time library by supplying
  182. additional command line parameters to the MAKE utility.  For
  183. example, you might want to rebuild only TURBO.TPL, the DOS
  184. real-mode library, or only the ObjectWindows application
  185. framework.  Below is a table of run-time library components you
  186. can build separately, and the command lines to use for each:
  187.  
  188.   Component           Command line
  189.   --------------      ---------------
  190.   TURBO.TPL           MAKE rtldos
  191.   TPP.TPL             MAKE rtldpmi
  192.   TPW.TPL             MAKE rtlwin
  193.   Turbo Vision        MAKE tv
  194.   ObjectWindows       MAKE owl
  195.   Win 3.1 interface   MAKE win31
  196.  
  197.  
  198. 6. MODIFYING THE RUN-TIME LIBRARY SOURCE CODE
  199. ---------------------------------------------
  200. With the exception of the System unit, all RTL units are "normal"
  201. Borland Pascal with Objects units. The System unit, however, has
  202. a number of special properties.
  203.  
  204. The interface part of SYSTEM.PAS defines only variables and typed
  205. constants--the remaining symbols are contained in a bootstrap
  206. symbol table contained in the file SYSTEM.TPS. Furthermore, you
  207. will notice a number of external procedures in the implementation
  208. part; these "semi-hidden" procedures cannot be called directly
  209. (since they are not exported), but the compiler knows about them.
  210. When you call a built-in procedure or function, such as Writeln,
  211. the compiler translates the reference into one or more calls to
  212. hidden procedures in the System unit. Since the compiler depends
  213. upon the hidden routines' order of declaration, it is very
  214. important that you don't change their ordering.
  215.  
  216. We strongly recommend that you refrain from changing the System
  217. unit's interface section, and only modify the implementation
  218. section and the assembly language files. Very few changes are
  219. possible in the interface section, and any change, however minor,
  220. will cause a unit version mismatch between the System unit and
  221. ALL OTHER UNITS compiled with the shipping RTL.
  222.  
  223.  
  224.  
  225. *  *  *  *  *  *
  226.