Home My Page Projects Code Snippets Project Openings SML/NJ
Summary Activity Forums Tracker Lists Tasks Docs Surveys News SCM Files

SCM Repository

[smlnj] Diff of /sml/trunk/NOTES/HISTORY
ViewVC logotype

Diff of /sml/trunk/NOTES/HISTORY

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1645, Mon Oct 11 21:37:17 2004 UTC revision 1662, Sun Oct 24 17:56:50 2004 UTC
# Line 13  Line 13 
13  Description:  Description:
14    
15  ----------------------------------------------------------------------  ----------------------------------------------------------------------
16    Name: Allen Leung (leunga (at) reservoir (dot) com)
17    Date: 2004/10/24 14:00:00 EST
18    Tag: leunga-20041024-x86-gas-fucomip
19    Description:
20    
21       John discovered a bug in the syntax of fucomip.
22       The opcodes FU?COMIP? have been changed to
23    
24           fu?comip? %st(i), %st
25    
26    ----------------------------------------------------------------------
27    Name: Matthias Blume (blume (at) tti - c (dot) org)
28    Date: 2004/10/20 15:06:00 CDT
29    Tag: blume-20041020-standalone-backtrace
30    Description:
31    
32    Added a mechanism for getting back-trace information from standalone
33    programs.  Here is how it works:
34    
35       1. The part of the program from which you want to get backtrace
36          information (usually the whole program) should be wrapped with
37          BackTrace.monitor.  This is a (unit->'a)->'a function, and your
38          main program could be modified from something like
39    
40             fun main (pgm, args) = ...
41    
42         to
43    
44            fun main (pgm, args) = BackTrace.monitor (fn () => ...)
45    
46       2. To be able to access BackTrace.monitor, you have to add
47          library $smlnj-tdp/plugins.cm to the .cm file that contains your
48          main function.
49    
50       3. Remove all compiled code (i.e., all the .cm/ subdirectories that
51          CM might have created in the past for your project).
52    
53       4. Build the system using this command line:
54    
55             ml-build -Ctdp.instrument=true \$smlnj-tdp/back-trace.cm \
56                      myprog.cm MyProg.main myprog
57    
58          instead of the usual
59    
60             ml-build myprog.cm MyProg.main myprog
61    
62    I changed a library name:
63    
64       $/trace-debug-profile.cm --> $smlnj-tdp/plugins.cm
65    
66    New libraries:
67    
68       $smlnj-tdp/back-trace.cm
69          -- when loaded causes the back-trace plugin to be installed
70       $smlnj-tdp/coverage.cm
71          -- when loaded causes the coverage plugin to be installed
72    
73    ----------------------------------------------------------------------
74    Name: Matthias Blume (blume (at) tti - c (dot) org)
75    Date: 2004/10/18 16:45:00 CDT
76    Tag: blume-20041018-groupowner
77    Description:
78    
79    Added an "obsolete" warning for the "group owner" syntax to CM's parser.
80    
81    Eliminated group owner specs from .cm files throughout the source tree.
82    
83    ----------------------------------------------------------------------
84    Name: Matthias Blume (blume (at) tti - c (dot) org)
85    Date: 2004/10/15 15:45:00 CDT
86    Tag: blume-20041015-coverage
87    Description:
88    
89    * Test coverage tool added!
90    * Further reorganization of tracing-, debugging-, and profiling support:
91    
92        - moved original BTImp -- now called BackTrace -- into a separate
93          library called $/trace-debug-profile.cm
94        - eliminated all mentions of BTrace from SMLofNJ.Internals
95        - only the instrumentation mechanism is now left in the compiler proper
96        - BackTrace module is a plugin which is NOT plugged in by default
97        - Coverage module is another such plugin
98    
99    To get the benefits of any of these plugin modules, the code in
100    question must be compiled with tdp instrumentation turned on.  This
101    can be done by setting SMLofNJ.Internals.TDP.mode to true.
102    (The ref cell is also controlled via the -Ctdp.instrument=... switch.)
103    
104    Plugins are selected at link time.  (Pre-compiled instrumented code
105    can be re-loaded with different plugins in effect.)  When an
106    instrumented module is linked, whatever plugins are at that time
107    enabled will come into effect for that module.
108    
109    To enable the back-trace plugin, load library $/trace-debug-profile.cm
110    and invoke BackTrace.install() (e.g., from the interactive prompt).
111    To enable the coverage plugin, load the same library and invoke
112    Coverage.install().
113    
114    Back-traces are generated automatically on uncaught exceptions and
115    when the code in question explicitly invokes BackTrace.trigger().
116    
117    Coverage (and execution frequency-) information must be queried
118    explicitly by calling Coverage.not_covered and Coverage.hot_spots.
119    
120    ----------------------------------------------------------------------
121    Name: Matthias Blume (blume (at) tti - c (dot) org)
122    Date: 2004/10/14 17:40:00 CDT
123    Tag: blume-20041014-tdp-core
124    Description:
125    
126    Snapshot of a significant overhaul of how the trace/debug/profile support
127    is hooked into the system (specifically: Core and SMLofNJ.Internals).
128    
129    ----------------------------------------------------------------------
130    Name: Matthias Blume (blume (at) tti - c (dot) org)
131    Date: 2004/10/13 16:34:00 CDT
132    Tag: blume-20041013-tdp
133    Description:
134    
135    Some rationalization of names:
136    
137       structure BTrace -> structure TDPInstrument
138       etc.
139    
140    This is is preparation of using the original back-trace
141    instrumentation for other purposes.  "TDP" stands for
142    Trace/Debug/Profile.
143    
144    The control flag controlling whether instrumentation is on or off is now
145    registered under a different name, so instead of running sml as
146    
147     sml -Cinstrument.btrace-mode=true
148    
149    one has to say
150    
151     sml -Ctdp.instrument=true
152    
153    ----------------------------------------------------------------------
154  Name: Matthias Blume (blume (at) tti - c (dot) org)  Name: Matthias Blume (blume (at) tti - c (dot) org)
155  Date: 2004/10/11 16:37:00 CDT  Date: 2004/10/11 16:37:00 CDT
156  Tag: blume-20041011-regions  Tag: blume-20041011-regions

Legend:
Removed from v.1645  
changed lines
  Added in v.1662

root@smlnj-gforge.cs.uchicago.edu
ViewVC Help
Powered by ViewVC 1.0.0