home *** CD-ROM | disk | FTP | other *** search
/ Chip 2004 July / Chip_2004-07_cd1.bin / program / delphi / download / nastroje / d234567 / PRODELD.ZIP / INSTALL.TXT < prev    next >
Text File  |  2004-02-20  |  9KB  |  217 lines
  1. ProDelphi 15.x    Copyright 1998-2004  Helmuth J. H. Adolph
  2.  
  3. Freeware and Professional versions
  4.  
  5. ---------------------------  Installing ProDelphi  ----------------------------
  6.  
  7. A  General
  8. ----------
  9.  
  10.  1. Check your CPU:
  11.    
  12.     ProDelphi runs on Pentium and Pentium compatible CPU's. It has been
  13.     tested on:
  14.     - Pentium Overdrive 120 MHz, Intel Celeron 400 MHz, Intel Pentium II, 
  15.       with 400 MHz and Pentium III with 750 MHz, Pentium 4/2.4 GHz,
  16.       Centrino 1.4 GHz.
  17.     - AMD K6 166 and 233 MHz, AMD K6-2 266, 300 and 500 MHz, AMD K6-3 400 MHz, 
  18.       AMD Athlon 600 MHz, Mobile Athlon 1800 MHz, Duron 1000 Mhz
  19.  
  20.    
  21.     It definitely does NOT run on a Cyrix 6x86. The Cyrix M2 and IDT have
  22.     not been tested.
  23.  
  24.  2. It is not necessary to uninstall an old version of ProDelphi before
  25.     installing the new version.
  26.  
  27.  3. Install ProDelphi with the enclosed Setup program.
  28.  
  29.  4. You should read the documentation (GuidePD.PDF), Post-Mortem-review is only
  30.     described in the documention.
  31.  
  32.  
  33. B.  Testing the installation with the example programs (for automatic setup)
  34. ----------------------------------------------------------------------------
  35.  
  36.   If you have installed ProDelphi with Setup.exe, you can now, for testing 
  37.   the installation or for checking the accuracy of ProDelphi, compile the
  38.   two example programs installed in the subdirctories under your installation
  39.   directory. The example in the directory DONT-PROFILE should not be 
  40.   profiled, only compiled. It has a built-in runtime measurement and gives
  41.   you the runtime for some typical code constructions you would always come 
  42.   across when you write programs yourself. 
  43.  
  44.   The compiler switch for optimization should be unchecked, otherwise
  45.   ProDelphi inserts lines for deactivating optimization into your sources.
  46.  
  47.   The program in the directory PROFILE-ME is, in principal, the same program
  48.   without the built-in runtime measurement. You should first compile this
  49.   program and then start ProDelphi from the Tools-menu of Delphi. Select
  50.   'Profile', select this program, check the box 'Autostart' and then click
  51.   the Run-button. After that define the compiler symbol 'PROFILE' in Delphi
  52.   and compile it again. Start the program, press the start button and then
  53.   close the application. In ProDelphi select the function 'View', select
  54.   the text file in the directory PROFILE-ME, and click 'Run'. A window should
  55.   appear with the measurement results. Keep this window open.
  56.  
  57.   Compile the program in the directory DONT-PROFILE and start it. Compare
  58.   the results for runtime measurement of both programs, they should be
  59.   nearly identical (differences depend on the cache size of your CPU - see
  60.   progrm description,
  61.  
  62.   The programs in the subdirectory DLLSUPP are fore users which want 
  63.   to measure methods in DLL's
  64.  
  65.  
  66. C. Profiling your own sources
  67. -----------------------------
  68.  
  69.  1. Save all your sources (e.g. ZIP them into an achive file).
  70.  
  71.  2. Compile your program.
  72.  
  73.     If no errors occur:
  74.  
  75.     3. Start ProDelphi.
  76.  
  77.     4. Select Profile and mark the correct Delphi-version. If you use
  78.        conditional symbols, you should  see them in your ProDelphi window (if
  79.        not, you haven't saved your project).
  80.  
  81.     5. Select this directory of your DPR-file.
  82.  
  83.     6. Click on Run.
  84.  
  85.     7. Define the compiler symbol PROFILE in the compiler options (conditional
  86.        definitions), NOT in the source file! Uncheck the
  87.        Optimization-option !!!!!!! and make a COMPLETE compilation.
  88.  
  89.     8. Start your program and let it do what it has to do.
  90.  
  91.        Attention: When you start your program, it takes a second or two for
  92.                   calibration (estimation of your CPU speed and measurement
  93.                   correction times).
  94.  
  95.                   When you use ProDelphi under Windows 95, the interrupts
  96.                   are locked while calibrating, that means that your mouse
  97.                   cursor does not move !!!
  98.                   Under Windows NT/XP/2000 the interrupts can not be locked, 
  99.                   so your mouse cursor can be moved.
  100.  
  101.                   Please do not start any other programs while calibrating,
  102.                   otherwise the results are incorrect.
  103.  
  104.                   After the calibration phase the Online operation window and
  105.                   your form(s) is/are shown.
  106.  
  107.  
  108.     9. After your program has terminated, start ProDelphi, select VIEW,
  109.        open the directory with your compiled program, select the file 
  110.        'Progname.TXT' and click the Run-button.
  111.        'Progname' stands for the name of your program.
  112.        After this actions the viewer window opens and you can look at the
  113.        results of the measurement.
  114.  
  115.        If, at profilation time, you have checked ASCII-output file you also
  116.        can have a look into the result file (programname.BEN) with Delphi
  117.        or print it with Delphi (use landscape format).
  118.  
  119.    10. Checked procedures might use a few CPU-cycles more than they would
  120.        use without measurement. The reason is, that the measurement procedures
  121.        in the unit ProfInt and in the DLL ProfMeas are moved into the memory 
  122.        cache and delete those procedures that would be there without 
  123.        measurement. Depending on the CPU you use, the results are very accurate
  124.        or less accurate. (Same effect is given for data too.)
  125.  
  126.        The L1-cache of the plain pentium has 16 kB,
  127.        the L1-cache of pentium MMX / PII or Celeron have 32 kB Cache size,
  128.        the AMD K6 / K6-2 / K6-3 have 64 kB L1-Cache size, AMD Athlon has
  129.        128 kB L1-Cache, Pentium 4 A has 20 kB L1-Cache.
  130.        Also the L2-Cache sizes differ, the processor might have a L3-cache
  131.        (e.g. the AMD K6-3). Also the accesses to L2-cache differ (1/3, 1/2,
  132.        1/1 CPU frequency or bus frequency).
  133.  
  134.        That's why the results on an AMD K6-x or AMD Athlon are more excact 
  135.        than on pentium processors.
  136.  
  137.  
  138. 11. See the GuidePD.PDF file for further instruction or information.
  139.  
  140. 12. Limitations of use:
  141.  
  142.     Console applications can not have an online operation window.
  143.     For further minor important limitations see README.DOC.
  144.  
  145. 13. For DLL-support unzip the file DLLSUPP.ZIP and read the comments in the
  146.     sources.
  147.  
  148.  
  149. --------------------------  Uninstalling ProDelphi ----------------------------
  150.  
  151. Delete the files, directories and links you have created. For that you can use
  152. the Setup Program.
  153.  
  154.  
  155. -----------------------  ProDelphi Distribution Files  ------------------------
  156.  
  157.   PROFILER.EXE   ProDelphi executable file
  158.   PROFINT.PAS    Units for Delphi2, Delphi3, Delphi4 and Delphi 5 that links
  159.                  the profiled program or DLL to the measurement DLL 
  160.                  PROFMEAS.DLL (time measurement).
  161.   PROFONLI.PAS   Units for Delphi2, Delphi3, Delphi4 and Delphi 5 that content
  162.                  the functions of the online operation window.
  163.   PROFONLI.DFx   DFM - files for Delphi2, Delphi3, Delphi4 and Delphi 5 that 
  164.                  content the form of PROFONLI.PAS.
  165.   PROFMEAS.DLL   The DLL, that contents all measurement procedures. There is
  166.                  one DLL for all Delphi versions.
  167.   PROFCALI.DLL   DLL that computes the measurement correction (calibration),
  168.                  it is included used by PROFINT.PAS.
  169.   GuidePD.PDF    Description of ProDelphi x.x (Adobe-Format)
  170.   ORDER.TXT      Information on how to order the registered version
  171.   LICENSE.TXT    License Agreement / Warranty Disclaimer
  172.   VENDOR.TXT     Information for shareware distributors
  173.   INSTALL.TXT    This file.
  174.   NEWS.TXT       News and Hints for usage of ProDelphi.
  175.   REGISTER.ENG   Registration via www.shareit.com (english)
  176.   REGISTER.GER   Registration via www.shareit.com (german)
  177.   SETUP.EXE      Program for automatic setup.
  178.   GETSPEED.EXE   Program to get the speed index of a PC to be emulated.
  179.   DLLSUPP.ZIP    Example project for measuring procedures in a DLL.
  180.  
  181.  
  182. -------------------------  Files created by ProDelphi -------------------------
  183.  
  184. PROFLST.ASC    Contains information about the procedures to be measured for
  185.                profiling or traced for post mortem review.
  186.  
  187. PROFILE.INI    Options for time measurement, screen coordinates for the
  188.                online operation window.
  189.  
  190. ----------  Files created at runtime by measured or traced programs -----------
  191.  
  192. PROGNAME.EXE   PROGNAME is the name of your executable, created by Delphi.
  193.  
  194. PROGNAME.TXT   Results in data base format (runtimes of the procedures), used
  195.                by the built-in viewer.
  196.  
  197. PROGNAME.TX2   Run numbers, CPU-clock-rate and headlines for the built-in
  198.                viewer.
  199.  
  200. PROGNAME.NEV   Contents the names of those methods that are not called at
  201.                time of measurement.
  202.  
  203. PROGNAME.HST   History file, stored by the viewer when the history button
  204.                is pressed. Contains runtimes for later comparison after
  205.                optimization.
  206.  
  207. PROGNAME.BEN   Results of the time measurement in ASCII if the option
  208.                ASCII-output file was checked at profiling time.
  209.  
  210. PROGNAME.SWO   List of procedures that have to be deactivated for time
  211.                measurement at next program start.
  212.  
  213. PROGNAME.PMR   Call stack in case of a trapped exception (for Post Mortem 
  214.                Review only).
  215.  
  216. All files are created in the output directory for the exe- or dll-file.
  217.