home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 15 / 15.iso / s / s150 / 1.ddi / README < prev    next >
Encoding:
Text File  |  1990-05-07  |  13.1 KB  |  325 lines
  1.                        WELCOME TO TURBO DEBUGGER 2.0
  2.                        -----------------------------
  3.  
  4.   This README file contains important information about Turbo
  5.   Debugger Version 2.0. For the latest information about Turbo
  6.   Debugger 2.0, the accompanying programs, and the manual, read
  7.   this file in its entirety.
  8.  
  9.  
  10. TABLE OF CONTENTS
  11. -----------------
  12. 1.  How to Get Help
  13. 2.  Installation
  14. 3.  Notes and Restrictions
  15. 4.  About Turbo Debugger 2.0
  16. 5.  Files on the Disks
  17.  
  18.  
  19. 1.  HOW TO GET HELP
  20. -------------------
  21.  
  22.   If you have any problems, please read this file, the
  23.   HELPME!.DOC, the MANUAL.DOC, and the Turbo Debugger User's
  24.   Guide first. If you still have questions and need assistance,
  25.   help is available from the following sources:
  26.  
  27.   1. Type GO BOR on the CompuServe bulletin board system for
  28.      instant access to the Borland forums with their libraries of
  29.      technical information and answers to common questions.
  30.  
  31.      If you are not a member of CompuServe, see the enclosed
  32.      special offer, and write for full details on how to receive
  33.      a free IntroPak containing a $15 credit toward your first
  34.      month's online charges.
  35.  
  36.   2. Check with your local software dealer or users' group.
  37.  
  38.   3. Write to us at the following address:
  39.  
  40.      Borland International
  41.      Turbo Debugger Technical Support
  42.      1800 Green Hills Road
  43.      P.O. Box 660001
  44.      Scotts Valley, CA  95066-0001
  45.  
  46.      Please remember to include your serial number or we will be
  47.      unable to process your letter.
  48.  
  49.   4. If you have an urgent problem that cannot wait and you have
  50.      sent in the license agreement, you may call the Borland
  51.      Technical Support Department at (408) 438-5300 Monday through
  52.      Friday between the hours of 6 a.m. and 5 p.m. Pacific Time.
  53.      Please have the following information ready before calling:
  54.  
  55.      a. Product name and serial number on your original
  56.         distribution disk. Please have your serial number ready
  57.         or we will be unable to process your call.
  58.  
  59.      b. Product version number. The version number is displayed
  60.         when running Turbo Debugger and pressing the <Alt + space>
  61.         keys to bring up the System menu and choosing the About...
  62.         option.
  63.  
  64.      c. Computer brand, model, and the brands and model numbers
  65.         of any additional hardware.
  66.  
  67.      d. Operating system and version number. (The version number
  68.         can be determined by typing VER at the DOS prompt.)
  69.  
  70.      e. Contents of your AUTOEXEC.BAT and CONFIG.SYS files.
  71.  
  72.  
  73. 2.  INSTALLATION
  74. ----------------
  75.  
  76.   You should read the rest of this README file to get further
  77.   information about this release before you do the installation.
  78.  
  79.   The Turbo Debugger/INSTALLATION disk contains a program called
  80.   INSTALL.EXE that will assist you with the installation of Turbo
  81.   Debugger 2.0.
  82.  
  83.   To start the installation, change your current drive to the one
  84.   that has the install program on it and type INSTALL. In a box
  85.   at the bottom of the screen, you will be given instructions for
  86.   each prompt. For example, if you are installing from drive A:,
  87.   you type
  88.  
  89.       A: <Enter>
  90.       INSTALL <Enter>
  91.  
  92.   If you have difficulty reading the text displayed by the
  93.   INSTALL program, use the /B command-line parameter to force it
  94.   to use black and white colors:
  95.  
  96.       a:install /B      - Forces INSTALL into BW80 mode
  97.  
  98.   Specifying the /B parameter may be necessary if you are using
  99.   an LCD screen or a system that has a color graphics adapter and
  100.   a monochrome or composite monitor.
  101.  
  102.   Notes for installation:
  103.  
  104.     INSTALL copies all Turbo Debugger files onto your hard disk
  105.     and puts them into subdirectories. The default subdirectories
  106.     are
  107.  
  108.       Turbo Debugger Directory:                    C:\TD
  109.       Example Subdirectory:                        C:\TD
  110.  
  111.   By default, all files from the distribution disks are placed in
  112.   the Turbo Debugger Directory. If you would rather separate the
  113.   examples programs into their own subdirectory, edit the default
  114.   example files path before selecting START INSTALLATION.
  115.  
  116.   The Turbo Debugger distribution disks contain several files
  117.   with a .ZIP file extension: TD.ZIP, TDUTIL.ZIP, TDEXMPL.ZIP,
  118.   etc. These files contain one or more other files that have been
  119.   compressed and placed inside an archive. You can de-archive
  120.   them by using the UNZIP.EXE utility. For example,
  121.  
  122.     unzip /o tdexmpl
  123.  
  124.   unpacks all the files stored in the TDEXMPL.ZIP archive into
  125.   the current directory.
  126.  
  127.   INSTALL gives you a choice of copying the .ZIP files intact or
  128.   de-archiving and copying all the individual files onto your
  129.   hard disk during the installation process.
  130.  
  131.  
  132. 3.  NOTES AND RESTRICTIONS
  133. --------------------------
  134. o You need to set the files directive in your CONFIG.SYS file to
  135.   at least FILES = 10, preferably FILES = 20. If you have trouble
  136.   doing the File|DOS Shell command or if TD can't find your source
  137.   modules, make sure the FILES directive is in your CONFIG.SYS.
  138.  
  139. o FNxxxx variants of floating-point instructions are not
  140.   supported in the built-in assembler in the CPU window.
  141.  
  142. o The Fxxxx instructions do not generate an FWAIT in Turbo
  143.   Debugger. You must manually code an FWAIT before floating-point
  144.   instructions if needed.
  145.  
  146. o A single Ctrl-Break inside a DOS function call waiting for
  147.   console input will not interrupt DOS and return control to
  148.   Turbo Debugger. You can either press Ctrl-Break once and then
  149.   end the console input function by pressing Enter, or press
  150.   Ctrl-Break twice. You will then interrupt DOS and Turbo
  151.   Debugger will bring up a CPU Viewer showing code inside DOS. At
  152.   this point, you can look around inside your program, but you
  153.   might not be able to use F7 or F8 to trace or step inside DOS.
  154.   You should use only F9 at this point, possibly after setting a
  155.   breakpoint inside your program.
  156.  
  157. o If you are using TD386, make sure that you use the -e option if
  158.   you have loaded any TSRs or device drivers that are using
  159.   extended memory allocated using the VDISK method. The value to
  160.   indicate after the -e is the total amount (in Kbytes) of extended
  161.   memory at the bottom of the extended memory area that is being
  162.   used by other applications before loading TD386. If you do not
  163.   use this option, TD386 may overwrite extended memory that is being
  164.   used by the other applications. For example, if a disk-caching
  165.   program that uses extended memory is loaded and you do not use
  166.   the -e option, the program may write incorrect information to
  167.   your hard disk.
  168.   NOTE: If your programs use the INT 0x15, function 0x88 method
  169.   to allocate memory, DO NOT count this memory, as TD386 will
  170.   automatically leave that memory alone.
  171.  
  172. o TDINST contains two new options in the Display dialog box;
  173.   'Floating precision' allows you to set the floating-point
  174.   precision for variables entered in the Evaluate/Modify dialog
  175.   box and Watches window. 'Range inspect' lets you set the
  176.   default range for the number of elements to show in inspectors.
  177.  
  178. o For those of you using TD286.EXE, note that you may have to run
  179.   TD286INS.EXE so that TD286 recognizes your machine
  180.   configuration. In doing so, a file may be generated which has a
  181.   .db extension. It is necessary that we have this file in order
  182.   to make TD286 a better product.  You may, if you wish, upload
  183.   this file to our BBS (Bulletin Board Service) here at Borland. 
  184.   When doing so you should call (408) 438 - 5300 and give our
  185.   representatives your serial number so that they may allow you
  186.   to upload your file.  They will help you with any questions you
  187.   have regarding the use of our BBS.  Note that TD286 needs 640K
  188.   of available extended memory to execute properly.
  189.  
  190. o If you are using TD386, and you are receiving a "not enough
  191.   memory to load symbol table" message, you need to enable
  192.   EMS emulation for TD386.  To do this, use the -F option.
  193.   For instance, to set up EMS for TD386 at segment 0D000h,
  194.   invoke TD386 with "-FD000" .
  195.  
  196. o If you are using an HP-Vectra, and you get an Unexpected Interrupt
  197.   06 when trying to run TD386, you need to set an option in the
  198.   CMOS setup.  By default the Vectra series uses a protected mode
  199.   instruction as part of the HP-HIL.  To work around this, contact
  200.   Hewlett Packard for instruction on disabling this function.
  201.  
  202. o If an Exception 06 occurs after running for awhile in TD386,
  203.   your code has probably been overwritten.  An Exception 6
  204.   is generated by the 80386 when an illegal opcode is encountered.  
  205.   Common causes of this problem are using uninitialized pointers, etc.
  206.  
  207. o If you get a "Processor already in protected mode" error message
  208.   when trying to load TD386, then you are using a program which
  209.   uses the virtual mode of the 80386 ( such as QEMM ).  At this
  210.   time, it is not possible to use these programs and TD386 at the
  211.   same time.  If you need to use these memory managers, try using
  212.   TD286 instead of TD386.
  213.  
  214. 4.  ABOUT TURBO DEBUGGER 2.0
  215. ----------------------------
  216. o Version 2.0 of Turbo Debugger has been designed to support the
  217.   C++ language of Turbo C++. Earlier versions of Turbo C, Turbo
  218.   Pascal, and TASM are still compatible with the new Turbo
  219.   Debugger 2.0 as follows:
  220.  
  221.      TASM 1.0         (or later)
  222.      Turbo C 2.0
  223.      Turbo Pascal 5.0 (or later)
  224.  
  225. o The Utilities and Hardware Debugging appendices from the Turbo
  226.   Debugger User's Guide have been incorporated into the
  227.   MANUAL.DOC file on the Turbo Debugger disks.
  228.  
  229. o The file HELPME!.DOC on the distribution disks has more
  230.   information about using the new mouse capabilities of Turbo
  231.   Debugger 2.0.
  232.  
  233. o By default, TD286 will use all of your extended memory.  If you
  234.   are debugging programs which use extended memory you can
  235.   specify the amount of extended memory that TD286 is allowed to
  236.   use by creating a file in the root directory of your current
  237.   drive, called CONFIG.286.  This file can contain the following
  238.   command:
  239.  
  240.      MEGS=#  
  241.        {Where # = the amount of extended memory TD286 is allowed to use}
  242.  
  243.  
  244. 5.  FILES ON THE DISKS
  245. ----------------------
  246.  
  247.   TURBO DEBUGGER/INSTALLATION
  248.   ---------------------------
  249.   INSTALL  EXE  -  Turbo Debugger installation program
  250.   README   COM  -  Program to display README file
  251.   UNZIP    EXE  -  Program to unpack archive programs
  252.   TD       ZIP  -  Packed file containing the Turbo Debugger program
  253.     TD       EXE  -  Turbo Debugger Program
  254.     HELPME!  DOC  -  Lists answers to common questions about TD
  255.     MANUAL   DOC  -  Explains corrections to the user's guide
  256.   README        -  This file
  257.  
  258.  
  259.   TURBO DEBUGGER/UTILITIES
  260.   ------------------------
  261.   TDUTIL   ZIP  -  Packed help and utility programs
  262.     TD386    EXE  -  80386 virtual debugging
  263.     TDCONVRT EXE  -  Converts CodeView information to Turbo Debugger format 
  264.     TDH386   SYS  -  Device driver for TD386.EXE and the 80386 debug registers 
  265.     TDMAP    EXE  -  Extracts debug information from .MAP files 
  266.     TDNMI    COM  -  TSR to clear NMI every half second 
  267.     TDPACK   EXE  -  Compresses debug information 
  268.     TDREMOTE EXE  -  Remote debugging kernel 
  269.     TDRF     EXE  -  Remote file transfer utility 
  270.     TDSTRIP  EXE  -  Strips debug information off executable files 
  271.     TDUMP    EXE  -  Dumps executable and object file information 
  272.     TDINST   EXE  -  Custom configuration program 
  273.     TDHELP   TDH  -  Turbo Debugger help file 
  274.     TDMEM    EXE  -  Displays the contents of memory
  275.     TDDEV    EXE  -  Displays any device drivers that are loaded
  276.  
  277.   TDEXMPL  ZIP  -  Packed file that contains Turbo Debugger examples
  278.     TCDEMO   C    -  Turbo C Program To Demonstrate Debugger Features
  279.     TCDEMO   EXE  -  Executable File For Turbo C Program
  280.     TCDEMOB  C    -  Turbo C Program To Demonstrate Debugger Features
  281.     TCDEMOB  EXE  -  Executable File For Turbo C Program
  282.     TPDEMO   PAS  -  Turbo Pascal Program To Demonstrate Debugger Features
  283.     TPDEMO   EXE  -  Executable File For Turbo Pascal Program
  284.     TPDEMOB  PAS  -  Turbo Pascal Program To Demonstrate Debugger Features
  285.     TPDEMOB  EXE  -  Executable File For Turbo Pascal Program
  286.  
  287.   TFUTIL2  ZIP  -  Packed Turbo Profiler utility
  288.     TF386    EXE  -  Utility For 80386 virtual profiling
  289.  
  290.  
  291.   TURBO DEBUGGER/TD286
  292.   --------------------
  293.   TD286    ZIP  -  Archive containing the Protected Mode Turbo Debugger
  294.     TD286    EXE  -  Protected Mode Turbo Debugger program
  295.     TD286INS EXE  -  Kernel Configuration Program for Installing TD286.EXE
  296.  
  297.   TFUTIL1  ZIP  -  Archive containing Turbo Profiler utility
  298.     TFREMOTE EXE  -  Remote profiling kernel
  299.  
  300.   TFEXMPL1  ZIP  -  Archive containing Turbo Profiler examples
  301.     PLOST    C
  302.     PLOST    EXE
  303.     PLOSTPAS PAS
  304.     PLOSTPAS EXE
  305.     PTOLL    C
  306.     PTOLL    EXE
  307.     PTOLLPAS PAS
  308.     PTOLLPAS EXE
  309.     CALLTEST C
  310.     CALLTEST EXE
  311.     OVRDEMO  PAS
  312.     OVRDEMO1 PAS
  313.     OVRDEMO2 PAS
  314.     OVRDEMO  EXE
  315.     OVRDEMO  OVR
  316.  
  317.  
  318. NOTE: If you have the 3.5" version of Turbo Debugger, the disk
  319.       layout is as follows.
  320.            The TURBO DEBUGGER/INSTALLATION disk is combined with
  321.            the TURBO DEBUGGER/UTILITIES disk.
  322.  
  323.            The TURBO PROFILER/INSTALLATION disk is combined with
  324.            the TURBO DEBUGGER/TD286 disk.
  325.