home *** CD-ROM | disk | FTP | other *** search
/ Jason Aller Floppy Collection / 180.img / TURBOD.ZIP / README < prev    next >
Text File  |  1989-05-02  |  10KB  |  229 lines
  1.                       WELCOME TO TURBO DEBUGGER 1.5
  2.                       -----------------------------
  3.  This README file contains important, last minute information about Turbo
  4. Debugger 1.5.  The HELPME!.DOC file on the TURBO DEBUGGER HELP/UTILITIES
  5. disk also answers many common Technical Support questions.
  6.  
  7. TABLE OF CONTENTS
  8. -----------------
  9. 1. How to Get Help
  10. 2. Installation
  11. 3. Notes and Restrictions
  12. 4. About Turbo Debugger 1.5
  13. 5. Files on the Disks
  14.  
  15. 1. HOW TO GET HELP
  16. ------------------
  17.   If you have any problems, please read this file, the
  18. HELPME!.DOC file, and the Turbo Debugger manual first. If you
  19. still have a question and need assistance, help is available
  20. from the following sources:
  21. 1. Type GO BOR on the CompuServe bulletin board system for
  22.    instant access to the Borland forums with their libraries of
  23.    technical information and answers to common questions.
  24.  
  25.    If you are not a member of CompuServe, see the enclosed special
  26.    offer, and write for full details on how to receive a free
  27.    IntroPak containing a $15 credit toward your first month's on-
  28.    line charges.
  29. 2. Check with your local software dealer or users' group.
  30. 3. Write to us at the following address:
  31.  
  32.    Borland International
  33.    Turbo Debugger Technical Support
  34.    1800 Green Hills Road
  35.    P.O. Box 660001
  36.    Scotts Valley, CA  95066-0001
  37.  
  38.    Please remember to include your serial number or we will be
  39.    unable to process your letter.
  40. 4. If you have an urgent problem that cannot wait and you have sent
  41.    in the license agreement from the front of your manual, you may
  42.    call the Borland Technical Support Department at (408) 438-5300.
  43.    Please have the following information ready before calling:
  44.    a. Product name and serial number on your original distribution
  45.       disk.  Remember to have your serial number ready before calling.
  46.    b. Product version number. The version number is displayed when
  47.       running Turbo Debugger and pressing the <Shift + F10> keys.
  48.    c. Computer brand, model, and the brands and model numbers of
  49.       any additional hardware.
  50.    d. Operating system and version number. (The version number can
  51.       be determined by typing VER at the MSDOS prompt.)
  52.    e. Contents of your AUTOEXEC.BAT file.
  53.    f. Contents of your CONFIG.SYS file.
  54.  
  55. 2. INSTALLATION
  56. ---------------
  57.   You should read the rest of this README file to get further information
  58. about this release before you do the installation.
  59.   The TURBO DEBUGGER/INSTALLATION disk contains a program called INSTALL.EXE
  60. that will assist you with the installation of Turbo Debugger 1.5.
  61.   To start the installation, change your current drive to the one that has
  62. the install program on it and type INSTALL. You will be given instructions
  63. in a box at the bottom of the screen for each prompt. For example, if you
  64. will be installing from drive A:, you would type
  65.       A:
  66.       INSTALL
  67.  
  68.   If you have difficulty reading the text displayed by the INSTALL
  69. program, it accepts an optional command-line parameter that forces
  70. it to use black and white colors:
  71.           a:install /B      - Forces INSTALL into BW80 mode
  72.   Specifying the /B parameter may be necessary if you are using an
  73. LCD screen or a system that has a color graphics adapter and a
  74. monochrome or composite monitor.
  75.  
  76. There are three options for installation:
  77. 1. Hard Disk - INSTALL will copy all Turbo Debugger files onto
  78.    your hard disk and put them into subdirectories. The default
  79.    subdirectories are
  80.  
  81.     Turbo Debugger Directory:                    C:\TD
  82.     Example Subdirectory:                        C:\TD
  83.  
  84.    By default, all files from the distribution disks are placed
  85.    in the Turbo Debugger Directory. If you would rather
  86.    separate the examples programs into their own subdirectory
  87.    as well, edit the default example files path before
  88.    selecting START INSTALLATION.
  89.  
  90. 2. Floppy Disk - This option will build a working Turbo
  91.    Debugger 4-disk set that will work on a two-drive system. Be
  92.    sure to have four formatted disks ready before you start.
  93.    Install will build:
  94. Program Disk - Turbo Debugger main program, README file, and
  95. the Turbo Debugger customization program.
  96.  
  97. Work Disk - Turbo Debugger working overlay file and Help
  98. file.
  99.  
  100. Utilities Disk - Turbo Debugger utilities.
  101.  
  102. Examples Disk - Example programs for use with Turbo
  103. Debugger.
  104.  
  105. The Turbo Debugger UTILITIES/EXAMPLES distribution disk contains several
  106. files with an .ARC file extension: TDEXAMPL.ARC, TAEXAMPL1.ARC, TAEXAMPL2.ARC,
  107. and CHAPXMPL.ARC. These files contain several other files that have been
  108. compressed and placed inside an archive. You can de-archive them yourself by
  109. using the UNPACK.COM utility. For example,
  110.                                 unpack tdexampl
  111. unpacks all the files stored in the TDEXAMPL.ARC archive into the
  112. current directory.
  113.  
  114. INSTALL gives you a choice of copying the .ARC files intact or de-archiving
  115. and copying all of the individual files onto your hard disk during the
  116. installation process. Note that INSTALL does not unpack the TAEXAMPL1.ARC,
  117. TAEXAMPL2.ARC, or CHAPXMPL.ARC files from the UTILITIES/EXAMPLES disk. These
  118. files contain example programs for Turbo Assembler.
  119.  
  120. 3. NOTES AND RESTRICTIONS
  121. -------------------------
  122. o You need to set the files directive in your CONFIG.SYS file to at least
  123. FILES = 10, preferably FILES = 20. If you have trouble doing the File/OS
  124. Shell command or if TD can't find your source modules, make sure the FILES
  125. directive is in your CONFIG.SYS.
  126.  
  127. o FNxxxx variants of floating-point instructions are not supported in the
  128. built-in assembler in the CPU window.
  129.  
  130. o The Fxxxx instructions do not generate an FWAIT in Turbo Debugger. You
  131. must manually code an FWAIT before floating-point instructions if needed.
  132.  
  133. o A single Ctrl-Break inside a DOS function call waiting for console input
  134. will not interrupt DOS and return control to Turbo Debugger. You can either
  135. press Ctrl-Break once and then end the console input function by pressing
  136. Enter, or press Ctrl-Break twice. You will then interrupt DOS and Turbo
  137. Debugger will bring up a CPU Viewer showing code inside DOS. At this point,
  138. you can look around inside your program, but you might not be able to use F7
  139. or F8 to trace or step inside DOS. You should use only F9 at this point,
  140. possibly after setting a breakpoint inside your program.
  141.  
  142. o If you are using TD386, make sure that you use the -e option if you have
  143. loaded any TSRs or device drivers that are using extended memory. The value
  144. to indicate after the -e is the total amount (in Kbytes) of extended memory
  145. being used by other applications before loading TD386. If you do not use this
  146. option, TD386 may overwrite extended memory that is being used by the other
  147. applications. For example, if a disk-caching program that uses extended memory
  148. is loaded and you do not use the -e option, the program may write incorrect
  149. information to your hard disk.
  150.  
  151. o  The types of hardware breakpoints supported by TD and TD386 are:
  152.                   TD   TD386
  153. Cycle:
  154.   Read              N    Y
  155.   Write             Y    Y
  156.   Access            Y    Y
  157. Data:
  158.   Match All         Y    Y
  159.   Above             Y    Y
  160.   Below             Y    Y
  161.   Range             Y    Y
  162.   Not Range         N    N
  163.   Less or Equal     Y    Y
  164.   Greater or Equal  Y    Y
  165.   Equal             Y    Y
  166.   Unequal           N    N
  167. Address:
  168.   Match All         N    N
  169.   Above             N    Y
  170.   Below             N    Y
  171.   Range             Y    Y
  172.   Not Range         N    N
  173.   Less or Equal     N    Y
  174.   Greater or Equal  N    Y
  175.   Equal             Y    Y
  176.   Unequal           N    N
  177.  
  178. 4.  ABOUT TURBO DEBUGGER 1.5
  179. ----------------------------
  180. o Version 1.5 of Turbo Debugger has been designed to support the new Object
  181. Oriented Language of Turbo Pascal 5.5.  This means if you want to debug
  182. Object Oriented Programs, you must use the 1.5 version of Turbo Debugger.
  183. However, earlier versions of Turbo Debugger will support programs compiled
  184. with the new Turbo Pascal 5.5 as long as the programs do not contain Object
  185. Oriented code.
  186.   You may obtain an upgrade from Turbo Pascal 5.0 to Turbo
  187. Pascal 5.5, including the new Turbo Pascal Object Oriented Programming Guide,
  188. by contacting Customer Service here at Borland.
  189.  
  190. 5.  FILES ON THE DISKS
  191. ----------------------
  192. TURBO DEBUGGER/INSTALLATION
  193. ---------------------------
  194. INSTALL  EXE  - Installs Turbo Debugger on your system
  195. README   COM  - Program to display the README and other text files
  196. TD       EXE  - Turbo Debugger Program
  197. TD       OVL  - Turbo Debugger Program Overlay
  198. README        - This file!
  199.  
  200. TURBO DEBUGGER HELP/UTILITIES
  201. -----------------------------
  202. HELPME!  DOC  - Text file with the answers to many common questions.
  203.                 Please read HELPME!.DOC before calling Technical Support.
  204. TDHELP   TDH  - Turbo Debugger Help File
  205. TDINST   EXE  - Configuration Customization program
  206. TDUTIL   ARC  - Packed file that contains the following Turbo
  207.                 Debugger Utilities:
  208.   TD386    EXE  - Utility for 80386 virtual debugging
  209.   TDH386   SYS  - Device driver for TD386.EXE and the 80386 debug
  210.                   registers
  211.   TDMAP    EXE  - Utility to extract debug information from .MAP files
  212.   TDREMOTE EXE  - Remote debugging kernel
  213.   TDRF     EXE  - Remote file transfer utility
  214.   TDSTRIP  EXE  - Utility to strip debug information off .EXE files
  215.   TDUMP    EXE  - Utility to dump executable and object files
  216. UNPACK     COM  - Utility to unpack .ARC files
  217.  
  218. TURBO DEBUGGER UTILITIES/EXAMPLES
  219. ---------------------------------
  220. TDCONVRT EXE  - Utility to convert CodeView information to Turbo
  221.                 Debugger information
  222. TDPACK   EXE  - Utility to compress debug information
  223. TDNMI    COM  - TSR to clear NMI every half second
  224. UNPACK   COM  - Utility to unpack .ARC files
  225. TDEXMPL  ARC  - Packed file that contains Turbo Debugger examples
  226. TAEXMPL1 ARC  - Packed file that contains Turbo Assembler examples
  227. TAEXMPL2 ARC  - Packed file that contains Turbo Assembler examples
  228. CHAPXMPL ARC  - Packed file that contains Turbo Assembler examples
  229.