ProDelphi 6.3     Copyright 1998  Helmuth J. H. Adolph

Freeware and Professional Version

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

 0. Check your CPU:
   
    ProDelphi 6.x 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. If you have already an older version of ProDelphi, you MUST delete these
    old files first: ProfMeas.DLL, ProfCali.DLL, ProfInt.PAS, ProfOnli.PAS
    and ProfOnli.DFM.

 2. Create a directory for the ProDelphi files.

 3. Extract the file Prodel6x.ZIP.

    It contents Readme.ZIP, Profiler.EXE, ProfMeas.DLL, ProfCali.DLL, 
    ProfInt.PAS, Delphi2.ZIP, Delphi3.Zip, Delphi4.ZIP and DELSUPP.ZIP.
    ProfInt.PAS will be 'USED' when you profile your program.

    Readme.ZIP contents:
      - Readme63.DOC  (Word or Wordpad Format)

    Delphi2.ZIP contents:
      - ProfOnli.PAS and
      - ProfOnli.DFM.
      This version of ProfOnli.PAS has to be 'USED' when you profile your 
      program if you use Delphi 2.x.

    Delphi3.ZIP contents:
      - ProfOnli.PAS and
      - ProfOnli.DFM.
      This version of ProfOnli.PAS has to be 'USED' when you profile your 
      program if you use Delphi 3.x.

    Delphi4.ZIP contents:
      - ProfOnli.DCU and
      - ProfOnli.DFM.
      This version of ProfOnli.PAS has to be 'USED' when you profile your 
      program if you use Delphi 4.x.

    DLLSUPP.ZIP contents:
      Example project for measuring DLL's.

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

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

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

 7. Copy ProfMeas.DLL, ProfCali.DLL, ProfInt.PAS, ProfOnli.PAS, ProfOnli.DFM
    and your own DPR-, PAS- and INC- files into that directory.

    Alternatively the DLL's can be copied to WINDOWS\SYSTEM for Windows 95/98
    or WINDOWS\SYSTEM32 for Windows NT 4.0.

    The files ProfInt.PAS, ProfOnli.PAS and ProfOnli.DFM can be stored to 
    Delphi's LIB - directory as well.
 
 8. Create a link to run PROFILER.EXE. Beware that the DLL ProfMeas.DLL is
    also in that directory, where you have stored the Profiler if you haven't
    copied it to WINDOWS\SYSTEM(32).

 9. Compile your program.

    IMPORTANT:

      The EXE-File must be compiled into the same directory as the *.PAS,
      *.INC, *.DPR and *.DFM files are copied to !!!

    If no errors occur:

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

   11. Select your directory.

   12. Select Profile, mark the correct Delphi-version and, if you use
       conditional symbols, define them in the edit field of ProDelphi.

   13. Click on Run.

   14. When the profiling is finished, end ProDelphi.

   15. Define the compiler symbol PROFILE in the compiler options (conditional
       definitions), NOT in the source file! Uncheck the
       Optimization-option !!!!!!! and make a COMPLETE compilation.

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

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

                  When you use ProDelphi 6.x under Windows 95, the interrupts
                  are locked while calibrating, 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(s) is/are shown.


   17. After your program has terminated, start ProDelphi 6.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).

   18. Checked procedures might use a few CPU-cycles more than they would
       use without measurement. The reason is, that the measurement procedures
       in the unit ProfInt and in the DLL ProfMeas are moved into the memory 
       cache and delete those procedures that would be there without 
       measurement. Depending on the CPU you use, the results are very accurate
       or less accurate. (Same effect is given for data too.)

       The cache of the plain pentium has 16 kB,
       the pentium MMX has 32 kB Cache size,
       the AMD K6 and K6-2 have 64 kB Cache Size.

       That's why the results on a K6 are more excact than on pentium or
       pentium MMX.


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

20. Limitations of use:

    Console applications can not have an online operation window.
    For further minor important limitations see README.DOC.

21. For DLL-support unzip the file DLLSUPP.ZIP and read the comments in the
    sources.

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

Delete the files, directories and links you have created.


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

  PROFILER.EXE   ProDelphi executable file
  PROFINT.PAS    Units for Delphi2, Delphi3 and Delphi4 that links
                 the profiled program or DLL to the measurement DLL 
                 PROFMEAS.DLL (time measurement).
  PROFONLI.PAS   Units for Delphi2, Delphi3 and Delphi4 that content the
                 function of the online operation window.
  PROFONLI.DFM   DFM - files for Delphi2, Delphi3 and Delphi4 that content
                 the form.
  PROFMEAS.DLL   The DLL, that contents all measurement procedures. There is
                 one DLL for all Delphi versions.
  PROFCALI.DLL   DLL that computes the measurement correction (calibration),
                 it is included used by PROFINT.PAS.
  README6x.DOC   Description of ProDelphi x.x (Word-Format)
  ORDER.TXT      Information on how to order the registered version
  ORDFORM.TXT    Ordering form for postal orders
  LICENSE.TXT    License Agreement / Warranty Disclaimer
  VENDOR.TXT     Information for shareware distributors
  INSTALL.TXT    This file.
  NEWS.TXT       News and Hints for usage of ProDelphi.
  REGISTER.ENG   Registration via www.shareit.com (english)
  REGISTER.GER   Registration via www.shareit.com (german)
  DLLSUPP.ZIP    Example project for measuring procedures in a DLL.


--------------------  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).



