Tcl Profile - 1 Aug 92

   This is an experiential release of a Tcl performance profiling facility
designed to aid in analyzing Tcl script performance.  It logs the number of
times a procedure is called and the amount of real and CPU time spent in that
procedure.  The procedure data is collected by bucketing it based on the
procedure call stack, this allows determination of how much time is spent in a
particular procedure in each of it's calling contexts.

   o README.PROF - This file.
   o profile.c - The code implementing the profile command.
   o profrep.tcl - Reduction program, written in Tcl.
   o tclprof.man - A man page describing the "profile" command and the
     "profrep" procedure.
   
You might have to edit profile.c to define or undefine TCL_NEED_TIME_H
depending on your Unix implementation.  To enable the profile command, include
the following call in your Tcl application's command initialization:

    Tcl_InitProfile (interp);

This will define the profile command.  If you are using Extended Tcl, added
profrep.tcl to your package library (tcl.tlib), otherwise you can just "source"
it to defined the profrep procedure.  This procedure is used to generate a 
report based on data collected by the "profile" command.

This code will eventually be released as part of Extended Tcl.  This version
of the command will work with or without the Extended Tcl package and is tested
on Tcl 6.3.  I am releasing this independently of the next release of Extended
Tcl to get feed back.  Please mail me at:


    markd@grizzly.com


if you have any input, questions or comments.  Please DO NOT reply directly to
this posting, mail me at markd@grizzly.com.

Mark Diekhans