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/HISTORY
ViewVC logotype

Diff of /sml/trunk/HISTORY

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

revision 1622, Mon Sep 13 21:50:40 2004 UTC revision 1653, Fri Oct 15 20:45:02 2004 UTC
# Line 14  Line 14 
14    
15  ----------------------------------------------------------------------  ----------------------------------------------------------------------
16  Name: Matthias Blume (blume (at) tti - c (dot) org)  Name: Matthias Blume (blume (at) tti - c (dot) org)
17    Date: 2004/10/15 15:45:00 CDT
18    Tag: blume-20041015-coverage
19    Description:
20    
21    * Test coverage tool added!
22    * Further reorganization of tracing-, debugging-, and profiling support:
23    
24        - moved original BTImp -- now called BackTrace -- into a separate
25          library called $/trace-debug-profile.cm
26        - eliminated all mentions of BTrace from SMLofNJ.Internals
27        - only the instrumentation mechanism is now left in the compiler proper
28        - BackTrace module is a plugin which is NOT plugged in by default
29        - Coverage module is another such plugin
30    
31    To get the benefits of any of these plugin modules, the code in
32    question must be compiled with tdp instrumentation turned on.  This
33    can be done by setting SMLofNJ.Internals.TDP.mode to true.
34    (The ref cell is also controlled via the -Ctdp.instrument=... switch.)
35    
36    Plugins are selected at link time.  (Pre-compiled instrumented code
37    can be re-loaded with different plugins in effect.)  When an
38    instrumented module is linked, whatever plugins are at that time
39    enabled will come into effect for that module.
40    
41    To enable the back-trace plugin, load library $/trace-debug-profile.cm
42    and invoke BackTrace.install() (e.g., from the interactive prompt).
43    To enable the coverage plugin, load the same library and invoke
44    Coverage.install().
45    
46    Back-traces are generated automatically on uncaught exceptions and
47    when the code in question explicitly invokes BackTrace.trigger().
48    
49    Coverage (and execution frequency-) information must be queried
50    explicitly by calling Coverage.not_covered and Coverage.hot_spots.
51    
52    ----------------------------------------------------------------------
53    Name: Matthias Blume (blume (at) tti - c (dot) org)
54    Date: 2004/10/14 17:40:00 CDT
55    Tag: blume-20041014-tdp-core
56    Description:
57    
58    Snapshot of a significant overhaul of how the trace/debug/profile support
59    is hooked into the system (specifically: Core and SMLofNJ.Internals).
60    
61    ----------------------------------------------------------------------
62    Name: Matthias Blume (blume (at) tti - c (dot) org)
63    Date: 2004/10/13 16:34:00 CDT
64    Tag: blume-20041013-tdp
65    Description:
66    
67    Some rationalization of names:
68    
69       structure BTrace -> structure TDPInstrument
70       etc.
71    
72    This is is preparation of using the original back-trace
73    instrumentation for other purposes.  "TDP" stands for
74    Trace/Debug/Profile.
75    
76    The control flag controlling whether instrumentation is on or off is now
77    registered under a different name, so instead of running sml as
78    
79     sml -Cinstrument.btrace-mode=true
80    
81    one has to say
82    
83     sml -Ctdp.instrument=true
84    
85    ----------------------------------------------------------------------
86    Name: Matthias Blume (blume (at) tti - c (dot) org)
87    Date: 2004/10/11 16:37:00 CDT
88    Tag: blume-20041011-regions
89    Description:
90    
91    Made some minor modifications to elabcore.sml to have source regions
92    be propagated more tightly -- resulting in better (i.e., smaller)
93    regions being reported in error- and debug messages.
94    
95    ----------------------------------------------------------------------
96    Name: Matthias Blume (blume (at) tti - c (dot) org)
97    Date: 2004/10/08 22:50:00 CDT
98    Tag: blume-20041008-cmkw
99    Description:
100    
101    Fixed handling of keywords in .cm files: After seeing "is" the lexer
102    treats subsequent occurrences of "group", "library", "source", "is",
103    "*", and "-" as ordinary identifiers rather than keywords.
104    
105    Most seriously, this fixes a problem with CM's "shell" tool.  The tool
106    is supposed to accept a tool argument called "source", but this did
107    not work because of the clash with the keyword.
108    
109    ----------------------------------------------------------------------
110    Name: Matthias Blume (blume (at) tti - c (dot) org)
111    Date: 2004/10/07 16:00:00 CDT
112    Tag: blume-20041007-cleanup
113    Description:
114    
115    Assorted cleanup work:
116    
117      - got rid of intstrmap in favor of using the library's
118        hash table implementation
119      - threw out most of the pathnames stuff, as it was not used anyway
120      - simplified tokentable implementation
121      - fixed some minor spelling errors
122    
123    ----------------------------------------------------------------------
124    Name: Matthias Blume (blume (at) tti - c (dot) org)
125    Date: 2004/10/06 15:15:15 CDT
126    Tag: blume-20041006-handler
127    Description:
128    
129    Cleaned up the absyn to reflect the invariant that HANDLE always
130    carries a FNexp as part of the type definition.  This eliminates some
131    superfluous sanity checks at runtime down the road.
132    
133    Some minor cleanup of the btrace code.
134    
135    ----------------------------------------------------------------------
136    Name: Matthias Blume (blume (at) tti - c (dot) org)
137    Date: 2004/10/01 10:20:30 CDT
138    Tag: blume-20041001-slave
139    Description:
140    
141    Added hack to make slave mode work in the presence of the version
142    tool.  (Still, since the master does two passes over the code for
143    CMB.make, the release number gets bumped twice when slaves are
144    attached.  I don't know if this is worth fixing...)
145    
146    ----------------------------------------------------------------------
147    Name: Matthias Blume (blume (at) tti - c (dot) org)
148    Date: 2004/09/30 10:55:00 CDT
149    Tag: blume-20040930-version
150    Description:
151    
152    * Moved the "version" magic into its own little library under
153    src/system/smlnj/internal.  This avoids expensive reconstruction
154    of a stable src/compiler/core.cm.
155    
156    * At the same time, structure CompilerVersion is now known as structure
157    SMLNJVersion.
158    
159    * Arranged for the version tool to NOT kick in when rebuilding the system
160      (makeml -rebuild, fixpt).  Otherwise one would never reach a fixpoint.
161      Also, loading the versiontool does not work when rebuilding the system
162      because CM is not properly initialized at that time.
163    
164    ----------------------------------------------------------------------
165    Name: Matthias Blume (blume (at) tti - c (dot) org)
166    Date: 2004/09/29 14:00:00 CDT
167    Tag: blume-20040929-autoversion
168    Description:
169    
170    Implemented some CM magic to have
171        file src/compiler/TopLevel/main/version.sml
172    generated automagically.
173    The version is taken from two files: config/version and config/release.
174    The first is expected to contain a two-part version number such as 110.49.
175    The second should contain a single number, but it may be missing.
176    
177    If the environment variable VERSIONTOOL_BUMP_RELEASE is defined at the
178    time the version tool is loaded (which is the first time you say CMB.make),
179    then the tool will increment the value stored in config/release every
180    time CMB.make is invoked.
181    
182    The binfile format is now insensitive to anything beyond the first
183    two components of a version number, so bumping the release does not render
184    binfiles incompatible.  Auto-bumping can be used to keep track of versions
185    during development without invalidating existing binfiles.
186    
187    In any case, every CMB.make updates the date information in version.sml.
188    (This is the date that is printed in the banner.)
189    
190    ----------------------------------------------------------------------
191    Name: Matthias Blume (blume (at) tti - c (dot) org)
192    Date: 2004/09/28 10:53:00 CDT
193    Tag: blume-20040928-controls
194    Description:
195    
196    Some cleanup of the controls code.
197    
198    ----------------------------------------------------------------------
199    Name: Matthias Blume (blume (at) tti - c (dot) org)
200    Date: 2004/09/27 22:08:00 CDT
201    Tag: blume-20040927-controls
202    Description:
203    
204    Added two pieces of functionality to the Controls interface:
205    
206    1.   val save'restore: 'a control -> unit -> unit
207    
208       grabs the current value of the control in stage 1 and restores it
209       in stage 2.
210    
211    2.   val set' : 'a control * 'a -> unit -> unit
212    
213       stores the given value into the control in stage 2 (i.e., delayed)
214       but does all error checking in stage 1.
215       (This is for string controls that need to do parse their argument --
216        something that might fail.  In some cases, notably in CM, one
217        already knows the intended argument but wants to delay the actual
218        assignment until a time when error recovery would be more difficult.)
219    
220    Changed the handling of controls in tool arguments to classes "sml" and
221    "lazysml":
222       - use Controls.save'restore as a more robust way of restoring the
223         old value (in particular: without having to re-parse the string)
224       - use controls to handle the "overload" keyword in the init group
225         (I believe this change actually fixes a long-standing obscure bug.)
226    
227    ----------------------------------------------------------------------
228    Name: Matthias Blume (blume (at) tti - c (dot) org)
229    Date: 2004/09/27 17:00:00 CDT
230    Tag: blume-20040927-lazysml
231    Description:
232    
233    Added a new tool class called "lazysml" to CM's tool chest.  The only
234    difference to "sml" is that compilation is done with Control.lazysml
235    set to true.  A source of class "lazysml" is automatically recognized
236    by a file name suffix of ".lml".
237    
238    In addition to the above feature, the original class "sml" now also
239    supports a tool argument "lazy" which has the same effect.  As a
240    result, the following three lines are equivalent:
241    
242        foo.sml : lazysml
243        foo.sml : sml (lazy)
244        foo.sml (lazy)
245    
246    The setting goes into effect both during parsing and during
247    compilation.  The original setting is restored right after parsing and
248    after compilation, respectively.
249    
250    In addition to all the above, there is also a general mechanism to set
251    ANY of the "controls" that are available at the command line via
252    "-C..." on a per-sml-file basis.  The same rules that apply for "lazy"
253    apply as well. (In fact, "lazy" is implemented as a special case of
254    the general mechanism.)
255    
256    The .cm file syntax uses a new keyword tool argument called "with".
257    There are several ways of indicating the desired settings:
258    
259        foo.sml (with:parser.quotations=true)
260        foo.sml (with:(name:parser.quotations value:true))
261        foo.sml (with:(name:name1 value:value1 name:name2 value:value2 ...))
262        foo.sml (with:(name1=value1 name2=value2 ...))
263        foo.sml (with:(name1=value1 name:name2 value:value2 name3=value3 ...))
264    
265        etc.
266    
267    Another possible abbreviation is to leave out the =v or value:v part
268    if the name refers to a boolean control (in which case the value is
269    taken to be true).  Thus, one could get lazy sml also by saying:
270    
271        foo.sml (with:parser.lazy-keyword=true)
272        foo.sml (with:parser.lazy-keyword)
273        foo.sml (with:(name:parser.lazy-keyword value:true))
274        foo.sml (with:(name:parser.lazy-keyword))
275    
276    ----------------------------------------------------------------------
277    Name: Matthias Blume (blume (at) tti - c (dot) org)
278    Date: 2004/09/24 16:22:00 CDT
279    Tag: blume-20040924-ppc-long-branch
280    Description:
281    
282    Turned message about "emiting long form of branch" off by default.
283    Added a control flag to turn it back on when desired.
284    
285    ----------------------------------------------------------------------
286    Name: Matthias Blume (blume (at) tti - c (dot) org)
287    Date: 2004/09/24 16:05:00 CDT
288    Tag: blume-20040924-rounding
289    Description:
290    
291    Applied patch for setting rounding modes under Mac OS X.  Thanks to
292    Melissa O'Neill for providing the code!
293    
294    ----------------------------------------------------------------------
295    Name: Matthias Blume (blume (at) tti - c (dot) org)
296    Date: 2004/09/23 17:30:00 CDT
297    Tag: blume-20040923-envvars
298    Description:
299    
300    1. Changed definition of type ControlRegistry.registry_tree to
301       include control_info (i.e., the name of the controlling environment
302       variable).
303    
304    2. Added command-line flags -e and -E to print the names of environment
305       variables that can be used to control internal settings.
306       (This uses the new API mentioned in 1.)
307    
308    ----------------------------------------------------------------------
309    Name: Matthias Blume (blume (at) tti - c (dot) org)
310  Date: 2004/09/13 16:50:00 CDT  Date: 2004/09/13 16:50:00 CDT
311  Tag: Release_110_49  Tag: Release_110_49
312  Description:  Description:

Legend:
Removed from v.1622  
changed lines
  Added in v.1653

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