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 677, Mon Jun 26 00:56:56 2000 UTC revision 986, Wed Nov 21 21:03:17 2001 UTC
# Line 11  Line 11 
11  Date:  Date:
12  Tag: <post-commit CVS tag>  Tag: <post-commit CVS tag>
13  Description:  Description:
14    
15    ----------------------------------------------------------------------
16    Name: Matthias Blume
17    Date: 2001/11/21 16:10:00 EST
18    Tag: Release_110_37
19    Description:
20    
21    1. Modifications to the SML/NJ code generator and to the runtime system
22       so that code object name strings are directly inserted into code
23       objects at code generation time.  The only business the runtime system
24       has with this is now to read the name strings on occasions.
25       (The encoding of the name string has also changed somewhat.)
26    
27    2. CM now implements a simple "set calculus" for specifying export lists.
28       In particular, it is now possible to refer to the export lists of
29       other libraries/groups/sources and form unions as well as differences.
30       See the latest CM manual for details.
31    
32    3. An separate notion of "proxy" libraries has again be eliminated from
33       CM's model.  (Proxy libraries are now simply a special case of using
34       the export list calculus.)
35    
36    4. Some of the existing libraries now take advantage of the new set
37       calculus.
38       (Notice that not all libraries have been converted because some
39       of the existing .cm-files are supposed to be backward compatible
40       with 110.0.x.)
41    
42    5. Some cleanup in stand-alone programs.  (Don't use "exnMessage" -- use
43       "General.exnMessage"!  The former relies on a certain hook to be
44       initialized, and that often does not happen in the stand-alone case.)
45    
46    ----------------------------------------------------------------------
47    Name: Lal George
48    Date: 2001/11/21  13:56:18 EST
49    Tag: george-2001121-pseudo-ops
50    Description:
51    
52      Implemented a complete redesign of MLRISC pseudo-ops. Now there
53      ought to never be any question of incompatabilities with
54      pseudo-op syntax expected by host assemblers.
55    
56      For now, only modules supporting GAS syntax are implemented
57      but more should follow, such as MASM, and vendor assembler
58      syntax, e.g. IBM as, Sun as, etc.
59    
60    ----------------------------------------------------------------------
61    Name: Matthias Blume
62    Date: 2001/11/14 11:52:00 EST
63    Tag: blume-20011114-srcname
64    Description:
65    
66    1. Routed the name of the current source file to mlriscgen where it
67       should be directly emitted into the code object.  (This last part
68       is yet to be done.)
69    
70    2. Some cleanup of the pgraph code to make it match the proposal that
71       I put out the other day.  (The proposal notwithstanding, things are
72       still in flux here.)
73    
74    ----------------------------------------------------------------------
75    Name: Lal George
76    Date: 2001/11/14 09:44:04 EST
77    Tag:
78    Description:
79    
80      Fix for a backpatching bug reported by Allen.
81    
82      Because the boundary between short and long span-dependent
83      instructions is +/- 128, there are an astounding number of
84      span-dependent instructions whose size is over estimated.
85    
86      Allen came up with the idea of letting the size of span
87      dependent instructions be non-monotonic, for a maxIter
88      number of times, after which the size must be monotonically
89      increasing.
90    
91      This table shows the number of span-dependent instructions
92      whose size was over-estimated as a function of maxIter, for the
93      file Parse/parse/ml.grm.sml:
94    
95         maxIter            # of instructions:
96            10                      687
97            20                      438
98            30                      198
99            40                        0
100    
101      In compiling the compiler, there is no significant difference in
102      compilation speed between maxIter=10 and maxIter=40. Actually,
103      my measurements showed that maxIter=40 was a tad faster than
104      maxIter=10! Also 96% of the  files in the compiler reach a fix
105      point within 13 iterations, so fixing maxIter at 40, while high,
106      is okay.
107    
108    ----------------------------------------------------------------------
109    Name: Matthias Blume
110    Date: 2001/10/31 15:25:00 EST
111    Tag: blume-20011031-pgraph
112    Description:
113    
114    CKIT:
115    * Changed the "Function" constructor of type Ast.ctype to carry optional
116      argument identifiers.
117    * Changed the return type of TypeUtil.getFunction accordingly.
118    * Type equality ignores the argument names.
119    * TypeUtil.composite tries to preserve argument names but gives up quickly
120      if there is a mismatch.
121    
122    installation script:
123    * attempts to use "curl" if available (unless "wget" is available as well)
124    
125    CM:
126    * has an experimental implementation of "portable graphs" which I will
127      soon propose as an implementation-independent library format
128    * there are also new libraries $/pgraph.cm and $/pgraph-util.cm
129    
130    NLFFI-LIB:
131    * some cleanup (all cosmetic)
132    
133    NLFFIGEN:
134    * temporarily disabled the mechanism that suppresses ML output for
135      C definitions whose identifiers start with an underscore character
136    * generate val bindings for enum constants
137    * user can request that only one style (light or heavy) is being used;
138      default is to use both (command-line arguments: -heavy and -light)
139    * fixed bug in handling of function types involving incomplete pointers
140    * generate ML entry points that take record arguments (i.e., using
141      named arguments) for C functions that have a prototype with named
142      arguments
143      (see changes to CKIT)
144    
145    ----------------------------------------------------------------------
146    Name: Allen Leung
147    Date: 2001/10/27 20:34:00 EDT
148    Tag: leunga-20011027-x86-fast-fp-call
149    Description:
150    
151       Fixed the bug described in blume-20010920-slowfp.
152    
153       The fix involves
154          1. generating FCOPYs in FSTP in ia32-svid
155          2. marking a CALL with the appropriate annotation
156    
157    ----------------------------------------------------------------------
158    Name: Matthias Blume
159    Date: 2001/10/16 11:32:00 EDT
160    Tag: blume-20011016-netbsd
161    Description:
162    
163    Underscore patch from Chris Richards (fixing problem with compiling
164    runtime system under recent NetBSD).
165    
166    ----------------------------------------------------------------------
167    Name: Allen Leung
168    Date: 2001/10/12 17:18:32 EDT 2001
169    Tag: leung-20011012-x86-printflowgraph
170    Description:
171    
172    X86RA now uses a valid (instead of dummy) PrintFlowgraph module.
173    
174    ----------------------------------------------------------------------
175    Name: Lal George
176    Date: 2001/10/11 23:51:34 EDT
177    Tag: george-20011011-too-many-instrs
178    Description:
179    
180    The representation of a program point never expected to see more
181    than 65536 instructions in a basic block!
182    
183    ----------------------------------------------------------------------
184    Name: Lal George
185    Date: 2001/10/09 09:41:37 EDT
186    Tag: george-20011008-mlrisc-labels
187    Description:
188    
189    Changed the machine description files to support printing of
190    local and global labels in assembly code, based on host assembler
191    conventions.
192    
193    ----------------------------------------------------------------------
194    Name: Matthias Blume
195    Date: 2001/09/25 15:25:00 EDT
196    Tag: blume-20010925-exninfo
197    Description:
198    
199    I provided a non-hook implementation of exnName (at the toplevel) and
200    made the "dummy" implementation of exnMessage (at the toplevel) more
201    useful: if nothing gets "hooked in", then at least you are going to
202    see the exception name and a message indicating why you don't see more.
203    
204    [For the time being, programs that need exnMessage and want to use
205    ml-build should either use General.exnMessage (strongly recommended) or
206    refer to structure General at some other point so that CM sees a
207    static dependency.]
208    
209    [Similar remarks go for "print" and "use":  If you want to use their
210    functionality in stand-alone programs generated by ml-build, then use
211    TextIO.output and Backend.Interact.useFile (from $smlnj/compiler.cm).]
212    
213    ----------------------------------------------------------------------
214    Name: Matthias Blume
215    Date: 2001/09/20 17:28:00 EDT
216    Tag: blume-20010920-slowfp
217    Description:
218    
219    Allen says that x86-fast-fp is not safe yet, so I turned it off again...
220    
221    ----------------------------------------------------------------------
222    Name: Matthias Blume
223    Date: 2001/09/20 17:20:00 EDT
224    Tag: blume-20010920-canonicalpaths
225    Description:
226    
227    0. Updated the BOOT file (something that I forgot to do earlier).
228    
229    1. Small internal change to CM so that it avoids "/../" in filenames
230       as much as possible (but only where it is safe).
231    
232    2. Changed config/_run-sml (resulting in a changed bin/.run-sml) so
233       that arguments that contain delimiters are passed through correctly.
234       This change also means that all "special" arguments of the form
235       @SMLxxx... must come first.
236    
237    3. Changed install script to put relative anchor names for tool commands
238       into pathconfig.
239    
240    ----------------------------------------------------------------------
241    Name: Matthias Blume
242    >>>>>>> 1.169
243    Date: 2001/09/18 15:35:00 EDT
244    Tag: blume-20010918-readme11036
245    Description:
246    
247    Added README files.
248    
249    ----------------------------------------------------------------------
250    Name: Matthias Blume
251    Date: 2001/09/18 11:45:00 EDT
252    Tag: Release_110_36 (retag)
253    Description:
254    
255    Fixed mistake in config/preloads. Retagged as 110.36.
256    
257    ----------------------------------------------------------------------
258    Name: Matthias Blume
259    Date: 2001/09/18 09:40:00 EDT
260    Tag: Release_110_36_orig (tag changed)
261    Description:
262    
263    New version (110.36).  New bootfiles.
264    
265    ----------------------------------------------------------------------
266    Name: Matthias Blume
267    Date: 2001/09/14 16:15:00 EDT
268    Tag: blume-20010914-x86fastfp
269    Description:
270    
271    John committed some changes that Allen made, in particular a (hopefully)
272    correctly working version of the x86-fp module.
273    
274    I changed the default setting of the Control.MLRISC.getFlag "x86-fast-fp"
275    flag to "true".  Everything seems to compile to a fixpoint ok, and
276    "mandelbrot" speeds up by about 15%.
277    
278    ----------------------------------------------------------------------
279    Name: Matthias Blume
280    Date: 2001/09/13 11:20:00 EDT
281    Tag: blume-20010913-minimal
282    Description:
283    
284    1. Stefan Monnier's patch to fix a miscompilation problem that
285       was brought to light by John Reppy's work on Moby.
286    
287    2. Implemented a minimal "structure Compiler" that contains just
288       "version" and "architecture".  The minimal version will be
289       available when the full version is not.  This is for backward-
290       compatibility with code that wants to test Compiler.version.
291    
292    ----------------------------------------------------------------------
293    Name: Matthias Blume
294    Date: 2001/08/28 14:03:00 EDT
295    Tag: blume-20010828-ml-lex
296    Description:
297    
298    Fix for bug 1581, received from Neophytos Michael.
299    
300    ----------------------------------------------------------------------
301    Name: Matthias Blume
302    Date: 2001/08/27 11:20:00 EDT
303    Tag: blume-20010827-readme11035
304    Description:
305    
306    Fleshed out the README file for 110.35.
307    
308    ----------------------------------------------------------------------
309    Name: Matthias Blume
310    Date: 2001/08/24 17:10:00 EDT
311    Tag: Release_110_35
312    Description:
313    
314    New version number (110.35).  New bootfiles.
315    
316    ----------------------------------------------------------------------
317    Name: Lal George
318    Date: 2001/08/24 13:47:18 EDT 2001
319    Tag: george-20010824-MLRISC-graphs
320    Description:
321    
322     removed clusters from MLRISC completely and replaced with graphs.
323    
324    ----------------------------------------------------------------------
325    Name: Matthias Blume
326    Date: 2001/08/23 17:50:00 EDT
327    Tag: blume-20010823-toplevel
328    Description:
329    
330    - some reorganization of the code that implements various kinds of
331      environments in the compiler (static, dynamic, symbolic, combined)
332    - re-implemented the EnvRef module so that evalStream works properly
333      (if the stream contains references to "use", "CM.make", etc.)
334    - cleaned up evalloop.sml and interact.sml (but they need more cleaning)
335    
336    ----------------------------------------------------------------------
337    Name: Matthias Blume
338    Date: 2001/08/20 15:50 EDT
339    Tag: blume20010820-slipup
340    Description:
341    
342    I forgot to commit a few files.  Here they are...
343    
344    ----------------------------------------------------------------------
345    Name: Matthias Blume
346    Date: 2001/08/20 15:35:00 EDT
347    Tag: blume-20010820-debugprof
348    Description:
349    
350    !!!! NEW BOOTFILES !!!!
351    
352    This is another round of reorganizing the compiler sources.  This
353    time the main goal was to factor out all the "instrumentation"
354    passes (for profiling and backtracing) into their own library.
355    The difficulty was to do it in such a way that it does not depend
356    on elaborate.cm but only on elabdata.cm.
357    
358    Therefore there have been further changes to both elaborate.cm and
359    elabdata.cm -- more "generic" things have been moved from the former
360    to the latter.  As a result, I was forced to split the assignment
361    of numbers indicating "primtyc"s into two portions: SML-generic and
362    SML/NJ-specific.  Since it would have been awkward to maintain,
363    I bit the bullet and actually _changed_ the mapping between these
364    numbers and primtycs.  The bottom line of this is that you need
365    a new set of bin- and bootfiles.
366    
367    I have built new bootfiles for all architectures, so doing a fresh
368    checkout and config/install.sh should be all you need.
369    
370    The newly created library's name is
371    
372        $smlnj/viscomp/debugprof.cm
373    
374    and its sources live under
375    
376        src/compiler/DebugProf
377    
378    ----------------------------------------------------------------------
379    Name: Matthias Blume
380    Date: 2001/08/15 17:15:00 EDT
381    Tag: blume-20010815-compreorg
382    Description:
383    
384    This is a first cut at reorganizing the CM libraries that make up the
385    core of the compiler.  The idea is to separate out pieces that could
386    be used independently by tools, e.g., the parser, the typechecker, etc.
387    
388    The current status is a step in this direction, but it is not quite
389    satisfactory yet.  Expect more changes in the future.
390    
391    Here is the current (new) organization...
392    
393        What used to be $smlnj/viscomp/core.cm is now divided into
394        six CM libraries:
395    
396             $smlnj/viscomp/basics.cm
397                           /parser.cm
398                           /elabdata.cm
399                           /elaborate.cm
400                           /execute.cm
401                           /core.cm
402    
403        The CM files for these libraries live under src/system/smlnj/viscomp.
404        All these libraries are proxy libraries that contain precisely
405        one CM library component.  Here are the locations of the components
406        (all within the src/compiler tree):
407    
408             Basics/basics.cm
409             Parse/parser.cm
410             ElabData/elabdata.cm
411             Elaborator/elaborate.cm
412             Execution/execute.cm
413             core.cm
414    
415         [This organization is the same that has been used already
416         for a while for the architecture-specific parts of the visible
417         compiler and for the old version of core.cm.]
418    
419         As you will notice, many source files have been moved from their
420         respective original locations to a new home in one of the above
421         subtrees.
422    
423         The division of labor between the new libraries is the following:
424    
425             basics.cm:
426                - Simple, basic definitions that pertain to many (or all) of
427                  the other libraries.
428             parser.cm:
429                - The SML parser, producing output of type Ast.dec.
430                - The type family for Ast is also defined and exported here.
431             elabdata.cm:
432                - The datatypes that describe input and output of the elaborator.
433                  This includes types, absyn, and static environments.
434             elaborator.cm:
435                - The SML/NJ type checker and elaborator.
436                  This maps an Ast.dec (with a given static environment) to
437                  an Absyn.dec (with a new static environment).
438                - This libraries implements certain modules that used to be
439                  structures as functors (to remove dependencies on FLINT).
440             execute.cm:
441                - Everything having to do with executing binary code objects.
442                - Dynamic environments.
443             core.cm:
444                - SML/NJ-specific instantiations of the elaborator and MLRISC.
445                - Top-level modules.
446                - FLINT (this should eventually become its own library)
447    
448    Notes:
449    
450    I am not 100% happy with the way I separated the elaborator (and its
451    data structures) from FLINT.  Two instances of the same problem:
452    
453        1. Data structures contain certain fields that carry FLINT-specific
454           information.  I hacked around this using exn and the property list
455           module from smlnj-lib.  But the fact that there are middle-end
456           specific fields around at all is a bit annoying.
457    
458        2. The elaborator calculates certain FLINT-related information.  I tried
459           to make this as abstract as I could using functorization, but, again,
460           the fact that the elaborator has to perform calculations on behalf
461           of the middle-end at all is not nice.
462    
463        3. Having to used exn and property lists is unfortunate because it
464           weakens type checking.  The other alternative (parameterizing
465           nearly *everything*) is not appealing, though.
466    
467    I removed the "rebinding =" warning hack because due to the new organization
468    it was awkward to maintain it.  As a result, the compiler now issues some of
469    these warnings when compiling init.cmi during bootstrap compilation. On
470    the plus side, you also get a warning when you do, for example:
471       val op = = Int32.+
472    which was not the case up to now.
473    
474    I placed "assign" and "deref" into the _Core structure so that the
475    code that deals with the "lazy" keyword can find them there.  This
476    removes the need for having access to the primitive environment
477    during elaboration.
478    
479    ----------------------------------------------------------------------
480    Name: Matthias Blume
481    Date: 2001/08/13
482    Tag: blume-20010813-closures
483    Description:
484    
485    This fix was sent to us by Zhong Shao.  It is supposed to improve the
486    performance of certain loops by avoiding needless closure allocation.
487    
488    ----------------------------------------------------------------------
489    Name: Lal George
490    Date: 2001/07/31 10:03:23 EDT 2001
491    Tag: george-20010731-x86-fmalloc
492    Description: Fixed bug in x86 calls
493    
494        There was a bug where call instructions would mysteriously
495        vanish. The call instruction had to be one that returned
496        a floating point value.
497    
498    ----------------------------------------------------------------------
499    Name: Lal George
500    Date: 2001/07/19 16:36:29 EDT 2001
501    Tag: george-20010719-simple-cells
502    Description:
503    
504    I have dramatically simplified the interface for CELLS in MLRISC.
505    
506    In summary, the cells interface is broken up into three parts:
507    
508      1. CellsBasis : CELLS_BASIS
509    
510            CellsBasis is a top level structure and common for all
511            architectures.  it contains the definitions of basic datatypes
512            and utility  functions over these types.
513    
514      2. functor Cells() : CELLS
515    
516            Cells generates an interface for CELLS that incorporates the
517            specific resources on the target architecture, such as the
518            presence of special register classes, their number and size,
519            and various useful substructures.
520    
521      3. <ARCH>CELLS
522    
523            e.g. SparcCells: SPARCCELLS
524    
525            <ARCH>CELLS usually contains additional bindings for special
526            registers  on the architecture, such as:
527    
528                    val r0 : cell           (* register zero *)
529                    val y : cell            (* Y register *)
530                    val psr : cell          (* processor status register *)
531                    ...
532    
533            The structure returned by applying the Cells functor is opened
534            in this interface.
535    
536    The main implication of all this is that the datatypes for cells is
537    split between CellsBasis and CELLS -- a fairly simple change for user
538    code.
539    
540    In the old scheme the CELLS interface had a definitional binding of
541    the form:
542    
543            signature CELLS = sig
544    
545               structure CellsBasis = CellsBasis
546    
547               ...
548    
549            end
550    
551    With all the sharing constraints that goes on in MLRISC, this old
552    design  quickly leads to errors such as:
553    
554            "structure definition spec inside of sharing ... "
555    
556    
557    and appears to require an unacceptable amount of sharing and where
558    constraint hackery.
559    
560    I think this error message (the interaction of definitional specs and
561    sharing) requires more explanation on our web page.
562    
563    ----------------------------------------------------------------------
564    Name: Matthias Blume
565    Date: 2001/07/19 15:00:00 EDT
566    Tag: blume-20010719-libreorg
567    Description:
568    
569    This update puts together a fairly extensive but straightforward change
570    to the way the libraries that implement the interactive system are
571    organized:
572    
573       The biggest change is the elimination of structure Compiler.  As a
574       replacement for this structure, there is now a CM library
575       (known as $smlnj/compiler.cm or $smlnj/compiler/current.cm)
576       that exports all the substructures of the original structure Compiler
577       directly.  So instead of saying Compiler.Foo.bar one now simply
578       says Foo.bar.  (The CM libraries actually export a collection of
579       structures that is richer than the collection of substructures of
580       structure Compiler.)
581    
582       To make the transition smooth, there is a separate library called
583       $smlnj/compiler/compiler.cm which puts together and exports the
584       original structure Compiler (or at least something very close to it).
585    
586       There are five members of the original structure Compiler
587       that are not exported directly but which instead became members
588       of a new structure Backend (described by signature BACKEND).  These are:
589       structure Profile (: PROFILE), structure Compile (: COMPILE), structure
590       Interact (: INTERACT), structure Machine (: MACHINE), and val
591       architecture (: string).
592    
593       Structure Compiler.Version has become structure CompilerVersion.
594    
595       Cross-compilers for alpha32, hppa, ppc, sparc, and x86 are provided
596       by $smlnj/compiler/<arch>.cm where <arch> is alpha32, hppa, ppc, sparc,
597       or x86, respectively.
598       Each of these exports the same frontend structures that
599       $smlnj/compiler.cm exports.  But they do not have a structure Backend
600       and instead export some structure <Arch>Backend where <Arch> is Alpha32,
601       Hppa, PPC, Sparc, or X86, respectively.
602    
603       Library $smlnj/compiler/all.cm exports the union of the exports of
604       $smlnj/compiler/<arch>.cm
605    
606       There are no structures <Arch>Compiler anymore, use
607       $smlnj/compiler/<arch>.cm instead.
608    
609       Library host-compiler-0.cm is gone.  Instead, the internal library
610       that instantiates CM is now called cm0.cm.  Selection of the host
611       compiler (backend) is no longer done here but. (Responsibility for it
612       now lies with $smlnj/compiler/current.cm.  This seems to be more
613       logical.)
614    
615       Many individual files have been moved or renamed.  Some files have
616       been split into multiple files, and some "dead" files have been deleted.
617    
618    Aside from these changes to library organization, there are also changes
619    to the way the code itself is organized:
620    
621       Structure Binfile has been re-implemented in such a way that it no
622       longer needs any knowledge of the compiler.  It exclusively deals
623       with the details of binfile layout.  It no longer invokes the
624       compiler (for the purpose of creating new prospective binfile
625       content), and it no longer has any knowledge of how to interpret
626       pickles.
627    
628       Structure Compile (: COMPILE) has been stripped down to the bare
629       essentials of compilation.  It no longer deals with linking/execution.
630       The interface has been cleaned up considerably.
631    
632       Utility routines for dealing with linking and execution have been
633       moved into their own substructures.
634    
635       (The ultimate goal of these changes is to provide a light-weight
636       binfile loader/linker (at least for, e.g., stable libraries) that
637       does not require CM or the compiler to be present.)
638    
639    CM documentation has been updated to reflect the changes to library
640    organization.
641    
642    ----------------------------------------------------------------------
643    Name: Matthias Blume
644    Date: 2001/07/10 17:30:00 EDT
645    Tag: Release_110_34
646    Description:
647    
648    Minor tweak to 110.34 (re-tagged):
649    
650      - README.html file added to CVS repository
651      - runtime compiles properly under FreeBSD 3.X and 4.X
652    
653    ----------------------------------------------------------------------
654    Name: Matthias Blume
655    Date: 2001/07/10 17:30:00 EDT
656    Tag: Release_110_34
657    Description:
658    
659    New version number (110.34). New bootfiles.
660    
661    ----------------------------------------------------------------------
662    Name: Matthias Blume
663    Date: 2001/07/09 16:00:00 EDT
664    Tag: blume-20010709-more-varargs
665    Description:
666    
667    I changed the handling of varargs in ml-nlffigen again:
668    The ellipsis ... will now simply be ignored (with an accompanying warning).
669    
670    The immediate effect is that you can actually call a varargs function
671    from ML -- but you can't actually supply any arguments beyond the ones
672    specified explicitly.  (For example, you can call printf with its format
673    string, but you cannot pass additional arguments.)
674    
675    This behavior is only marginally more useful than the one before, but
676    it has the advantage that a function or, more importantly, a function
677    type never gets dropped on the floor, thus avoiding follow-up problems with
678    other types that refer to the offending one.
679    
680    ----------------------------------------------------------------------
681    Name: Matthias Blume
682    Date: 2001/07/09 11:25:00 EDT
683    Tag: blume-20010709-varargs
684    Description:
685    
686    1. ckit-lib.cm now exports structure Error
687    2. ml-nlffigen reports occurences of "..." (i.e., varargs function types)
688       with a warning accompanied by a source location.  Moreover, it
689       merely skips the offending function or type and proceeds with the
690       rest of its work.u  As a result, one can safely feed C code containing
691       "..." to ml-nlffigen.
692    3. There are some internal improvements to CM, providing slightly
693       more general string substitutions in the tools subsystem.
694    
695    ----------------------------------------------------------------------
696    Name: Matthias Blume
697    Date: 2001/06/27 15:10:00 EDT
698    Tag: blume-20010627-concur
699    Description:
700    
701    Fixed a small bug in CM's handling of parallel compilation.
702    (You could observe the bug by Control-C-interrupting an ordinary
703    CMB.make or CM.stabilize and then attaching some compile servers.
704    The result was that all of a sudden the previously interrupted
705    compilation would continue on its own.  This was because of
706    an over-optimization: CM did not bother to clean out certain queues
707    when no servers were attached "anyway", resulting in the contents
708    of these queues to grab control when new servers did get attached.)
709    
710    There is also another minor update to the CM manual.
711    
712    ----------------------------------------------------------------------
713    Name: Matthias Blume
714    Date: 2001/06/26 16:15:00 EDT
715    Tag: blume-20010626-cmdoc
716    Description:
717    
718    Minor typo fixed in CM manual (syntax diagram for libraries).
719    
720    ----------------------------------------------------------------------
721    Name: Matthias Blume
722    Date: 2001/06/25 22:55:00 EDT
723    Tag: blume-20010625-x86pc
724    Description:
725    
726    Fixed a nasty bug in the X86 assembly code that caused signal
727    handlers to fail (crash) randomly.
728    
729    ----------------------------------------------------------------------
730    Name: Matthias Blume
731    Date: 2001/06/25 12:05:00 EDT
732    Tag: blume-20010625-nlffigen
733    Description:
734    
735    This update fixes a number of minor bugs in ml-nlffigen as reported by
736    Nick Carter <nbc@andrew.cmu.edu>.
737    
738      1. Silly but ok typedefs of the form "typedef void myvoid;" are now accepted.
739      2. Default names for generated files are now derived from the name of
740         the C file *without its directory*.  In particular, this causes generated
741         files to be placed locally even if the C file is in some system directory.
742      3. Default names for generated signatures and structures are also derived
743         from the C file name without its directory.  This avoids silly things
744         like "structure GL/GL".
745         (Other silly names are still possible because ml-nlffigen does not do
746          a thorough check of whether generated names are legal ML identifiers.
747          When in doubt, use command line arguments to force particular names.)
748    
749    ----------------------------------------------------------------------
750    Name: Matthias Blume
751    Date: 2001/06/21 12:25:00 EDT
752    Tag: blume-20010621-eXene
753    Description:
754    
755    eXene now compiles and (sort of) works again.
756    
757    The library name (for version > 110.33) is $/eXene.cm.
758    
759    I also added an new example in src/eXene/examples/nbody.  See the
760    README file there for details.
761    
762    ----------------------------------------------------------------------
763    Name: Matthias Blume
764    Date: 2001/06/20 16:40:00 EDT
765    Tag: blume-20010620-cml
766    Description:
767    
768    CML now compiles and works again.
769    
770    Libraries (for version > 110.33):
771    
772      $cml/cml.cm            Main CML library.
773      $cml/basis.cm          CML's version of $/basis.cm.
774      $cml/cml-internal.cm   Internal helper library.
775      $cml/core-cml.cm       Internal helper library.
776      $cml-lib/trace-cml.cm  Tracing facility.
777      $cml-lib/smlnj-lib.cm  CML's version of $/smlnj-lib.cm
778    
779    The installer (config/install.sh) has been taught how to properly
780    install this stuff.
781    
782    ----------------------------------------------------------------------
783    Name: Matthias Blume
784    Date: 2001/06/19 17:55:00 EDT
785    Tag: blume-20010619-instantiate
786    Description:
787    
788    This un-breaks the fix for bug 1432.
789    (The bug was originally fixed in 110.9 but I broke it again some
790    time after that.)
791    
792    ----------------------------------------------------------------------
793    Name: Matthias Blume
794    Date: 2001/06/19 17:25:00 EDT
795    Tag: blume-20010619-signals
796    Description:
797    
798    This should (hopefully) fix the long-standing signal handling bug.
799    (The runtime system was constructing a continuation record with an
800    incorrect descriptor which would cause the GC to drop data on the floor...)
801    
802    ----------------------------------------------------------------------
803    Name: Matthias Blume
804    Date: 2001/06/15 15:05:00 EDT
805    Tag: blume-20010615-moresparc
806    Description:
807    
808    Here is a short late-hour update related to Sparc c-calls:
809    
810     -- made handling of double-word arguments a bit smarter
811    
812     -- instruction selection phase tries to collapse certain clumsily
813        constructed ML-Trees; typical example:
814    
815            ADD(ty,ADD(_,e,LI d1),LI d2)  ->  ADD(ty,e,LI(d1+d2))
816    
817        This currently has no further impact on SML/NJ since mlriscGen does
818        not seem to generate such patterns in the first place, and c-calls
819        (which did generate them in the beginning) has meanwhile been fixed
820        so as to avoid them as well.
821    
822    ----------------------------------------------------------------------
823    Name: Matthias Blume
824    Date: 2001/06/15 15:05:00 EDT
825    Tag: blume-20010615-sparc
826    Description:
827    
828    The purpose of this update is to provide an implementation of NLFFI
829    on Sparc machines.
830    
831    Here are the changes in detail:
832    
833       * src/MLRISC/sparc/c-calls/sparc-c-calls.sml is a new file containing
834       the Sparc implementation of the c-calls API.
835       * The Sparc backend of SML/NJ has been modified to uniformely use %fp
836       for accessing the ML frame.  Thus, we have a real frame pointer and
837       can freely modify %sp without need for an omit-frame-ptr phase.
838       The vfp logic in src/compiler/CodeGen/* has been changed to accomodate
839       this case.
840       * ml-nlffigen has been taught to produce code for different architectures
841       and calling conventions.
842       * In a way similar to what was done in the x86 case, the Sparc
843       backend uses its own specific extension to mltree.  (For example,
844       it needs to be able to generate UNIMP instructions which are part
845       of the calling convention.)
846       * ml-nlffi-lib was reorganized to make it more modular (in particular,
847       to make it easier to plug in new machine- and os-dependent parts).
848    
849    There are some other fairly unrelated bug fixes and cleanups as well:
850    
851       * I further hacked the .cm files for MLRISC tools (like MDLGen) so
852       that they properly share their libraries with existing SML/NJ libraries.
853       * I fixed a minor cosmetic bug in CM, supressing certain spurious
854       follow-up error messages.
855       * Updates to CM/CMB documentation.
856    
857    TODO items:
858    
859       * MLRISC should use a different register as its asmTemp on the Sparc.
860         (The current %o2 is a really bad choice because it is part of the
861         calling conventions, so things might interfere in unexpected ways.)
862    
863    ----------------------------------------------------------------------
864    Name: Matthias Blume
865    Date: 2001/06/07
866    Tag: blume-20010607-calls
867    Description:
868    
869    A number of internal changes related to C calls and calling conventions:
870    
871    1. ML-Tree CALL statements now carry a "pops" field.  It indicates the
872       number of bytes popped implicitly (by the callee).  In most cases
873       this field is 0 but on x86/win32 it is some non-zero value.  This
874       is information provided for the benefit of the "omit-frameptr" pass.
875    2. The CALL instruction on the x86 carries a similar "pops" field.
876       The instruction selection phase copies its value from the ML-Tree
877       CALL statement.
878    3. On all other architectures, the instruction selection phase checks
879       whether "pops=0" and complains if not.
880    4. The c-calls implementation for x86 now accepts two calling conventions:
881       "ccall" and "stdcall".  When "ccall" is selected, the caller cleans
882       up after the call and pops is set to 0.  For "stdcall", the caller
883       does nothing, leaving the cleanup to the callee; pops is set to
884       the number of bytes that were pushed onto the stack.
885    5. The cproto decoder (compiler/Semant/types/cproto.sml) now can
886       distinguish between "ccall" and "stdcall".
887    6. The UNIMP instruction has been added to the supported Sparc instruction
888       set. (This is needed for implementing the official C calling convention
889       on this architecture.)
890    7. I fixed some of the .cm files under src/MLRISC/Tools to make them
891       work with the latest CM.
892    
893    ----------------------------------------------------------------------
894    Name: Matthias Blume
895    Date: 2001/06/05 15:10:00 EDT
896    Tag: blume-20010605-cm-index
897    Description:
898    
899    0. The "lambdasplit" parameter for class "sml" in CM has been documented.
900    
901    1. CM can now generate "index files".  These are human-readable files
902       that list on a per-.cm-file basis each toplevel symbol defined or
903       imported.  The location of the index file for
904       <p>/<d>.cm is <p>/CM/INDEX/<d>.cm.
905       To enable index-file generation, set CM.Control.generate_index to true
906       or export an environment-symbol: export CM_GENERATE_INDEX=true.
907    
908       The CM manual has been updated accordingly.
909    
910    2. I made some slight modifications to the c-calls API in MLRISC.
911    
912         a) There is now a callback to support saving/restoring of
913            dedicated but caller-save registers around the actual call
914            instruction.
915         b) One can optionally specify a comment-annotation for the
916            call instruction.
917    
918    3. SML/NJ (mlriscGen.sml) uses this new API for the rawccall primop.
919       (For example, the comment annotation shows the C prototype of
920        the function being called.)
921    
922    ----------------------------------------------------------------------
923    Name: Matthias Blume
924    Date: 2001/06/01 13:30:00 EDT
925    Tag: blume-20010601-nlffi-cleanup
926    Description:
927    
928    This is mostly a cleanup of MLFFI stuff:
929    
930       - some signature files have been put into a more exposed place
931       - the ugly 'f type parameter is gone (simplifies types tremendously!)
932       - ml-nlffigen changed accordingly
933       - tutorial updated
934    
935    Other changes:
936    
937       - author's affiliation in CM manual(s) updated
938       - some more recognized keywords added to Allen's sml.sty
939    
940    ----------------------------------------------------------------------
941    Name: Matthias Blume
942    Date: 2001/05/25 15:30:00 EDT
943    Tag: blume-20010525-iptr
944    Description:
945    
946      - put the official 110.33-README (as it appears on the ftp server) under
947        CVS
948      - fixed a small bug related to incomplete pointer types in
949        ml-nlffigen
950      - small cosmetic change to the ml-nlffi-lib's "arr" type constructor
951        (it does not need the 'f type parameter)
952    
953    ----------------------------------------------------------------------
954    Name: Matthias Blume
955    Date: 2001/05/23 14:30:00 EDT
956    Tag: Release_110_33
957    Description:
958    
959    New version number (110.33).  New bootfiles.
960    
961    ----------------------------------------------------------------------
962    Name: Matthias Blume
963    Date: 2001/05/22 18:06:00 EDT
964    Tag: blume-20010522-targets
965    Description:
966    
967    Made install.sh use file config/targets.customized if it exists, falling
968    back to config/targets if it doesn't.  This way one can have a customized
969    version of the targets file without touching the "real thing", thus
970    eliminating the constant fear of accidentally checking something bogus
971    back into the CVS repository...  (File config/targets.customized must
972    not be added to the repository!)
973    
974    ----------------------------------------------------------------------
975    Name: Matthias Blume
976    Date: 2001/05/22 16:30:00 EDT
977    Tag: blume-20010522-minitut
978    Description:
979    
980    1. Bug fix in ml-nlffigen; now (hopefully) correctly handling
981       struct returns.
982    2. Added src/ml-nlffi-lib/Doc/mini-tutorial.txt.  This is some very
983       incomplete, preliminary documentation for NLFFI.
984    
985    ----------------------------------------------------------------------
986    Name: Matthias Blume
987    Date: 2001/05/14 11:30:00 EDT
988    Tag: blume-20010514-script
989    Description:
990    
991    Some bugs in install script fixed.
992    
993    In addition to that I also made a slight change to the NLFFI API:
994    Functors generated by ml-nlffigen now take the dynamic library as a
995    straight functor argument, not as a suspended one.  (The original
996    functor code used to force the suspension right away anyway, so there
997    was nothing gained by this complication of the interface.)
998    
999    ----------------------------------------------------------------------
1000    Name: Matthias Blume
1001    Date: 2001/05/11 14:35:00 EDT
1002    Tag: blume-20010511-ml-nlffi
1003    Description:
1004    
1005    I finally took the plunge and added my new FFI code to the main
1006    repository.  For x86-linux it is now ready for prime-time.
1007    
1008    There are two new subdirectories of "src":
1009    
1010      - ml-nlffi-lib:
1011           The utility library for programs using the FFI interface.
1012           Here is the implementation of $/c.cm and its associated low-level
1013           partners $/c-int.cm and $/memory.cm.
1014      - ml-nlffigen:
1015           A stand-alone program for generating ML glue code from C source
1016           code.
1017    
1018    Building ml-nlffigen requires $/ckit-lib.cm.
1019    
1020    The config/install.sh script has been updates to do the Right Thing
1021    (hopefully).
1022    
1023    Notice that the source tree for the C-Kit will not be put under "src"
1024    but directly under the installation root directory.  (This is the
1025    structure that currently exists on the CVS server when you check out
1026    module "sml".)  Fortunately, config/install.sh knows about this oddity.
1027    
1028    Bugs: No documentation yet.
1029    
1030    ----------------------------------------------------------------------
1031    Name: Matthias Blume
1032    Date: 2001/05/09 16:35:00 EDT
1033    Tag: blume-20010509-cpscontract
1034    Description:
1035    
1036    Fixed a bug in the accounting code in cpsopt/contract.sml.  (The
1037    wrapper/unwrapper elimination did not decrement usage counts and some
1038    dead variables got overlooked by the dead-up logic.)
1039    
1040    ----------------------------------------------------------------------
1041    Name: Lal George
1042    Date: 2001/05/08  17:26:09 EDT
1043    Tag: george-20010508-omit-frameptr
1044    Description:
1045    
1046    Changes to implement the omit-frame-pointer optimization to support
1047    raw C calls. For now, there is only support on the Intel x86, but
1048    other architectures will follow as more experience is gained with this.
1049    
1050    
1051    ----------------------------------------------------------------------
1052    Name: Matthias Blume
1053    Date: 2001/05/07 14:40:00 EDT
1054    Tag: blume-20010507-proxies
1055    Description:
1056    
1057    I made into "proxy libraries" all libraries that qualify for such a
1058    change.  (A qualifying library is a library that has another library or
1059    groups as its sole member and repeats that member's export list
1060    verbatim.  A proxy library avoids this repetition by omitting its export
1061    list, effectively inheriting the list that its (only) member exports.
1062    See the CM manual for more explanation.)
1063    The main effect is that explicit export lists for these libraries
1064    do not have to be kepts in sync, making maintenance a bit easier.
1065    
1066    I also added copyright notices to many .cm-files.
1067    
1068    Last but not least, I made a new set of bootfiles.
1069    
1070    ----------------------------------------------------------------------
1071    Name: Matthias Blume
1072    Date: 2001/05/04 17:00:00 EDT
1073    Tag: blume-20010504-cm-lsplit
1074    Description:
1075    
1076    0. John merged pending changes to $/smlnj-lib.cm
1077    
1078    1. Allen's previous change accidentally backed out of one of Lal's
1079       earlier changes.  I undid this mistake (re-introducing Lal's change).
1080    
1081    2. I used the new topOrder' function from graph-scc.sml (from $/smlnj-lib.cm)
1082       within the compiler where applicable.  There is some code simplification
1083       because of that.
1084    
1085    3. The "split" phase (in FLINT) is now part of the default list of phases.
1086       Compiler.Control.LambdaSplitting.* can be used to globally control the
1087       lambda-splitting (cross-module-inlining) engine.  In addition to that,
1088       it can now also be controlled on a per-source basis: CM has been taught
1089       a new tool parameter applicable to ML source files.
1090    
1091       - To turn lambda-splitting off completely:
1092            local open Compiler.Control.LambdaSplitting in
1093                val _ = set Off
1094            end
1095       - To make "no lambda-splitting" the global default (but allow per-source
1096         overriding); this is the initial setting:
1097            local open Compiler.Control.LambdaSplitting in
1098                val _ = set (Default NONE)
1099            end
1100       - To make "lambda-splitting with aggressiveness a" the global default
1101         (and allow per-source overriding):
1102            local open Compiler.Control.LambdaSplitting in
1103                val _ = set (Default (SOME a))
1104            end
1105    
1106       - To turn lambda-splitting off for a given ML souce file (say: a.sml)
1107         write (in the respective .cm-file):
1108            a.sml (lambdasplitting:off)
1109       - To turn lambda-splitting for a.sml on with minimal aggressiveness:
1110            a.sml (lambdasplitting:on)
1111       - To turn lambda-splitting for a.sml on with aggressiveness <a> (where
1112         <a> is a decimal non-negative integer):
1113            a.sml (lambdasplitting:<a>)
1114       - To turn lambda-splitting for a.sml on with maximal aggressiveness:
1115            a.sml (lambdasplitting:infinity)
1116       - To use the global default for a.sml:
1117            a.sml (lambdasplitting:default)
1118         or simply
1119            a.sml
1120    
1121    ----------------------------------------------------------------------
1122    Name: Allen Leung
1123    Date: 2001/05/04 01:57:00 EDT
1124    Tag: leunga-20010504-sync
1125    Description:
1126    
1127      MLRISC features.
1128    
1129      1. Fix to CMPXCHG instructions.
1130      2. Changed RA interface to allow annotations in callbacks.
1131      3. Added a new method to the stream interface to allow annotations updates.
1132    
1133    ----------------------------------------------------------------------
1134    Name: Matthias Blume
1135    Date: 2001/05/01 11:45:00 EDT
1136    Tag: blume-20010501-pcedittmp
1137    Description:
1138    
1139    Changed install.sh to use the current working directory instead of
1140    /usr/tmp for a temporary file (pcedittmp).  The previous choice
1141    of /usr/tmp caused trouble with MacOS X because of file premission
1142    problems.
1143    
1144    ----------------------------------------------------------------------
1145    Name: Matthias Blume
1146    Date: 2001/04/20 11:10:00 EDT
1147    Tag: blume-20010420-inMLflag
1148    Description:
1149    
1150     - added vp_limitPtrMask to vproc-state.h
1151       (for use by the raw-C-calls mechanism to implement proper interrupt
1152        handling)
1153     - made the ML compiler aware of various data-structure offsets so it
1154       can generate code for accessing the vp_inML flag and vp_limitPtrMask
1155     - tweaked mlriscGen.sml to have it emit interrupt-handling code for
1156       raw C-calls
1157    
1158    ----------------------------------------------------------------------
1159    Name: Lal George
1160    Date: 2001/04/20 09:15:28 EDT
1161    Tag: george-20010420-macosX
1162    Description:
1163    
1164     - Changes to port to Mac OS X; Darwin.
1165    
1166     - In the process I found that sqrt was broken on the PPC, because the
1167       fsqrt instruction is not implemented.
1168    
1169    ----------------------------------------------------------------------
1170    Name: Matthias Blume
1171    Date: 2001/04/18 12:45:00 EDT
1172    Tag: blume-20010418-ccalls
1173    Description:
1174    
1175     - fixed two off-by-4 errors in the x86-specific c-calls implementation
1176       (this bug prevented structure arguments containing pointers from being
1177        passed correctly)
1178     - changed the raw-C-call code in mlriscGen.sml in such a way that
1179       structure arguments are represented as a pointer to the beginning
1180       of the structure (instead of having a series of synthesized arguments,
1181       one for each structure member)
1182    
1183     - made makeml script's verbosity level configurable via environment
1184       variable (MAKEML_VERBOSITY)
1185    
1186     - eliminated placeholder implementations for f32l, w16s, i16s, and f32s
1187       in rawmem-x86.sml; we are now using the real thing
1188    
1189    ----------------------------------------------------------------------
1190    Name: Matthias Blume
1191    Date: 2001/03/22 16:25:00 EST
1192    Tag: blume-20010322-bootfiles
1193    Description:
1194    
1195    Created a new set of bootfiles (for your automatic installation convenience).
1196    
1197    ----------------------------------------------------------------------
1198    Name: Matthias Blume
1199    Date: 2001/03/22 15:10:00 EST
1200    Tag: blume-20010322-rawmem-parcm
1201    Description:
1202    
1203    1. All "raw memory access" primitives for the new FFI are implemented now
1204       (at least on the x86).
1205    2. Some further cleanup of CM's parallel make mechanism.
1206    
1207    ----------------------------------------------------------------------
1208    Name: Matthias Blume
1209    Date: 2001/03/19 17:53:00 EST
1210    Tag: blume-20010319-parallel
1211    Description:
1212    
1213    Parallel make (using compile servers) now works again.
1214    
1215    To this end, CM.stabilize and CMB.make have been modified to work in
1216    two passes when compile servers are attached:
1217       1. Compile everything, do not perform stabilization; this pass
1218          uses compile servers
1219       2. Stabilize everything; this pass does not use compile servers
1220    If there are no compile servers, the two passes are combined into one
1221    (as before).  Splitting the passes increases the inherent parallelism
1222    in the dependency graph because the entire graph including all
1223    libraries is available at the same time.  This, in turn, improves
1224    server utilization.  The downside is that the master process will
1225    have to do some extra work after compilation is done (because for
1226    technical reasons it must re-read all the binfiles during stabilization).
1227    
1228    ----------------------------------------------------------------------
1229    Name: Matthias Blume
1230    Date: 2001/03/16 12:22:00 EST
1231    Tag: blume-20010316-bootfiles
1232    Description:
1233    
1234    Created a new set of bootfiles (for your automatic installation convenience).
1235    
1236    ----------------------------------------------------------------------
1237    Name: Matthias Blume
1238    Date: 2001/03/16 11:00:00 EST
1239    Tag: blume-20010316-MLTREE-fixup
1240    Description:
1241    
1242    This is a minor fixup for an (untagged) earlier commit by Allen.
1243    (A file was missing).
1244    
1245    ----------------------------------------------------------------------
1246    Name: Allen Leung
1247    Date: Mon Mar  5 18:54:57 EST 2001
1248    Tag: leunga-20010305-cut-support
1249    
1250    1. New support for alternative control-flow in MLTREE.
1251       Currently we support
1252    
1253          FLOW_TO(CALL ...., [k1,...,kn])
1254    
1255       This is needed for 'cuts to' in C-- and try/handle-like constructs
1256       in Moby
1257    
1258       New assembler flag "asm-show-cutsto" to turn on control-flow debugging.
1259    
1260    2. Register Allocator
1261    
1262       Changes in interface [from Fermin, John]
1263    
1264    3. Alpha 8-bit SLL support [Fermin]
1265    
1266    4. All architectures
1267    
1268       A new module (ClusterExpandCopies) for expanding parallel copies.
1269    
1270    ----------------------------------------------------------------------
1271    Name: Allen Leung
1272    Date: 2001/02/27 23:07:00 EST
1273    Tag: leunga-20010227-minor-stuff
1274    
1275    1. Alpha bug fix for CMOVNE
1276    2. Handle mltree COND(..,FCMP ...,...)
1277    3. Bug fix in simplifier
1278    
1279    ----------------------------------------------------------------------
1280    Name: Matthias Blume
1281    Date: 2001/01/30 17:50:00 EST
1282    Tag: blume-20010130-sync
1283    Description:
1284    
1285    This is just a minor update to sync my devel branch with the main brach.
1286    The only visible change is the addition of some README files.
1287    
1288    ----------------------------------------------------------------------
1289    Name: Matthias Blume
1290    Date: 2001/01/12 23:30:00 JST
1291    Tag: blume-20010112-bootfiles
1292    Description:
1293    
1294    Made a new set of bootfiles that goes with the current state of the
1295    repository.
1296    
1297    ----------------------------------------------------------------------
1298    Name: Matthias Blume
1299    Date: 2001/01/12 21:20:00 JST
1300    Tag: blume-20010112-sync
1301    Description:
1302    
1303    I am just flushing out some minor changes that had accumulated in
1304    my private branch in order to sync with the main tree.  (This is
1305    mainly because I had CVS trouble when trying to merge _into_ my
1306    private branch.)
1307    
1308    Most people should be completely unaffected by this.
1309    
1310    ----------------------------------------------------------------------
1311    Name: Allen Leung
1312    Date: Thu Jan 11 21:03:00 EST 2001
1313    Tag: leunga-20010111-labexp=mltree
1314    Description:
1315    
1316    1.  Removed the type LabelExp and replace it by MLTree.
1317    2.  Rewritten mltree-simplify with the pattern matcher tool.
1318    3.  There were some bugs in alpha code generator which would break
1319        64-bit code generation.
1320    4.  Redo the tools to generate code with the
1321    5.  The CM files in MLRISC (and in src/system/smlnj/MLRISC)
1322        are now generated by perl scripts.
1323    
1324    ----------------------------------------------------------------------
1325    Name: Matthias Blume
1326    Date: 2001/01/10 21:55:00 JST
1327    Tag: blume-20010110-rcc
1328    Description:
1329    
1330    The RCC stuff now seems to work (but only on the x86).
1331    This required hacking of the c-calls interface (and -implementation) in
1332    MLRISC.
1333    
1334    Normal compiler users should be unaffected.
1335    
1336    ----------------------------------------------------------------------
1337    Name: Matthias Blume
1338    Date: 2001/01/09 01:20:00 JST
1339    Tag: blume-20010109-rcc
1340    Description:
1341    
1342    This is a fairly big patch, flushing out a large number of pending
1343    changes that I made to my development copy over the last couple of days.
1344    
1345    Of practical relevance at this moment is a workaround for a pickling
1346    bug that Allen ran into the other day.  The cause of the bug itself is
1347    still unknown and it might be hard to fix it properly, but the
1348    workaround has some merits of its own (namely somewhat reducing pickling
1349    overhead for certain libraries).  Therefore, I think this solution should
1350    be satisfactory at this time.
1351    
1352    The rest of the changes (i.e., the vast majority) has to do with my
1353    ongoing efforts of providing direct support for C function calls from
1354    ML.  At the moment there is a new primop "RAW_CCALL", typing magic
1355    in types/cproto.sml (invoked from FLINT/trans/translate.sml), a new
1356    case in the FLINT CPS datatype (RCC), changes to cps/convert.sml to
1357    translate uses of RAW_CCALL into RCC, and changes to mlriscGen.sml to
1358    handle RCC.
1359    
1360    The last part (the changes to mlriscGen.sml) are still known to be
1361    wrong on the x86 and not implemented on all other architectures.  But
1362    the infrastructure is in place. I had to change a few functor
1363    signatures in the backend to be able to route the CCalls interface
1364    from MLRISC there, and I had to specialize the mltree type (on the
1365    x86) to include the necessary extensions. (The extensions themselves
1366    were already there and redy to go in MLRISC/x86).
1367    
1368    Everything should be very happy as soon as someone helps me with
1369    mlriscGen.sml...
1370    
1371    In any case, nothing of this should matter to anyone as long as the
1372    new primop is not being used (which is going to be the case unless you
1373    find it where I hid it :). The rest of the compiler is completely
1374    unaffected.
1375    
1376    ----------------------------------------------------------------------
1377    Name: Matthias Blume
1378    Date: 2001/01/05 00:30:00 JST
1379    Tag: blume-20010105-primops
1380    Description:
1381    
1382    Added some experimental support for work that I am doing right now.
1383    These changes mostly concern added primops, but there is also a new
1384    experimental C library in the runtime system (but currently not enabled
1385    anywhere except on Linux/X86).
1386    
1387    In the course of adding primops (and playing with them), I discovered that
1388    Zhong's INL_PRIM hack (no type info for certain primops) was, in fact, badly
1389    broken.  (Zhong was very right he labeled this stuff as "major gross hack".)
1390    To recover, I made type information in INL_PRIM mandatory and changed
1391    prim.sml as well as built-in.sml accordingly.  The InLine structure now
1392    has complete, correct type information (i.e., no bottom types).
1393    
1394    Since all these changes mean that we need new binfiles, I also bumped the
1395    version number to 110.32.1.
1396    
1397    ----------------------------------------------------------------------
1398    Name: Matthias Blume
1399    Date: 2000/12/30 22:10:00 JST
1400    Tag: blume-20001230-various
1401    Description:
1402    
1403    Added proxy libraries for MLRISC and let MLRISC libraries refer
1404    to each other using path anchors.  (See CM manual for explanation.)
1405    
1406    Updated CM documentation.
1407    
1408    Fixed some bugs in CM.
1409    
1410    Implemented "proxy" libraries (= syntactic sugar for CM).
1411    
1412    Added "-quiet" option to makeml and changed runtime system accordingly.
1413    
1414    Added cleanup handler for exportML to reset timers and compiler stats.
1415    
1416    ----------------------------------------------------------------------
1417    Name: Lal George
1418    Date: 2000/12/22 22:22:58 EST 2000
1419    Tag: Release_110_32
1420    Description:
1421    
1422            Infinite precision used throughout MLRISC.
1423            see MLRISC/mltree/machine-int.sig
1424    
1425    ----------------------------------------------------------------------
1426    Name: Matthias Blume
1427    Date: 2000/12/22 23:16:00 JST
1428    Tag: blume-20001222-warn
1429    Description:
1430    
1431    Corrected wording and formatting of some CM warning message which I
1432    broke in my previous patch.
1433    
1434    ----------------------------------------------------------------------
1435    Name: Matthias Blume
1436    Date: 2000/12/22 21:20:00 JST
1437    Tag: blume-20001222-anchorenv
1438    Description:
1439    
1440    Fixed CM's handling of anchor environments in connection with CMB.make.
1441    
1442    ----------------------------------------------------------------------
1443    Name: Matthias Blume
1444    Date: 2000/12/22 13:15:00 JST
1445    Tag: blume-20001222-cleanup
1446    Description:
1447    
1448    Removed src/cm/ffi which does not (and did not) belong here.
1449    
1450    ----------------------------------------------------------------------
1451    Name: Matthias Blume
1452    Date: 2000/12/21 23:55:00 JST
1453    Tag: blume-20001221-exn
1454    Description:
1455    
1456    Probably most important: CM no longer silently swallows all exceptions
1457    in the compiler.
1458    Plus: some other minor CM changes.  For example, CM now reports some
1459    sizes for generated binfiles (code, data, envpickle, lambdapickle).
1460    
1461    ----------------------------------------------------------------------
1462    Name: Matthias Blume
1463    Date: 2000/12/15 00:01:05 JST
1464    Tag: blume-20001215-dirtool
1465    Description:
1466    
1467    - "dir" tool added.
1468    - improvements and cleanup to Tools structure
1469    - documentation updates
1470    
1471    ----------------------------------------------------------------------
1472    Name: Allen Leung
1473    Date: Thu Dec 14 03:45:24 EST 2000
1474    Description:
1475    Tag:  leunga-20001214-int-inf
1476    Description:
1477    
1478       In IntInf, added these standard functions, which are missing from our
1479    implementation:
1480    
1481        andb : int * int -> int
1482        xorb : int * int -> int
1483        orb  : int * int -> int
1484        notb : int -> int
1485         <<   : int * word -> int
1486        ~>>  : int * word -> int
1487    
1488       Not tested, I hope they are correct.
1489    
1490    ----------------------------------------------------------------------
1491    Name: Allen Leung
1492    Date: Fri Dec  8 19:23:26 EST 2000
1493    Description:
1494    Tag:  leunga-20001208-nowhere
1495    Description:
1496    
1497      Slight improvements to the 'nowhere' tool to handle OR-patterns,
1498    to generate better error messages etc.  Plus a brief manual.
1499    
1500    ----------------------------------------------------------------------
1501    Name: Lal George
1502    Date: 2000/12/08 09:54:02 EST 2000
1503    Tag: Release_110_31
1504    Description:
1505    
1506    - Version 110.31
1507    ----------------------------------------------------------------------
1508    Name: Allen Leung
1509    Date: Thu Dec  7 22:01:04 EST 2000
1510    Tag:  leunga-20001207-cell-monster-hack
1511    Description:
1512    
1513    Major MLRISC internal changes.  Affect all clients.
1514    Summary:
1515    
1516    1.  Type CELLS.cell = int is now replaced by a datatype.
1517        As a result, the old regmap is now gone.  Almost all interfaces
1518        in MLRISC change as a consequence.
1519    
1520    2.  A new brand version of machine description tool (v3.0) that generates
1521        modules expecting the new interface.  The old version is removed.
1522    
1523    3.  The RA interface has been further abstracted into two new functors.
1524        RISC_RA and X86RA.  These functors have much simpler interfaces.
1525        [See also directory MLRISC/demo.]
1526    
1527    4.  Some other new source->source code generation tools are available:
1528    
1529        a. MLRISC/Tools/RewriteGen -- generate rewriters from rules.
1530        b. MLRISC/Tools/WhereGen -- expands conditional pattern matching rules.
1531           I use this tool to generate the peephole optimizers---with the new
1532           cell type changes, peephole rules are becoming difficult to write
1533           without conditional pattern matching.
1534    
1535    5.  More Intmap -> IntHashTable change.  Previous changes by Matthias didn't
1536        cover the entire MLRISC source tree so many things broke.
1537    
1538    6.  CM files have been moved to the subdirectory MLRISC/cm.
1539        They are moved because there are a lot of them and they clutter up the
1540        root dir.
1541    
1542    7.  More detailed documentation to come...
1543    
1544        NOTE: To rebuild from 110.30 (ftp distribution), you'll have to do
1545        a makeml -rebuild first.  This is because of other other
1546        changes that Matthias has made (see below).
1547    
1548    
1549    ----------------------------------------------------------------------
1550    Name: Matthias Blume
1551    Date: 2000/11/30 23:12:00 JST
1552    Tag: blume-20001130-filereorg
1553    Description:
1554    
1555    Some manual updates and some file reorganizations in CM.
1556    
1557    ----------------------------------------------------------------------
1558    Name: Matthias Blume
1559    Date: 2000/11/24 17:45:00 JST
1560    Tag: blume-20001124-link
1561    Description:
1562    
1563    Drastically improved link traversal code for the case that the dynamic
1564    value was already loaded at bootstrap time.  As a result, CM and CMB
1565    now both load blazingly fast -- even on a very slow machine.  Also,
1566    memory consumption has been further reduced by this.
1567    
1568    Warning: The format of the PIDMAP file has changed.  THerefore, to
1569    bootstrap you have to do this:
1570    
1571    1. Run CMB.make
1572    2. Make a symbolic link for the boot directory:
1573         ln -s sml.boot.ARCH-OS xxx
1574    3. "Rebuild" the boot directory:
1575         ./makeml -boot xxx -rebuild sml ; rm xxx
1576    4. Boot normally:
1577          ./makeml
1578    
1579    ----------------------------------------------------------------------
1580    Name: Matthias Blume
1581    Date: 2000/11/21 21:20:00 JST
1582    Tag: blume-20001121-tools
1583    Description:
1584    
1585    Continued hacking on autoloading problem -- with success this time.
1586    Also changed tool-plugin mechanism.  See new CM manual.
1587    
1588    ----------------------------------------------------------------------
1589    Name: Matthias Blume
1590    Date: 2000/11/19 14:30:00 JST
1591    Tag:  blume-20001119-autoload
1592    Description:
1593    
1594    Some hacking to make autoloading faster.  Success for CMB, no success
1595    so far for CM.  There is a reduced structure CM' that autoloads faster.
1596    (This is a temporary, non-documented hack to be eliminated again when
1597    the general problem is solved.)
1598    
1599    ----------------------------------------------------------------------
1600    Name: Matthias Blume
1601    Date: 2000/11/17 14:10:00 JST
1602    Tag: blume-20001117-pickle-lib
1603    Description:
1604    
1605    1. Eliminated comp-lib.cm
1606    2. Made pickle-lib.cm
1607    3. Eliminated all uses of intset.sml (from comp-lib.cm)
1608    4. Replaced all uses of intmap.{sig,sml} (from comp-lib.cm) with
1609       equivalent constructs from smlnj-lib.cm (INtHashTable).
1610    5. Point 4. also goes for those uses of intmap.* in MLRISC.
1611       Duplicated intmap modules thrown out.
1612    6. Hunted down all duplicated SCC code and replaced it with
1613       equivalent stuff (GraphSCCFn from smlnj-lib.cm).
1614    7. Rewrote Feedback module.
1615    8. Moved sortedlist.sml into viscomp-lib.cm.  Eventually it
1616       should be thrown out and equivalent modules from smlnj-lib.cm
1617       should be used (IntRedBlackSet, IntListSet, ...).
1618    
1619    Confirmed that compiler compiles to fixpoint.
1620    
1621    ----------------------------------------------------------------------
1622    Name: Allen Leung
1623    Date: 2000/11/10 18:00:00
1624    Tag: leunga-20001110-new-x86-fp
1625    
1626    A new x86 floating point code generator has been added.
1627    By default this is turned off.  To turn this on, do:
1628    
1629        CM.autoload "$smlnj/compiler.cm";
1630        Compiler.Control.MLRISC.getFlag "x86-fast-fp" := true;
1631    
1632    Changes:
1633    
1634    1.  Changed FTAN to FPTAN so that the assembly output is correct.
1635    2.  Changed the extension callback for FTANGENT to generate:
1636    
1637              fptan
1638              fstp  %st(0)
1639        instead of
1640              fptan
1641              fstpl ftempmem
1642    
1643    3.  Numerous assembly fixes for x86.
1644    
1645    5.  Cleaned up the machine code output module x86/x86MC.sml and added
1646        support for a whole bunch of instructions and addressing modes:
1647    
1648          fadd/fsub/fsubr/fmul/fdiv/fdivr  %st, %st(n)
1649          faddp/fsubp/fsubrp/fmulp/fdivp/fdivrp  %st, %st(n)
1650          fadd/fsub/fsubr/fmul/fdiv/fdivr  %st(n), %st
1651          fiadd/fisub/fisubr/fimul/fidiv/fidivr mem
1652          fxch %st(n)
1653          fld %st(n)
1654          fst %st(n)
1655          fst mem
1656          fstp %st(n)
1657          fucom %st(n)
1658          fucomp %st(n)
1659    
1660        All these are now generated when the fast fp mode is turned on.
1661    
1662    6.  Removed the dedicated registers %st(0), ..., %st(7) from X86CpsRegs
1663    
1664    ----------------------------------------------------------------------
1665    Name: Matthias Blume
1666    Date: 2000/11/09 11:20:00 JST
1667    Tag: blume-20001109-scc
1668    Description:
1669    
1670    Eliminated some code duplication:
1671    
1672    1. Added "where" clause to GraphSCCFn in SML/NJ Library.
1673       (Otherwise the functor is useless.)
1674    2. Used GraphSCCFn where SCCUtilFun was used previously.
1675    3. Got rid of SCCUtilFun (in comp-lib.cm).
1676    
1677    ----------------------------------------------------------------------
1678    Name: Lal George
1679    Date: 2000/11/06 09:02:21 EST 2000
1680    Tag: Release_110_30
1681    Description:
1682    
1683    - Version 110.30
1684    ----------------------------------------------------------------------
1685    Name: Matthias Blume
1686    Date: 2000/11/04 14:45:00
1687    Tag: blume-20001104-mlbuild
1688    Description:
1689    
1690    - Made ml-build faster on startup.
1691    - Documentation fixes.
1692    
1693    ----------------------------------------------------------------------
1694    Name: Matthias Blume
1695    Date: 2000/11/02 17:00:00 JST
1696    Tag: blume-20001102-condcomp
1697    Description:
1698    
1699    - Small tweaks to pickler -- new BOOTFILES!
1700    - Version bumped to 110.29.2.
1701    - Added conditional compilation facility to init.cmi (see comment there).
1702    ----------------------------------------------------------------------
1703    Name: Allen Leung
1704    Date: 2000/10/23 19:31:00
1705    Tag: leunga-20001023-demo-ra
1706    
1707    1. Minor RA changes that improves spilling on x86 (affects Moby and C-- only)
1708    2. Test programs for the graph library updated
1709    3. Some new MLRISC demo programs added
1710    
1711    ----------------------------------------------------------------------
1712    Name: Matthias Blume
1713    Date: 2000/08/31 22:15:00 JST
1714    Tag: blume-20001017-errmsg
1715    Description:
1716    
1717    More error message grief: Where there used to be no messages, there
1718    now were some that had bogus error regions.  Fixed.
1719    
1720    ----------------------------------------------------------------------
1721    Name: Matthias Blume
1722    Date: 2000/08/31 17:30:00 JST
1723    Tag: blume-20001017-v110p29p1
1724    Description:
1725    
1726    I made a version 110.29.1 with new bootfiles.
1727    
1728    Changes:  Modified pickler/unpickler for faster and leaner unpickling.
1729              CM documentation changes and a small bugfix in CM's error reporting.
1730    
1731    ----------------------------------------------------------------------
1732    Name: Lal George
1733    Date: 2000/09/27 14:42:35 EDT
1734    Tag: george-20000927-nodestatus
1735    Description:
1736    
1737    Changed the type of the nodestatus, so that:
1738    
1739            SPILLED(~1)             is now SPILLED
1740            SPILLED(m) where m>=0   is now MEMREG(m)
1741            SPILLED(s) where s<~1   is now SPILL_LOC(~s)
1742    
1743    ----------------------------------------------------------------------
1744    Name: Matthias Blume
1745    Date: 2000/09/07 14:45:00 JST
1746    Tag: blume-20000907-cmerrmsg
1747    Description:
1748    
1749    Small tweak to CM to avoid getting ML syntax error messages twice.
1750    
1751    ----------------------------------------------------------------------
1752    Name: Matthias Blume
1753    Date: 2000/08/31 18:00:00 JST
1754    Tag: blume-20000831-cvsbootfiles
1755    Description:
1756    
1757    New URL for boot files (because the 110.29 files on the BL server do
1758    now work correctly with my updated install scripts for yacc and lex).
1759    
1760    ----------------------------------------------------------------------
1761    Name: Matthias Blume
1762    Date: 2000/08/08 12:33:00 JST
1763    Tag: blume-20000808-manual
1764    Description:
1765    
1766    Tiny update to CM manual.
1767    
1768    ----------------------------------------------------------------------
1769    Name: Allen Leung
1770    Date: 2000/08/7 19:31:00
1771    Tag: leunga-20000807-a-whole-bunch-of-stuff
1772    
1773      Moby, C--, SSA, x86, machine descriptions etc.  Should only affect C--
1774    and Mobdy.
1775    
1776    1.  x86
1777    
1778       a.  Fixes to peephole module by John and Dan.
1779       b.  Assembly fix to SETcc by Allen.
1780       c.  Fix to c-call by John.
1781       d.  Fix to spilling by John.  (This one deals with the missing FSTPT case)
1782       e.  Instruction selection optimization to SETcc as suggested by John.
1783    
1784           For example,
1785    
1786            MV(32, x, COND(32, CMP(32, LT, a, b), LI 1, LI 0))
1787    
1788           should generate:
1789    
1790            MOVL a, x
1791            SUBL b, x
1792            SHRL 31, x
1793    
1794    2.  IR stuff
1795    
1796         A bunch of new DJ-graph related algorithms added.  These
1797         speed up SSA construction.
1798    
1799    3.  SSA + Scheduling
1800    
1801         Added code for SSA and scheduling to the repository
1802    
1803    ----------------------------------------------------------------------
1804    Name: Lal George
1805    Date: 2000/07/27 11:53:14 EDT
1806    
1807    Tag: lal-20000727-linux-ppc
1808    Description:
1809    
1810     Made changes to support Linux PPC.
1811     p.s. I have confirmation that the 110.29 boot files work fine.
1812    
1813    ----------------------------------------------------------------------
1814    Name: Matthias Blume
1815    Date: 2000/07/27 17:40:00 JST
1816    Tag: blume-20000727-scripts
1817    Description:
1818    
1819    !!!! WARNING !!!!
1820    You must recompile the runtime system!
1821    !!!! WARNING !!!!
1822    
1823    This is basically another round of script-enhancements:
1824    
1825    1. sml, ml-build, and ml-makedepend accept options -D and -U to define
1826       and undefine CM preprocessor symbols.
1827    
1828    2. ml-build avoids generating a new heap image if it finds that the
1829       existing one is still ok.  (The condition is that no ML file had to
1830       be recompiled and all ML files are found to be older that the heap
1831       file.)
1832    
1833       To make this work smoothly, I also hacked the runtime system as
1834       well as SMLofNJ.SysInfo to get access to the heap image suffix
1835       (.sparc-solaris, ...) that is currently being used.
1836    
1837       Moreover, the signature of CM.mk_standalone has changed.  See the
1838       CM manual.
1839    
1840    3. ml-makedepend accepts additional options -n, -a, and -o.  (See the
1841       CM manual for details.)
1842    
1843    4. More CM manual updates:
1844        - all of the above has been documented.
1845        - there is now a section describing the (CM-related) command line
1846          arguments that are accepted by the "sml" command
1847    
1848    ----------------------------------------------------------------------
1849    Name: Matthias Blume
1850    Date: 2000/07/25 16:20:00 JST
1851    Tag: blume-20000725-makedepend
1852    Description:
1853    
1854    Added a script called ml-makedepend.  This can be used in makefiles
1855    for Unix' make in a way very similar to the "makedepend" command for
1856    C.
1857    
1858    The script internally uses function CM.sources.
1859    
1860    Synopsis:
1861    
1862        ml-makedepend [-f makefile] cmfile targetname
1863    
1864    The default for the makefile is "makefile" (or "Makefile" should
1865    "makefile" not exist).
1866    
1867    ml-makedepend adds a cmfile/targetname-specific section to this
1868    makefile (after removing the previous version of this section).  The
1869    section contains a single dependency specification with targetname on
1870    the LHS (targetname is an arbitrary name), and a list of files derived
1871    from the cmfile on the RHS.  Some of the files on the RHS are
1872    ARCH/OPSYS-specific.  Therefore, ml-makedepend inserts references to
1873    "make" variables $(ARCH) and $(OPSYS) in place of the corresponding
1874    path names.  The makefile writer is responsible for making sure that
1875    these variables have correct at the time "make" is invoked.
1876    
1877    ----------------------------------------------------------------------
1878    Name: Matthias Blume
1879    Date: 2000/07/22 23:30:00 JST
1880    Tag: blume-20000722-urlupdate
1881    Description:
1882    
1883    Changed BOOT and config/srcarchiveurl to point to BL server:
1884    
1885        ftp://ftp.research.bell-labs.com/dist/smlnj/working/110.29/
1886    
1887    ----------------------------------------------------------------------
1888    Name: Matthias Blume
1889    Date: 2000/07/18 18:00:00 JST
1890    Tag: blume-20000718-Version_110_29
1891    Description:
1892    
1893    1. Updated src/compiler/TopLevel/main/version.sml to version 110.29
1894    
1895    2. Updated config/version to 110.29
1896    
1897    3. Updated config/srcarchiveurl
1898    
1899    3. New boot files!
1900       ftp://ftp.cs.princeton.edu/pub/people/blume/sml/110.29-autofetch
1901    
1902    ----------------------------------------------------------------------
1903    Name: Matthias Blume
1904    Date: 2000/07/11 13:58:00 JST
1905    Tag: blume-20000711-doctypo
1906    Description:
1907    
1908    Fixed a few typos in CM manual.
1909    
1910    ----------------------------------------------------------------------
1911    Name: Allen Leung
1912    Date: 2000/06/15 00:38:00
1913    Tag: leunga-20000704-sparc-x86
1914    
1915    1. x86 peephole improvement sp += k; sp -= k => nop  [from John]
1916    2. fix to x86 RET bug [found by Dan Grossman]
1917    3. sparc assembly bug fix for ticc instructions [found by Fermin]
1918    
1919       Affects c-- and moby only
1920    
1921    ----------------------------------------------------------------------
1922    Name: Matthias Blume
1923    Date: 2000/07/04 15:26:00
1924    Tag: blume-20000704-trigger
1925    Description:
1926    
1927    1. Improvements to CM manual.
1928    2. SMLofNJ.Internals.BTrace.trigger reinstated as an alternative way
1929       of getting a back-trace.  The function, when called, raises an
1930       internal exception which explicitly carries the full back-trace history,
1931       so it is unaffected by any intervening handle-raise pairs ("trivial"
1932       or not).  The interactive loop will print that history once it arrives
1933       at top level.
1934       Short of having all exceptions implicitly carry the full history, the
1935       recommended way of using this facility is:
1936         - compile your program with instrumentation "on"
1937         - run it, when it raises an exception, look at the history
1938         - if the history is "cut off" because of some handler, go and modify
1939           your program so that it explicitly calls BTrace.trigger
1940         - recompile (still instrumented), and rerun; look at the full history
1941    
1942    ----------------------------------------------------------------------
1943    Name: Matthias Blume
1944    Date: 2000/07/03 15:36:00 JST
1945    Tag: blume-20000702-manual
1946    Description:
1947    
1948    Small corrections and updates to CM manual.
1949    
1950    ----------------------------------------------------------------------
1951    Name: Matthias Blume
1952    Date: 2000/06/29 16:04:00 JST
1953    Tag: blume-20000629-yacctool
1954    Description:
1955    
1956    Changes:
1957    
1958    1. Class "mlyacc" now takes separate arguments to pass options to
1959       generated .sml- and .sig-files independently.
1960    2. Corresponding CM manual updates.
1961    3. BTrace module now also reports call sites.  (However, for loop clusters
1962       it only shows from where the cluster was entered.)  There are associated
1963       modifications to core.sml, internals.{sig,sml}, btrace.sml, and btimp.sml.
1964    
1965    ----------------------------------------------------------------------
1966    Name: Matthias Blume
1967    Date: 2000/06/27 16:51:00 JST
1968    Tag: blume-20000627-noweb
1969    Description:
1970    
1971    Changes:
1972    
1973     1. Implemented "subdir" and "witness" options for noweb tool.
1974        This caused some slight internal changes in CM's tool implementation.
1975     2. Fixed bug in "tool plugin" mechanism.  This is essentially cleaning
1976        some remaining issues from earlier path anchor changes.
1977     3. Updated CM manual accordingly.
1978    
1979     4. Changed implementation of back-tracing so that I now consider it
1980        ready for prime-time.
1981    
1982        In particular, you don't have to explicitly trigger the back-trace
1983        anymore.  Instead, if you are running BTrace-instrumented code and
1984        there is an uncaught exception (regardless of whether or not it was
1985        raised in instrumented code), the top-level evalloop will print
1986        the back-trace.
1987    
1988        Features:
1989    
1990          - Instrumented and uninstrumented code work together seemlessly.
1991            (Of course, uninstrumented code is never mentioned in actual
1992             back-traces.)
1993    
1994          - Asymptotic time- and space-complexity of instrumented code is
1995            equal to that of uninstrumented code.  (This means that
1996            tail-recursion is preserved by the instrumentation phase.)
1997    
1998          - Modules whose code has been instrumented in different sessions
1999            work together without problem.
2000    
2001          - There is no penalty whatsoever on uninstrumented code.
2002    
2003          - There is no penalty on "raise" expressions, even in
2004            instrumented code.
2005    
2006        A potential bug (or perhaps it is a feature, too):
2007    
2008          A back-trace reaches no further than the outermost instrumented
2009          non-trivial "raise".  Here, a "trivial" raise is one that is the
2010          sole RHS of a "handle" rule.  Thus, back-traces reach trough
2011    
2012               <exp> handle e => raise e
2013    
2014          and even
2015    
2016               <exp> handle Foo => raise Bar
2017    
2018          and, of course, through
2019    
2020               <exp> handle Foo => ...
2021    
2022         if the exception was not Foo.
2023    
2024         Back-traces always reach right through any un-instrumented code
2025         including any of its "handle" expressions, trivial or not.
2026    
2027       To try this out, do the following:
2028    
2029         - Erase all existing binfiles for your program.
2030           (You may keep binfiles for those modules where you think you
2031            definitely don't need back-tracing.)
2032         - Turn on back-trace instrumentation:
2033              SMLofNJ.Internals.BTrace.mode (SOME true);
2034         - Recompile your program.  (I.e., run "CM.make" or "use".)
2035         - You may now turn instrumentation off again (if you want):
2036              SMLofNJ.Internals.BTrace.mode (SOME false);
2037         - Run your program as usual.  If it raises an exception that
2038           reaches the interactive toplevel, then a back-trace will
2039           automatically be printed.  After that, the toplevel loop
2040           will print the exception history as usual.
2041    
2042  ----------------------------------------------------------------------  ----------------------------------------------------------------------
2043  Name: Matthias Blume  Name: Matthias Blume
2044  Date: 2000/06/26 09:56:46 JST  Date: 2000/06/26 09:56:46 JST
# Line 1188  Line 3216 
3216       elaborator). There were a lot of changes during my "linkpath" trials       elaborator). There were a lot of changes during my "linkpath" trials
3217       that could have been reverted to their original state but weren't.       that could have been reverted to their original state but weren't.
3218       Please, don't be too harsh on me for messing with this code a bit more       Please, don't be too harsh on me for messing with this code a bit more
3219       than what was strictly necessary...  (I _did_ resist the tempation       than what was strictly necessary...  (I _did_ resist the temptation
3220       of doing any "global reformatting" to avoid an untimely death at       of doing any "global reformatting" to avoid an untimely death at
3221       Dave's hands. :)       Dave's hands. :)
3222    

Legend:
Removed from v.677  
changed lines
  Added in v.986

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