home *** CD-ROM | disk | FTP | other *** search
/ Programmer's ROM - The Computer Language Library / programmersrom.iso / ada / style / profread.me < prev    next >
Encoding:
Text File  |  1988-05-03  |  2.8 KB  |  74 lines
  1. To build the statement profile tool:
  2.  
  3.  1. Compile all the abstractions into a program library (see READ.ME in
  4.     abstractions directory for details)
  5.  
  6.  2. Compile everything named in the STMTPROF.CO file into the program library
  7.     containing the abstractions or a sublibrary whose parent library contains 
  8.     all the abstractions.  STMTPROF.CO lists file names in the correct
  9.     compilation order.
  10.  
  11.  3. Link STMTPROF with the program library where everything was compiled.
  12.     To do this using the DEC Ada compiler type:
  13.     $ acs link stmtprof
  14.  
  15. To run the tool on VMS:
  16.  
  17.  1. Define a logical symbol for the executable of STMTPROF.  For example,
  18.  
  19.     STMTPROF :== $DRB1:[NOSC.TOOLS.STMTPROF]STMTPROF.EXE
  20.  
  21.      NOTE: The full path name of the executable is required in the 
  22.      definition of the symbol.   The pathname given here is just an example
  23.      and will be different on your system.
  24.  
  25.  2. Enter the command with appropriate parameters.  For example,
  26.  
  27.     STMTPROF (SOURCE=>"test.ada", OUTPUT=>"test.out");
  28.  
  29.     Entering the command STMTPROF with no parameters gives a brief
  30.     description of how to use the tool.
  31.  
  32. Files contained in this directory:
  33.  
  34. STMTPROF.CO   -- Compilation order for statement profile sources
  35. STMTPROF.EXE  -- VMS 4.0 statement profile executable
  36.  
  37. The [.SOURCE] subdirectory contains most of the sources that make up the 
  38. statement profile tool.  Other sources are contained in the abstractions
  39. directory.
  40.  
  41. Files in [.SOURCE]:
  42.  
  43.     The source files which make up the statement profile tool are as follows:
  44.  
  45.     STMTPROF.ADA -- the driver which deals with the command line
  46.     SPUTILS.SPC  -- the procedures which control gathering info and reporting
  47.     SPUTILS.BDY
  48.  
  49.     Most of the sources for the parser which the statement profile tool uses 
  50.     are in the abstractions directory. The four units which are unique to this 
  51.     tool are as follows:
  52.  
  53.     APPLYACT.SUB -- A subunit of the parser which calls the action subprograms
  54.     GETNEXT.SUB  -- A subunit of the lexer which returns non-comment tokens
  55.                     to the lexer and buffers comments
  56.     GRMCONST.BDY -- Grammar constants for the parse tables
  57.     PTBLS.BDY    -- The parse tables.
  58.  
  59. The ACVC A tests were used in testing the statement profile tool.
  60.  
  61. The [.DOC] subdirectory contains the documentation for the statement profile
  62. tool.
  63.  
  64. Files in [.DOC]:
  65.  
  66.     USERMAN.MEM -- Statement profile user's manual
  67.     USERMAN.RNO -- Runoff input for user's manual
  68.     STMTGRM.LIS -- Listing of statement profile grammar.  The rule numbers
  69.                    in this file may be used to make changes to the case
  70.                    statement in the Apply_Actions subunit.
  71.     STMTPROF.CNT-- Statement counts and line counts of statement profile 
  72.                    source files.
  73.  
  74.