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