home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / pascal / utility / codeview / tpcv.man < prev   
Text File  |  1988-01-11  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.      Source Level Debugging Comes to Turbo Pascal 4.0
  8.      
  9.      Introduction
  10.      
  11.      Welcome to source level debugging with Turbo Pascal 4.0 and Microsoft
  12.      CodeView.  TPCV is a utility which reads the .MAP file produced by TPMAP
  13.      and appends CodeView debugging records on the executable file output by
  14.      Turbo Pascal.  The modified .EXE file can then be used with Codeview for a
  15.      complete source level debugging environment.
  16.      
  17.      
  18.      Shareware
  19.      
  20.      This program was developed out of the need to provide a quality source
  21.      level debugging environment as is distributed as shareware.  Please feel
  22.      free to make copies and distribute TPCV among your friends.  We do ask that
  23.      if you find this program useful, that you send Paradigm Systems $25.00 as a
  24.      user fee.  Registered users of TPCV will be eligible for technical support,
  25.      an option to purchase the source code plus other information relating to
  26.      the use of TPCV as it becomes available.
  27.      
  28.      From:
  29.               Paradigm Systems
  30.               PO Box 152
  31.               Milford, MA  01757
  32.               (617)478-0499
  33.               MCI:naro
  34.               BIX:naro
  35.               Compuserve:73047,3031
  36.      
  37.      
  38.      Using TPCV
  39.      
  40.      For Turbo Pascal 4.0 owners with access to the Microsoft CodeView, this
  41.      utility will convert the output of Turbo Pascal to a format suitable for
  42.      use by CodeView.  Under CodeView, all source modules (and units) can be
  43.      debugged by stepping line by line or setting breakpoints.  When the user
  44.      steps into a function or procedure, the source code for the new module
  45.      automatically appears and disappears when the module is exited.  Most of
  46.      the powerful debugging features of CodeView are available to Turbo Pascal
  47.      programmers.
  48.      
  49.      Because the initial release works on the .MAP file output by TPMAP and not
  50.      the .TPM file output by Turbo Pascal, the debug information is limited to
  51.      public symbols and line numbers.  There is currently no support for local
  52.      variables and function/procedure arguments, thus declaring variables global
  53.      for debugging purposes will increase the effectiveness of CodeView.  You
  54.      will have access to all public symbols which include all data, function and
  55.      procedure names that appear in the interface section of a unit, along with
  56.      the global data in the main program.  These symbolic names can be used to
  57.      set breakpoints, display data in a variety of formats as well as skip
  58.      through the source code using a mouse.
  59.      
  60.      
  61.  
  62.  
  63.  
  64.                                           1
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.      Operation
  74.      
  75.      Some brief hints and suggestions concerning the use of TPCV.  All files and
  76.      units to be debugged must be compiled using the /$T+ and /$D+ switches.
  77.      Rather than enter these options each time, they can be permanently enabled
  78.      by placing them in the TPC.CFG file.  The Borland utility TPMAP is then run
  79.      on the main program to generate .MAP file used to access line numbers and
  80.      publics.  The syntax for the utility is simply
  81.      
  82.           tpcv exe_file
  83.      
  84.      For example, the following sequence would be used to compile and debug the
  85.      demo file GRDEMO.PAS (included on the TP 4.0 distribution diskette)
  86.      
  87.           tpc grdemo /$D+ /$T+
  88.           tpmap grdemo
  89.           tpcv grdemo
  90.           cv /s grdemo
  91.      
  92.      With TPCV, debugging Turbo Pascal programs such as MCALC are easy.
  93.      
  94.      
  95.      CodeView Availability
  96.      
  97.      The CodeView debugger is shipped as part of the Microsoft Assembler 5.00
  98.      packages or with other Microsoft languages.  What better excuse to upgrade
  99.      your assembler ($40.00) than to getting a powerful source level debugger.
  100.      
  101.      
  102.      Thanks for your support and enjoy true source level debugging.
  103.      
  104.      Paradigm Systems
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                                           2
  131.  
  132.  
  133.