ProDelphi 5.0     Copyright 1998  Helmuth J. H. Adolph

Freeware and Professional Version

---------------------------  Installing ProDelphi  ----------------------------

 0. Check your CPU:
   
    ProDelphi 5.0 runs on Pentium and Pentium compatible CPU's. It has been
    tested on Pentium Overdrive 120 MHz, AMD K6 166 and 233 MHz, AMD K6-2 
    266 MHz. It definitely does NOT run on a Cyrix 6x86. The Cyrix M2 has
    not been tested.


 1. Create a directory for the ProDelphi files.

 2. Extract the file Profil50.ZIP.

    It contents Readme.ZIP, Profiler.EXE, DELPHI2.ZIP, Delphi3.Zip and 
    Delphi4.ZIP.

    Readme.ZIP contents:
      - Readme50.RTF  (Rich Text Format),
      - Readme50.DOC  (Wordpad- / Word- format) and
      - Readme50.TMD  (Textmaker format).

    Delphi2.ZIP contents:
      - Proftime.DCU and
      - Proftime.DFM
      These files will be linked into your testee program by USES-statement
      if you use Delphi 2.x.

    Delphi3.ZIP contents:
      - Proftime.DCU and
      - Proftime.DFM
      These files will be linked into your testee program by USES-statement
      if you use Delphi 3.x.

    Delphi4.ZIP contents:
      - Proftime.DCU and
      - Proftime.DFM
      These files will be linked into your testee program by USES-statement
      if you use Delphi 4.x.

 3. You should read the documentation (Readme.*), Post-Mortem-review is only
    described in the documention.

 4. Unzip the files for either Delphi 2.x, Delphi 3.x or Delphi 4.x

 5. Create a directory for the program you want to optimize.

 6. Copy Proftime.DCU, Proftime.DFM and your own DPR-, PAS- and INC- files 
    into that directory.
 
 7. Create a link to run PROFILER.EXE.

 8. Compile your program. If no errors occur:

    9. Double-click on the ProDelphi link to start ProDelphi.

   10. Select your directory.

   11. Select Profile.

   12. Click on Run.

   13. When the profiling is finished, end ProDelphi.

   14. Define the compiler symbol PROFILE in your Delphi project, uncheck the
       Optimization-option !!!!!!! and make a complete compilation.

   15. Start your program and let it do what it has to do.

       Attention: When you start your program, it takes a few seconds for
                  calibration (estimation of your CPU speed and measurement
                  correction times).

                  When you use ProDelphi 5.x under Windows 95, the interrupts
                  are locked, that means that your mouse cursor does not move !!!
                  Under Windows NT 4.0 the interrupts can not be locked, so
                  your mouse cursor can be moved.

                  Please do not start any other programs while calibrating,
                  otherwise the results are incorrect.

                  After the calibration phase the Online operation window and
                  your form is shown.


   16. Start ProDelphi 5.x, select VIEW, open the directory with your compiled
       program, select the file 'Progname.TXT' and click the Run-button.
       'Progname' stands for the name of your program.
       After this actions the viewer window opens and you can look at the
       results of the measurement.

       If, at profilation time, you have checked ASCII-output file you also
       can have a look into the result file (programname.BEN) with Delphi
       or print it with Delphi (use landscape format).

17. See the README.* file for further instruction or information.

18. Limitations of use:

    Console applications can not have an online operation window.

    Procedures in the DPR-File can not be profiled.


--------------------------  Uninstalling ProDelphi ----------------------------

Delete the files, directories and links you have created.


-----------------------  ProDelphi Distribution Files  ------------------------

  PROFILER.EXE   ProDelphi executable file
  PROFTIME.DCU   DCU - files for Delphi2, Delphi3 and Delphi4 (time measurement)
  PROFTIME.DFM   DFM - files for Delphi2, Delphi3 and Delphi4 (online operation window)
  READMExx.RTF   Description of ProDelphi x.x (Rich-Text-Format)
  READMExx.DOC   Description of ProDelphi x.x (Word-Format)
  READMExx.TMD   Description of ProDelphi x.x (Textmaker-Format)
  ORDER.TXT      Information on how to order the registered version
  LICENSE.TXT    License Agreement / Warranty Disclaimer
  VENDOR.TXT     Information for shareware distributors
  INSTALL.TXT    This file.
  NEWS.TXT       Hints for usage of ProDelphi.


--------------------  Files created at runtime by ProDelphi -------------------

PROFLST.ASC    Created by the ProDelphi, it contains information about the
               procedures to be measured for profiling or traced for post mortem
               review.

PROFILE.INI    Options for time measurement, screen coordinates for the
               online operation window.

----------  Files created at runtime by measured or traced programs -----------

PROGNAME.EXE   PROGNAME is the name of your executable, created by Delphi.

PROGNAME.TXT   Results in data base format (runtimes of the procedures), used
               by the built-in viewer.

PROGNAME.TX2   Run numbers, CPU-clock-rate and headlines for the built-in
               viewer.

PROGNAME.BEN   Results of the time measurement in ASCII if the option
               ASCII-output file was checked at profiling time.

PROGNAME.SWO   List of procedures that have to be deactivated for time
               measurement at next program start.

PROGNAME.PMR   Call stack in case of a trapped exception (for Post Mortem 
               Review only).



