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 1619, Wed Sep 8 18:19:45 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)
155    Date: 2004/10/11 16:37:00 CDT
156    Tag: blume-20041011-regions
157    Description:
158    
159    Made some minor modifications to elabcore.sml to have source regions
160    be propagated more tightly -- resulting in better (i.e., smaller)
161    regions being reported in error- and debug messages.
162    
163    ----------------------------------------------------------------------
164    Name: Matthias Blume (blume (at) tti - c (dot) org)
165    Date: 2004/10/08 22:50:00 CDT
166    Tag: blume-20041008-cmkw
167    Description:
168    
169    Fixed handling of keywords in .cm files: After seeing "is" the lexer
170    treats subsequent occurrences of "group", "library", "source", "is",
171    "*", and "-" as ordinary identifiers rather than keywords.
172    
173    Most seriously, this fixes a problem with CM's "shell" tool.  The tool
174    is supposed to accept a tool argument called "source", but this did
175    not work because of the clash with the keyword.
176    
177    ----------------------------------------------------------------------
178    Name: Matthias Blume (blume (at) tti - c (dot) org)
179    Date: 2004/10/07 16:00:00 CDT
180    Tag: blume-20041007-cleanup
181    Description:
182    
183    Assorted cleanup work:
184    
185      - got rid of intstrmap in favor of using the library's
186        hash table implementation
187      - threw out most of the pathnames stuff, as it was not used anyway
188      - simplified tokentable implementation
189      - fixed some minor spelling errors
190    
191    ----------------------------------------------------------------------
192    Name: Matthias Blume (blume (at) tti - c (dot) org)
193    Date: 2004/10/06 15:15:15 CDT
194    Tag: blume-20041006-handler
195    Description:
196    
197    Cleaned up the absyn to reflect the invariant that HANDLE always
198    carries a FNexp as part of the type definition.  This eliminates some
199    superfluous sanity checks at runtime down the road.
200    
201    Some minor cleanup of the btrace code.
202    
203    ----------------------------------------------------------------------
204    Name: Matthias Blume (blume (at) tti - c (dot) org)
205    Date: 2004/10/01 10:20:30 CDT
206    Tag: blume-20041001-slave
207    Description:
208    
209    Added hack to make slave mode work in the presence of the version
210    tool.  (Still, since the master does two passes over the code for
211    CMB.make, the release number gets bumped twice when slaves are
212    attached.  I don't know if this is worth fixing...)
213    
214    ----------------------------------------------------------------------
215    Name: Matthias Blume (blume (at) tti - c (dot) org)
216    Date: 2004/09/30 10:55:00 CDT
217    Tag: blume-20040930-version
218    Description:
219    
220    * Moved the "version" magic into its own little library under
221    src/system/smlnj/internal.  This avoids expensive reconstruction
222    of a stable src/compiler/core.cm.
223    
224    * At the same time, structure CompilerVersion is now known as structure
225    SMLNJVersion.
226    
227    * Arranged for the version tool to NOT kick in when rebuilding the system
228      (makeml -rebuild, fixpt).  Otherwise one would never reach a fixpoint.
229      Also, loading the versiontool does not work when rebuilding the system
230      because CM is not properly initialized at that time.
231    
232    ----------------------------------------------------------------------
233    Name: Matthias Blume (blume (at) tti - c (dot) org)
234    Date: 2004/09/29 14:00:00 CDT
235    Tag: blume-20040929-autoversion
236    Description:
237    
238    Implemented some CM magic to have
239        file src/compiler/TopLevel/main/version.sml
240    generated automagically.
241    The version is taken from two files: config/version and config/release.
242    The first is expected to contain a two-part version number such as 110.49.
243    The second should contain a single number, but it may be missing.
244    
245    If the environment variable VERSIONTOOL_BUMP_RELEASE is defined at the
246    time the version tool is loaded (which is the first time you say CMB.make),
247    then the tool will increment the value stored in config/release every
248    time CMB.make is invoked.
249    
250    The binfile format is now insensitive to anything beyond the first
251    two components of a version number, so bumping the release does not render
252    binfiles incompatible.  Auto-bumping can be used to keep track of versions
253    during development without invalidating existing binfiles.
254    
255    In any case, every CMB.make updates the date information in version.sml.
256    (This is the date that is printed in the banner.)
257    
258    ----------------------------------------------------------------------
259    Name: Matthias Blume (blume (at) tti - c (dot) org)
260    Date: 2004/09/28 10:53:00 CDT
261    Tag: blume-20040928-controls
262    Description:
263    
264    Some cleanup of the controls code.
265    
266    ----------------------------------------------------------------------
267    Name: Matthias Blume (blume (at) tti - c (dot) org)
268    Date: 2004/09/27 22:08:00 CDT
269    Tag: blume-20040927-controls
270    Description:
271    
272    Added two pieces of functionality to the Controls interface:
273    
274    1.   val save'restore: 'a control -> unit -> unit
275    
276       grabs the current value of the control in stage 1 and restores it
277       in stage 2.
278    
279    2.   val set' : 'a control * 'a -> unit -> unit
280    
281       stores the given value into the control in stage 2 (i.e., delayed)
282       but does all error checking in stage 1.
283       (This is for string controls that need to do parse their argument --
284        something that might fail.  In some cases, notably in CM, one
285        already knows the intended argument but wants to delay the actual
286        assignment until a time when error recovery would be more difficult.)
287    
288    Changed the handling of controls in tool arguments to classes "sml" and
289    "lazysml":
290       - use Controls.save'restore as a more robust way of restoring the
291         old value (in particular: without having to re-parse the string)
292       - use controls to handle the "overload" keyword in the init group
293         (I believe this change actually fixes a long-standing obscure bug.)
294    
295    ----------------------------------------------------------------------
296    Name: Matthias Blume (blume (at) tti - c (dot) org)
297    Date: 2004/09/27 17:00:00 CDT
298    Tag: blume-20040927-lazysml
299    Description:
300    
301    Added a new tool class called "lazysml" to CM's tool chest.  The only
302    difference to "sml" is that compilation is done with Control.lazysml
303    set to true.  A source of class "lazysml" is automatically recognized
304    by a file name suffix of ".lml".
305    
306    In addition to the above feature, the original class "sml" now also
307    supports a tool argument "lazy" which has the same effect.  As a
308    result, the following three lines are equivalent:
309    
310        foo.sml : lazysml
311        foo.sml : sml (lazy)
312        foo.sml (lazy)
313    
314    The setting goes into effect both during parsing and during
315    compilation.  The original setting is restored right after parsing and
316    after compilation, respectively.
317    
318    In addition to all the above, there is also a general mechanism to set
319    ANY of the "controls" that are available at the command line via
320    "-C..." on a per-sml-file basis.  The same rules that apply for "lazy"
321    apply as well. (In fact, "lazy" is implemented as a special case of
322    the general mechanism.)
323    
324    The .cm file syntax uses a new keyword tool argument called "with".
325    There are several ways of indicating the desired settings:
326    
327        foo.sml (with:parser.quotations=true)
328        foo.sml (with:(name:parser.quotations value:true))
329        foo.sml (with:(name:name1 value:value1 name:name2 value:value2 ...))
330        foo.sml (with:(name1=value1 name2=value2 ...))
331        foo.sml (with:(name1=value1 name:name2 value:value2 name3=value3 ...))
332    
333        etc.
334    
335    Another possible abbreviation is to leave out the =v or value:v part
336    if the name refers to a boolean control (in which case the value is
337    taken to be true).  Thus, one could get lazy sml also by saying:
338    
339        foo.sml (with:parser.lazy-keyword=true)
340        foo.sml (with:parser.lazy-keyword)
341        foo.sml (with:(name:parser.lazy-keyword value:true))
342        foo.sml (with:(name:parser.lazy-keyword))
343    
344    ----------------------------------------------------------------------
345    Name: Matthias Blume (blume (at) tti - c (dot) org)
346    Date: 2004/09/24 16:22:00 CDT
347    Tag: blume-20040924-ppc-long-branch
348    Description:
349    
350    Turned message about "emiting long form of branch" off by default.
351    Added a control flag to turn it back on when desired.
352    
353    ----------------------------------------------------------------------
354    Name: Matthias Blume (blume (at) tti - c (dot) org)
355    Date: 2004/09/24 16:05:00 CDT
356    Tag: blume-20040924-rounding
357    Description:
358    
359    Applied patch for setting rounding modes under Mac OS X.  Thanks to
360    Melissa O'Neill for providing the code!
361    
362    ----------------------------------------------------------------------
363    Name: Matthias Blume (blume (at) tti - c (dot) org)
364    Date: 2004/09/23 17:30:00 CDT
365    Tag: blume-20040923-envvars
366    Description:
367    
368    1. Changed definition of type ControlRegistry.registry_tree to
369       include control_info (i.e., the name of the controlling environment
370       variable).
371    
372    2. Added command-line flags -e and -E to print the names of environment
373       variables that can be used to control internal settings.
374       (This uses the new API mentioned in 1.)
375    
376    ----------------------------------------------------------------------
377    Name: Matthias Blume (blume (at) tti - c (dot) org)
378    Date: 2004/09/13 16:50:00 CDT
379    Tag: Release_110_49
380    Description:
381    
382    New working version (110.49).  NEW BOOTFILES!
383    
384    ----------------------------------------------------------------------
385    Name: Matthias Blume
386    Date: 2004/09/13 16:20:00 CDT
387    Tag: blume-20040913-config-mlrisc
388    Description:
389    
390    Put target "mlrisc" back into the default list.
391    (There is no harm in having it, and some users have expressed their
392    wish to have "mlrisc" included by default.)
393    
394    ----------------------------------------------------------------------
395    Name: John Reppy
396    Date: 2004/09/13
397    Tag: jhr-20040913-signals
398    Description:
399    
400    Fixed the signal masking code to properly nest mask/unmask operations
401    on a per-signal basis.
402    
403    ----------------------------------------------------------------------
404  Name: Matthias Blume (blume (at) tti - c (dot) org)  Name: Matthias Blume (blume (at) tti - c (dot) org)
405  Date: 2004/09/08 13:20:00 CDT  Date: 2004/09/08 13:20:00 CDT
406  Tag: blume-20040908-heap-magic  Tag: blume-20040908-heap-magic

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

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