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 606, Sun Apr 9 23:10:59 2000 UTC revision 1215, Tue May 21 20:05:42 2002 UTC
# Line 8  Line 8 
8  The form of an entry should be:  The form of an entry should be:
9    
10  Name:  Name:
11  Date:  Date: yyyy/mm/dd
12  Tag: <post-commit CVS tag>  Tag: <post-commit CVS tag>
13  Description:  Description:
14    
15    ----------------------------------------------------------------------
16    Name: Matthias Blume
17    Date: 2002/05/21 16:00:00 EDT
18    Tag: Release_110_40
19    Description:
20    
21    New working release (110.40).  New bootfiles.
22    
23    [Also: John Reppy fixed GC bug 1131.]
24    
25    ----------------------------------------------------------------------
26    Name: Matthias Blume
27    Date: 2002/05/21 12:35:00 EDT
28    Tag: blume-20020521-cmdoc
29    Description:
30    
31    CM documentation update.
32    
33    ----------------------------------------------------------------------
34    Name: Matthias Blume
35    Date: 2002/05/21 10:55:00 EDT
36    Tag: blume-20020521-misc
37    Description:
38    
39    - John tweaked runtime to be silent on heap export (except when
40      GC messages are on).
41    - I added a few more things (cross-compiling versions of CMB) to
42      config/preloads (as suggestions).
43    
44    ----------------------------------------------------------------------
45    Name: Matthias Blume
46    Date: 2002/05/20 22:25:00 EDT
47    Tag: blume-20020520-controls
48    Description:
49    
50    - Added ControlUtil structure to control-lib.cm.
51    - Use it throughout.
52    - Used Controls facility to define MLRISC controls (as opposed to
53      registering MLRISC control ref cells with Controls after the fact)
54    - Fixed messed-up controls priorities.
55    
56    * Removed again all the stuff from config/preloads that one wouldn't
57      be able to preload at the time the initial heap image is built.
58      (Many libraries, e.g., CML, do not exist yet at this time.  The
59       only libraries that can be preloaded via config/preloads are those
60       that come bundled with the bootfiles.)
61    
62    ----------------------------------------------------------------------
63    Name: Matthias Blume
64    Date: 2002/05/20 10:59:00 EDT
65    Tag: blume-20020520-preloads
66    Description:
67    
68    Added a lot of commented-out suggestions for things to be included
69    in config/preloads.
70    
71    ----------------------------------------------------------------------
72    Name: Allen Leung
73    Date: 2002/05/18 14:20:00 EDT
74    Tag: leunga-20020518-mdl
75    Description:
76    
77    o Made the mdl tool stuff compile and run again.
78    o I've disabled all the stuff that depends on RTL specifications; they
79      are all badly broken anyway.
80    
81    ----------------------------------------------------------------------
82    Name: Matthias Blume
83    Date: 2002/05/17 16:49:00 EDT
84    Tag: blume-20020517-controls
85    Description:
86    
87    0. John Reppy made several modifications to the SML/NJ library.
88       In particular, there is a shiny new controls-lib.cm.
89    
90    1. Pushed new controls interface through compiler so that everything
91       compiles again.
92    
93    2. Added FormatComb and FORMAT_COMB to the CML version of the
94       SML/NJ library (so that CML compiles again).
95    
96    3. Modified init scripts because XXX_DEFAULT environment variables
97       are no longer with us.  (Boot-time initialization is now done
98       using the same environment variables that are also used for
99       startup-time initialization of controls.)
100    
101    ----------------------------------------------------------------------
102    Name: Lal George
103    Date: 2002/05/15 09:20:10 EDT
104    Tag: george-20020515-pseudo-op-decls
105    Description:
106    
107            All pseudo-ops emitted before the first segment declaration
108    such as TEXT, DATA, and BSS directives are assumed to be global
109    declarations and are emitted first in the assembly file. This is
110    useful in a number of situations where one has pseudo-ops that are not
111    specific to any segment, and also works around the constraint that one
112    cannot have client pseudo-ops in the TEXT segment.
113    
114            Because no segment is associated with these declarations it is
115    an error to allocate any space or objects before the first segment
116    directive and an exception will be raised. However, we cannot make
117    this check for client pseudo-ops.
118    
119            These top level declarations are a field in the CFG graph_info.
120    In theory you can continue to add to this field after the CFG has been
121    built -- provided you know what you are doing;-)
122    
123    ----------------------------------------------------------------------
124    Name: Matthias Blume
125    Date: 2002/05/13 16:40:00 EDT
126    Tag: blume-20020513-pp-etc
127    Description:
128    
129    A few minor bugfixes:
130    
131      - Stopgap measure for bug recently reported by Elsa Gunter (ppDec).
132        (Bogus printouts for redefined bindings still occur.  Compiler
133        bug should no longer occur now.  We need to redo the prettyprinter
134        from scratch.)
135    
136      - CM pathname printer now also adds escape sequences for ( and )
137    
138      - commend and docu fixes for ml-nlffi
139    
140    ----------------------------------------------------------------------
141    Name: Matthias Blume
142    Date: 2002/05/10 16:40:00 EDT
143    Tag: blume-20020510-erg-textio
144    Description:
145    
146    Applied the following bugfix provided by Emden Gansner:
147    
148        Output is corrupted when outputSubstr is used rather than output.
149    
150        The problem occurs when a substring
151    
152            ss = (s, dataStart, dataLen)
153    
154        where dataStart > 0, fills a stream buffer with avail bytes left.
155        avail bytes of s, starting at index dataStart, are copied into the
156        buffer, the buffer is flushed, and then the remaining dataLen-avail
157        bytes of ss are copied into the beginning of the buffer. Instead of
158        starting this copy at index dataStart+avail in s, the current code
159        starts the copy at index avail.
160    
161        Fix:
162        In text-io-fn.sml, change line 695 from
163             val needsFlush = copyVec(v, avail, dataLen-avail, buf, 0)
164        to
165             val needsFlush = copyVec(v, dataStart+avail, dataLen-avail, buf, 0)
166    
167    ----------------------------------------------------------------------
168    Name: Matthias Blume
169    Date: 2002/04/12 13:55:00 EDT
170    Tag: blume-20020412-assyntax
171    Description:
172    
173    1. Grabbed newer assyntax.h from the XFree86 project.
174    2. Fiddled with how to compile X86.prim.asm without warnings.
175    3. (Very) Minor cleanup in CM.
176    
177    ----------------------------------------------------------------------
178    Name: Matthias Blume
179    Date: 2002/04/01 (no joke!) 17:07:00 EST
180    Tag: blume-20020401-x86div
181    Description:
182    
183    Added full support for div/mod/rem/quot on the x86, using the machine
184    instruction's two results (without clumsily recomputing the remainder)
185    directly where appropriate.
186    
187    Some more extensive power-of-two support was added to the x86 instruction
188    selector (avoiding expensive divs, mods, and muls where they can be
189    replaced with cheaper shifts and masks).  However, this sort of thing
190    ought to be done earlier, e.g., within the CPS optimizer so that
191    all architectures benefit from it.
192    
193    The compiler compiles to a fixed point, but changes might be somewhat
194    fragile nevertheless.  Please, report any strange things that you might
195    see wrt. div/mod/quot/rem...
196    
197    ----------------------------------------------------------------------
198    Name: Matthias Blume
199    Date: 2002/03/29 17:22:00
200    Tag: blume-20020329-div
201    Description:
202    
203    Fixed my broken div/mod logic.  Unfortunately, this means that the
204    inline code for div/mod now has one more comparison than before.
205    Fast paths (quotient > 0 or remainder = 0) are not affected, though.
206    The problem was with quotient = 0, because that alone does not tell
207    us which way the rounding went.  One then has to look at whether
208    remainder and divisor have the same sign...  :(
209    
210    Anyway, I replaced the bootfiles with fresh ones...
211    
212    ----------------------------------------------------------------------
213    Name: Matthias Blume
214    Date: 2002/03/29 14:10:00 EST
215    Tag: blume-20020329-inlprims
216    Description:
217    
218    NEW BOOTFILES!!!    Version number bumped to 110.39.3.
219    
220    Primops have changed. This means that the bin/boot-file formats have
221    changed as well.
222    
223    To make sure that there is no confusion, I made a new version.
224    
225    
226    CHANGES:
227    
228    * removed REMT from mltree (remainder should never overflow).
229    
230    * added primops to deal with divisions of all flavors to the frontend
231    
232    * handled these primops all the way through so they map to their respective
233      MLRISC support
234    
235    * used these primops in the implementation of Int, Int32, Word, Word32
236    
237    * removed INLDIV, INLMOD, and INLREM as they are no longer necessary
238    
239    * parameterized INLMIN, INLMAX, and INLABS by a numkind
240    
241    * translate.sml now deals with all flavors of INL{MIN,MAX,ABS}, including
242      floating point
243    
244    * used INL{MIN,MAX,ABS} in the implementation of Int, Int32, Word, Word32,
245      and Real (but Real.abs maps to a separate floating-point-only primop)
246    
247    
248    TODO items:
249    
250    * Hacked Alpha32 instruction selection, disabling the selection of REMx
251      instructions because the machine instruction encoder cannot handle
252      them.  (Hppa, PPC, and Sparc instruction selection did not handle
253      REM in the first place, and REM is supported by the x86 machine coder.)
254    
255    * Handle DIV and MOD with DIV_TO_NEGINF directly in the x86 instruction
256      selection phase.  (The two can be streamlined because the hardware
257      delivers both quotient and remainder at the same time anyway.)
258    
259    * Think about what to do with "valOf(Int32.minInt) div ~1" and friends.
260      (Currently the behavior is inconsistent both across architectures and
261      wrt. the draft Basis spec.)
262    
263    * Word8 should eventually be handled natively, too.
264    
265    * There seems to be one serious bug in mltree-gen.sml.  It appears, though,
266      as if there currently is no execution path that could trigger it in
267      SML/NJ.  (The assumptions underlying functions arith and promotable do not
268      hold for things like multiplication and division.)
269    
270    ----------------------------------------------------------------------
271    Name: Matthias Blume
272    Date: 2002/03/27 16:27:00 EST
273    Tag: blume-20020327-mlrisc-divisions
274    Description:
275    
276    Added support for all four division operations (ML's div, mod, quot,
277    and rem) to MLRISC.  In the course of doing so, I also rationalized
278    the naming (no more annoying switch-around of DIV and QUOT), by
279    parameterizing the operation by div_rounding_mode (which can be either
280    DIV_TO_ZERO or DIV_TO_NEGINF).
281    
282    The generic MLTreeGen functor takes care of compiling all four
283    operations down to only round-to-zero div.
284    
285    Missing pieces:
286    
287      * Doing something smarter than relying on MLTreeGen on architectures
288        like, e.g., the x86 where hardware division delivers both quotient and
289        remainder at the same time.  With this, the implementation of the
290        round-to-neginf operations could be further streamlined.
291    
292      * Remove inlining support for div/mod/rem from the frontend and replace it
293        with primops that get carried through to the backend.  Do this for all
294        int and word types.
295    
296    ----------------------------------------------------------------------
297    Name: Matthias Blume
298    Date: 2002/03/25 17:25:00 EST
299    Tag: blume-20020325-divmod
300    Description:
301    
302    I improved (hopefully without breaking them) the implementation of Int.div,
303    Int.mod, and Int.rem.   For this, the code in translate.sml now takes
304    advantage of the following observations:
305    
306      Let  q = x quot y      r = x rem y
307           d = x div  y      m = x mod y
308    
309    where "quot" is the round-to-zero version of integer division that
310    hardware usually provides.  Then we have:
311    
312         r = x - q * y        where neither the * nor the - will overflow
313         d = if q >= 0 orelse x = q * y then q else q - 1
314                              where neither the * nor the - will overflow
315         m = if q >= 0 orelse r = 0 then r else r + y
316                              where the + will not overflow
317    
318    This results in substantial simplification of the generated code.
319    The following table shows the number of CFG nodes and edges generated
320    for
321            fun f (x, y) = x OPER y
322            (* with OPER \in div, mod, quot, rem *)
323    
324    
325        OPER | nodes(old) | edges(old) | nodes(new) | edges(new)
326        --------------------------------------------------------
327         div |         24 |         39 |         12 |         16
328         mod |         41 |         71 |         12 |         16
329        quot |          8 |         10 |          8 |         10
330         rem |         10 |         14 |          8 |         10
331    
332    
333    ----------------------------------------------------------------------
334    Name: Matthias Blume
335    Date: 2002/03/25 22:06:00 EST
336    Tag: blume-20020325-cprotobug
337    Description:
338    
339    Fixed a bug in cproto (c prototype decoder).
340    
341    ----------------------------------------------------------------------
342    Name: Matthias Blume
343    Date: 2002/03/25 16:00:00 EST
344    Tag: blume-20020325-raw-primops
345    Description:
346    
347    I did some cleanup to Allen's new primop code and
348    replaced yesterday's bootfiles with new ones.
349    (But they are stored in the same place.)
350    
351    ----------------------------------------------------------------------
352    Name: Matthias Blume
353    Date: 2002/03/24 22:40:00 EST
354    Tag: blume-20020324-bootfiles
355    Description:
356    
357    Made the bootfiles that Allen asked for.
358    
359    ----------------------------------------------------------------------
360    Name: Allen Leung
361    Date: 2002/03/23 15:50:00 EST
362    Tag: leunga-20020323-flint-cps-rcc-primops
363    Description:
364    
365      1. Changes to FLINT primops:
366    
367        (* make a call to a C-function;
368         * The primop carries C function prototype information and specifies
369         * which of its (ML-) arguments are floating point. C prototype
370         * information is for use by the backend, ML information is for
371         * use by the CPS converter. *)
372      | RAW_CCALL of { c_proto: CTypes.c_proto,
373                       ml_args: ccall_type list,
374                       ml_res_opt: ccall_type option,
375                       reentrant : bool
376                     } option
377       (* Allocate uninitialized storage on the heap.
378        * The record is meant to hold short-lived C objects, i.e., they
379        * are not ML pointers.  With the tag, the representation is
380        * the same as RECORD with tag tag_raw32 (sz=4), or tag_fblock (sz=8)
381        *)
382      | RAW_RECORD of {tag:bool,sz:int}
383      and ccall_type = CCALL_INT32 | CCALL_REAL64 | CCALL_ML_PTR
384    
385      2.  These CPS primops are now overloaded:
386    
387           rawload of {kind:numkind}
388           rawstore of {kind:numkind}
389    
390          The one argument form is:
391    
392             rawload {kind} address
393    
394          The two argument form is:
395    
396             rawload {kind} [ml object, byte-offset]
397    
398      3. RAW_CCALL/RCC now takes two extra arguments:
399    
400         a. The first is whether the C call is reentrant, i.e., whether
401            ML state should be saved and restored.
402         b. The second argument is a string argument specifying the name of
403            library and the C function.
404    
405         These things are currently not handled in the code generator, yet.
406    
407      4. In CProto,
408    
409         An encoding type of "bool" means "ml object" and is mapped into
410         C prototype of PTR.  Note that "bool" is different than "string",
411         even though "string" is also mapped into PTR, because "bool"
412         is assigned an CPS type of BOGt, while "string" is assigned INT32t.
413    
414      5. Pickler/unpicker
415    
416         Changed to handle RAW_RECORD and newest RAW_CCALL
417    
418      6. MLRiscGen,
419    
420         1. Changed to handle the new rawload/rawstore/rawrecord operators.
421         2. Code for handling C Calls has been moved to a new module CPSCCalls,
422            in the file CodeGen/cpscompile/cps-c-calls.sml
423    
424      7. Added the conditional move operator
425    
426             condmove of branch
427    
428         to cps.  Generation of this is still buggy so it is currently
429         disabled.
430    
431    ----------------------------------------------------------------------
432    Name: Lal George
433    Date: 2002/03/22 14:18:25 EST
434    Tag: george-20020322-cps-branch-prob
435    Description:
436    
437    Implemented the Ball-Larus branch prediction-heuristics, and
438    incorporated graphical viewers for control flow graphs.
439    
440    Ball-Larus Heuristics:
441    ---------------------
442    See the file compiler/CodeGen/cpscompile/cpsBranchProb.sml.
443    
444    By design it uses the Dempster-Shafer theory for combining
445    probabilities.  For example, in the function:
446    
447        fun f(n,acc) = if n = 0 then acc else f(n-1, n*acc)
448    
449    the ball-larus heuristics predicts that the n=0 is unlikely
450    (OH-heuristic), and the 'then' branch is unlikely because of the
451    RH-heuristic -- giving the 'then' branch an even lower combined
452    probability using the Dempster-Shafer theory.
453    
454    Finally, John Reppy's loop analysis in MLRISC, further lowers the
455    probability of the 'then' branch because of the loop in the else
456    branch.
457    
458    
459    Graphical Viewing:
460    ------------------
461    I merely plugged in Allen's graphical viewers into the compiler. The
462    additional code is not much. At the top level, saying:
463    
464            Control.MLRISC.getFlag "cfg-graphical-view" := true;
465    
466    will display the graphical view of the control flow graph just before
467    back-patching.  daVinci must be in your path for this to work. If
468    daVinci is not available, then the default viewer can be changed
469    using:
470    
471            Control.MLRISC.getString "viewer"
472    
473    which can be set to "dot" or "vcg" for the corresponding viewers. Of
474    course, these viewers must be in your path.
475    
476    The above will display the compilation unit at the level of clusters,
477    many of which are small, boring, and un-interesting. Also setting:
478    
479            Control.MLRISC.getInt "cfg-graphical-view_size"
480    
481    will display clusters that are larger than the value set by the above.
482    
483    
484    ----------------------------------------------------------------------
485    Name: Matthias Blume
486    Date: 2002/03/21 22:20:00 EST
487    Tag: blume-20020321-kmp-bugfix
488    Description:
489    
490    Changed the interface to the KMP routine in PreString and fixed
491    a minor bug in one place where it was used.
492    
493    ----------------------------------------------------------------------
494    Name: Allen Leung
495    Date: 2002/03/21 20:30:00 EST
496    Tag: leunga-20020321-cfg
497    Description:
498    
499      Fixed a potential problem in cfg edge splitting.
500    
501    ----------------------------------------------------------------------
502    Name: Allen Leung
503    Date: 2002/03/21 17:15:00 EST
504    Tag: leunga-20020321-x86-fp-cfg
505    Description:
506    
507      1. Recoded the buggy parts of x86-fp.
508    
509         a. All the block reordering code has been removed.
510            We now depend on the block placement phases to do this work.
511    
512         b. Critical edge splitting code has been simplified and moved into the
513            CFG modules, as where they belong.
514    
515         Both of these were quite buggy and complex.  The code is now much, much
516         simpler.
517    
518      2. X86 backend.
519    
520         a. Added instructions for 64-bit support.  Instruction selection for
521            64-bit has not been committed, however, since that
522            requires changes to MLTREE which haven't been approved by
523            Lal and John.
524    
525         b. Added support for FUCOMI and FUCOMIP when generating code for
526            PentiumPro and above.  We only generate these instructions in
527            the fast-fp mode.
528    
529         c. Added cases for JP and JNP in X86FreqProps.
530    
531      3. CFG
532    
533         CFG now has a bunch of methods for edge splitting and merging.
534    
535      4. Machine description.
536    
537         John's simplification of MLTREE_BASIS.fcond broke a few machine
538         description things:
539    
540         rtl-build.{sig,sml} and hppa.mdl fixed.
541    
542         NOTE: the machine description stuff in the repository is still broken.
543               Again, I can't put my fixes in because that involves
544               changes to MLTREE.
545    
546    ----------------------------------------------------------------------
547    Name: Matthias Blume
548    Date: 2002/03/20 15:55:00 EST
549    Tag: blume-20020320-kmp
550    Description:
551    
552    Implemented Knuth-Morris-Pratt string matching in PreString and used
553    it for String.isSubstring, Substring.isSubstring, and
554    Substring.position.
555    
556    (Might need some stress-testing.  Simple examples worked fine.)
557    
558    ----------------------------------------------------------------------
559    Name: Matthias Blume
560    Date: 2002/03/19 16:37:00 EST
561    Tag: blume-20020319-witnesses
562    Description:
563    
564    Added a structure C.W and functions convert/Ptr.convert to ml-nlffi-lib.
565    
566    This implements a generic mechanism for changing constness qualifiers
567    anywhere within big C types without resorting to outright "casts".
568    (So far, functions such as C.rw/C.ro or C.Ptr.rw/C.Ptr.ro only let you
569    modify the constness at the outermost level.)
570    The implementation of "convert" is based on the idea of "witness"
571    values -- values that are not used by the operation but whose types
572    "testify" to their applicability.  On the implementation side, "convert"
573    is simply a projection (returning its second curried argument).  With
574    cross-module inlining, it should not result in any machine code being
575    generated.
576    
577    ----------------------------------------------------------------------
578    Name: Matthias Blume
579    Date: 2002/03/15 16:40:00 EST
580    Tag: blume-20020315-basis
581    Description:
582    
583    Provided (preliminary?) implementations for
584    
585      {String,Substring}.{concatWith,isSuffix,isSubstring}
586    
587    and
588    
589      Substring.full
590    
591    Those are in the Basis spec but they were missing in SML/NJ.
592    
593    ----------------------------------------------------------------------
594    Name: Matthias Blume
595    Date: 2002/03/14 21:30:00 EST
596    Tag: blume-20020314-controls
597    Description:
598    
599    Controls:
600    ---------
601    
602    1. Factored out the recently-added Controls : CONTROLS stuff and put
603       it into its own library $/controls-lib.cm.  The source tree for
604       this is under src/smlnj-lib/Controls.
605    
606    2. Changed the names of types and functions in this interface, so they
607       make a bit more "sense":
608    
609          module -> registry
610          'a registry -> 'a group
611    
612    3. The interface now deals in ref cells only.  The getter/setter interface
613       is (mostly) gone.
614    
615    4. Added a function that lets one register an already-existing ref cell.
616    
617    5. Made the corresponding modifications to the rest of the code so that
618       everything compiles again.
619    
620    6. Changed the implementation of Controls.MLRISC back to something closer
621       to the original.  In particular, this module (and therefore MLRISC)
622       does not depend on Controls.  There now is some link-time code in
623       int-sys.sml that registers the MLRISC controls with the Controls
624       module.
625    
626    CM:
627    ---
628    
629      * One can now specify the lambda-split aggressiveness in init.cmi.
630    
631    ----------------------------------------------------------------------
632    Name: Allen Leung
633    Date: 2002/03/13 17:30:00 EST
634    Tag: leunga-20020313-x86-fp-unary
635    Description:
636    
637    Bug fix for:
638    
639    > leunga@weaselbane:~/Yale/tmp/sml-dist{21} bin/sml
640    > Standard ML of New Jersey v110.39.1 [FLINT v1.5], March 08, 2002
641    > - fun f(x,(y,z)) = Real.~ y;
642    > [autoloading]
643    > [autoloading done]
644    >       fchsl   (%eax), 184(%esp)
645    > Error: MLRisc bug: X86MCEmitter.emitInstr
646    >
647    > uncaught exception Error
648    >   raised at: ../MLRISC/control/mlriscErrormsg.sml:16.14-16.19
649    
650    The problem was that the code generator did not generate any fp registers
651    in this case, and the ra didn't know that it needed to run the X86FP phase to
652    translate the pseudo fp instruction.   This only happened with unary fp
653    operators in certain situations.
654    
655    ----------------------------------------------------------------------
656    Name: Matthias Blume
657    Date: 2002/03/13 14:00:00 EST
658    Tag: blume-20020313-overload-etc
659    Description:
660    
661    1. Added _overload as a synonym for overload for backward compatibility.
662       (Control.overloadKW must be true for either version to be accepted.)
663    
664    2. Fixed bug in install script that caused more things to be installed
665       than what was requested in config/targets.
666    
667    3. Made CM aware of the (_)overload construct so that autoloading
668       works.
669    
670    ----------------------------------------------------------------------
671    Name: Matthias Blume
672    Date: 2002/03/12 22:03:00 EST
673    Tag: blume-20020312-url
674    Description:
675    
676    Forgot to update BOOT and srcarchiveurl.
677    
678    ----------------------------------------------------------------------
679    Name: Matthias Blume
680    Date: 2002/03/12 17:30:00 EST
681    Tag: blume-20020312-version110392
682    Description:
683    
684    Yet another version number bump (because of small changes to the
685    binfile format).  Version number is now 110.39.2.  NEW BOOTFILES!
686    
687    Changes:
688    
689      The new pid generation scheme described a few weeks ago was overly
690      complicated.  I implemented a new mechanism that is simpler and
691      provides a bit more "stability":  Once CM has seen a compilation
692      unit, it keeps its identity constant (as long as you do not delete
693      those crucial CM/GUID/* files).  This means that when you change
694      an interface, compile, then go back to the old interface, and
695      compile again, you arrive at the original pid.
696    
697      There now also is a mechanism that instructs CM to use the plain
698      environment hash as a module's pid (effectively making its GUID
699      the empty string).  For this, "noguid" must be specified as an
700      option to the .sml file in question within its .cm file.
701      This is most useful for code that is being generated by tools such
702      as ml-nlffigen (because during development programmers tend to
703      erase the tool's entire output directory tree including CM's cached
704      GUIDs).  "noguid" is somewhat dangerous (since it can be used to locally
705      revert to the old, broken behavior of SML/NJ, but in specific cases
706      where there is no danger of interface confusion, its use is ok
707      (I think).
708    
709      ml-nlffigen by default generates "noguid" annotations.  They can be
710      turned off by specifying -guid in its command line.
711    
712    ----------------------------------------------------------------------
713    Name: Lal George
714    Date: 2002/03/12 12 14:42:36 EST
715    Tag: george-20020312-frequency-computation
716    Description:
717    
718    Integrated jump chaining and static block frequency into the
719    compiler. More details and numbers later.
720    
721    ----------------------------------------------------------------------
722    Name: Lal George
723    Date: 2002/03/11 11 22:38:53 EST
724    Tag: george-20020311-jump-chain-elim
725    Description:
726    
727    Tested the jump chain elimination on all architectures (except the
728    hppa).  This is on by default right now and is profitable for the
729    alpha and x86, however, it may not be profitable for the sparc and ppc
730    when compiling the compiler.
731    
732    The gc test will typically jump to a label at the end of the cluster,
733    where there is another jump to an external cluster containing the actual
734    code to invoke gc. This is to allow factoring of common gc invocation
735    sequences. That is to say, we generate:
736    
737            f:
738               testgc
739               ja   L1      % jump if above to L1
740    
741            L1:
742               jmp L2
743    
744    
745    After jump chain elimination the 'ja L1' instructions is converted to
746    'ja L2'. On the sparc and ppc, many of the 'ja L2' instructions may end
747    up being implemented in their long form (if L2 is far away) using:
748    
749            jbe     L3      % jump if below or equal to L3
750            jmp     L2
751         L3:
752            ...
753    
754    
755    For large compilation units L2  may be far away.
756    
757    
758    ----------------------------------------------------------------------
759    Name: Matthias Blume
760    Date: 2002/03/11 13:30:00 EST
761    Tag: blume-20020311-mltreeeval
762    Description:
763    
764    A functor parameter was missing.
765    
766    ----------------------------------------------------------------------
767    Name: Allen Leung
768    Date: 2002/03/11 10:30:00 EST
769    Tag: leunga-20020311-runtime-string0
770    Description:
771    
772       The representation of the empty string now points to a
773    legal null terminated C string instead of unit.  It is now possible
774    to convert an ML string into C string with InlineT.CharVector.getData.
775    This compiles into one single machine instruction.
776    
777    ----------------------------------------------------------------------
778    Name: Allen Leung
779    Date: 2002/03/10 23:55:00 EST
780    Tag: leunga-20020310-x86-call
781    Description:
782    
783       Added machine generation for CALL instruction (relative displacement mode)
784    
785    ----------------------------------------------------------------------
786    Name: Matthias Blume
787    Date: 2002/03/08 16:05:00
788    Tag: blume-20020308-entrypoints
789    Description:
790    
791    Version number bumped to 110.39.1.  NEW BOOTFILES!
792    
793    Entrypoints: non-zero offset into a code object where execution should begin.
794    
795    - Added the notion of an entrypoint to CodeObj.
796    - Added reading/writing of entrypoint info to Binfile.
797    - Made runtime system bootloader aware of entrypoints.
798    - Use the address of the label of the first function given to mlriscGen
799      as the entrypoint.  This address is currently always 0, but it will
800      not be 0 once we turn on block placement.
801    - Removed the linkage cluster code (which was The Other Way(tm) of dealing
802      with entry points) from mlriscGen.
803    
804    ----------------------------------------------------------------------
805    Name: Allen Leung
806    Date: 2002/03/07 20:45:00 EST
807    Tag: leunga-20020307-x86-cmov
808    Description:
809    
810       Bug fixes for CMOVcc on x86.
811    
812       1. Added machine code generation for CMOVcc
813       2. CMOVcc is now generated in preference over SETcc on PentiumPro or above.
814       3. CMOVcc cannot have an immediate operand as argument.
815    
816    ----------------------------------------------------------------------
817    Name: Matthias Blume
818    Date: 2002/03/07 16:15:00 EST
819    Tag: blume-20020307-controls
820    Description:
821    
822    This is a very large but mostly boring patch which makes (almost)
823    every tuneable compiler knob (i.e., pretty much everything under
824    Control.* plus a few other things) configurable via both the command
825    line and environment variables in the style CM did its configuration
826    until now.
827    
828    Try starting sml with '-h' (or, if you are brave, '-H')
829    
830    To this end, I added a structure Controls : CONTROLS to smlnj-lib.cm which
831    implements the underlying generic mechanism.
832    
833    The interface to some of the existing such facilities has changed somewhat.
834    For example, the MLRiscControl module now provides mkFoo instead of getFoo.
835    (The getFoo interface is still there for backward-compatibility, but its
836    use is deprecated.)
837    
838    The ml-build script passes -Cxxx=yyy command-line arguments through so
839    that one can now twiddle the compiler settings when using this "batch"
840    compiler.
841    
842    TODO items:
843    
844    We should go through and throw out all controls that are no longer
845    connected to anything.  Moreover, we should go through and provide
846    meaningful (and correct!) documentation strings for those controls
847    that still are connected.
848    
849    Currently, multiple calls to Controls.new are accepted (only the first
850    has any effect).  Eventually we should make sure that every control
851    is being made (via Controls.new) exactly once.  Future access can then
852    be done using Controls.acc.
853    
854    Finally, it would probably be a good idea to use the getter-setter
855    interface to controls rather than ref cells.  For the time being, both
856    styles are provided by the Controls module, but getter-setter pairs are
857    better if thread-safety is of any concern because they can be wrapped.
858    
859    *****************************************
860    
861    One bug fix: The function blockPlacement in three of the MLRISC
862    backpatch files used to be hard-wired to one of two possibilities at
863    link time (according to the value of the placementFlag).  But (I
864    think) it should rather sense the flag every time.
865    
866    *****************************************
867    
868    Other assorted changes (by other people who did not supply a HISTORY entry):
869    
870    1. the cross-module inliner now works much better (Monnier)
871    2. representation of weights, frequencies, and probabilities in MLRISC
872       changed in preparation of using those for weighted block placement
873       (Reppy, George)
874    
875    ----------------------------------------------------------------------
876    Name: Lal George
877    Date: 2002/03/07 14:44:24 EST 2002
878    Tag: george-20020307-weighted-block-placement
879    
880    Tested the weighted block placement optimization on all architectures
881    (except the hppa) using AMPL to generate the block and edge frequencies.
882    Changes were required in the machine properties to correctly
883    categorize trap instructions. There is an MLRISC flag
884    "weighted-block-placement" that can be used to enable weighted block
885    placement, but this will be ineffective without block/edge
886    frequencies (coming soon).
887    
888    
889    ----------------------------------------------------------------------
890    Name: Lal George
891    Date: 2002/03/05 17:24:48 EST
892    Tag: george-20020305-linkage-cluster
893    
894    In order to support the block placement optimization, a new cluster
895    is generated as the very first cluster (called the linkage cluster).
896    It contains a single jump to the 'real' entry point for the compilation
897    unit. Block placement has no effect on the linkage cluster itself, but
898    all the other clusters  have full freedom in the manner in which they
899    reorder blocks or functions.
900    
901    On the x86 the typical linkage code that is generated is:
902       ----------------------
903            .align 2
904       L0:
905            addl    $L1-L0, 72(%esp)
906            jmp     L1
907    
908    
909            .align  2
910       L1:
911       ----------------------
912    
913    72(%esp) is the memory location for the stdlink register. This
914    must contain the address of the CPS function being called. In the
915    above example, it contains the address of  L0; before
916    calling L1 (the real entry point for the compilation unit), it
917    must contain the address for L1, and hence
918    
919            addl $L1-L0, 72(%esp)
920    
921    I have tested this on all architectures except the hppa.The increase
922    in code size is of course negligible
923    
924    ----------------------------------------------------------------------
925    Name: Allen Leung
926    Date: 2002/03/03 13:20:00 EST
927    Tag: leunga-20020303-mlrisc-tools
928    
929      Added #[ ... ] expressions to mlrisc tools
930    
931    ----------------------------------------------------------------------
932    Name: Matthias Blume
933    Date: 2002/02/27 12:29:00 EST
934    Tag: blume-20020227-cdebug
935    Description:
936    
937    - made types in structure C and C_Debug to be equal
938    - got rid of code duplication (c-int.sml vs. c-int-debug.sml)
939    - there no longer is a C_Int_Debug (C_Debug is directly derived from C)
940    
941    ----------------------------------------------------------------------
942    Name: Matthias Blume
943    Date: 2002/02/26 12:00:00 EST
944    Tag: blume-20020226-ffi
945    Description:
946    
947    1. Fixed a minor bug in CM's "noweb" tool:
948       If numbering is turned off, then truly don't number (i.e., do not
949       supply the -L option to noweb).  The previous behavior was to supply
950       -L'' -- which caused noweb to use the "default" line numbering scheme.
951       Thanks to Chris Richards for pointing this out (and supplying the fix).
952    
953    2. Once again, I reworked some aspects of the FFI:
954    
955       A. The incomplete/complete type business:
956    
957       - Signatures POINTER_TO_INCOMPLETE_TYPE and accompanying functors are
958         gone!
959       - ML types representing an incomplete type are now *equal* to
960         ML types representing their corresponding complete types (just like
961         in C).  This is still safe because ml-nlffigen will not generate
962         RTTI for incomplete types, nor will it generate functions that
963         require access to such RTTI.   But when ML code generated from both
964         incomplete and complete versions of the C type meet, the ML types
965         are trivially interoperable.
966    
967         NOTE:  These changes restore the full generality of the translation
968         (which was previously lost when I eliminated functorization)!
969    
970       B. Enum types:
971    
972       - Structure C now has a type constructor "enum" that is similar to
973         how the "su" constructor works.  However, "enum" is not a phantom
974         type because each "T enum" has values (and is isomorphic to
975         MLRep.Signed.int).
976       - There are generic access operations for enum objects (using
977         MLRep.Signed.int).
978       - ml-nlffigen will generate a structure E_foo for each "enum foo".
979         * The structure contains the definition of type "mlrep" (the ML-side
980         representation type of the enum).  Normally, mlrep is the same
981         as "MLRep.Signed.int", but if ml-nlffigen was invoked with "-ec",
982         then mlrep will be defined as a datatype -- thus facilitating
983         pattern matching on mlrep values.
984         ("-ec" will be suppressed if there are duplicate values in an
985          enumeration.)
986         * Constructors ("-ec") or values (no "-ec") e_xxx of type mlrep
987         will be generated for each C enum constant xxx.
988         * Conversion functions m2i and i2m convert between mlrep and
989         MLRep.Signed.int.  (Without "-ec", these functions are identities.)
990         * Coversion functions c and ml convert between mlrep and "tag enum".
991         * Access functions (get/set) fetch and store mlrep values.
992       - By default (unless ml-nlffigen was invoked with "-nocollect"), unnamed
993         enumerations are merged into one single enumeration represented by
994         structure E_'.
995    
996    ----------------------------------------------------------------------
997    Name: Allen Leung
998    Date: 2002/02/25 04:45:00 EST
999    Tag: leunga-20020225-cps-spill
1000    
1001    This is a new implementation of the CPS spill phase.
1002    The new phase is in the new file compiler/CodeGen/cpscompile/spill-new.sml
1003    In case of problems, replace it with the old file spill.sml
1004    
1005    The current compiler runs into some serious performance problems when
1006    constructing a large record.  This can happen when we try to compile a
1007    structure with many items.  Even a very simple structure like the following
1008    makes the compiler slow down.
1009    
1010        structure Foo = struct
1011           val x_1 = 0w1 : Word32.int
1012           val x_2 = 0w2 : Word32.int
1013           val x_3 = 0w3 : Word32.int
1014           ...
1015           val x_N = 0wN : Word32.int
1016        end
1017    
1018    The following table shows the compile time, from N=1000 to N=4000,
1019    with the old compiler:
1020    
1021    N
1022    1000   CPS 100 spill                           0.04u  0.00s  0.00g
1023           MLRISC ra                               0.06u  0.00s  0.05g
1024              (spills = 0 reloads = 0)
1025           TOTAL                                   0.63u  0.07s  0.21g
1026    
1027    1100   CPS 100 spill                           8.25u  0.32s  0.64g
1028           MLRISC ra                               5.68u  0.59s  3.93g
1029              (spills = 0 reloads = 0)
1030           TOTAL                                   14.71u  0.99s  4.81g
1031    
1032    1500   CPS 100 spill                           58.55u  2.34s  1.74g
1033           MLRISC ra                               5.54u  0.65s  3.91g
1034              (spills = 543 reloads = 1082)
1035           TOTAL                                   65.40u  3.13s  6.00g
1036    
1037    2000   CPS 100 spill                           126.69u  4.84s  3.08g
1038           MLRISC ra                               0.80u  0.10s  0.55g
1039              (spills = 42 reloads = 84)
1040           TOTAL                                   129.42u  5.10s  4.13g
1041    
1042    3000   CPS 100 spill                           675.59u  19.03s  11.64g
1043           MLRISC ra                               2.69u  0.27s  1.38g
1044              (spills = 62 reloads = 124)
1045           TOTAL                                   682.48u  19.61s  13.99g
1046    
1047    4000   CPS 100 spill                           2362.82u  56.28s  43.60g
1048           MLRISC ra                               4.96u  0.27s  2.72g
1049              (spills = 85 reloads = 170)
1050           TOTAL                                   2375.26u  57.21s  48.00g
1051    
1052    As you can see the old cps spill module suffers from some serious
1053    performance problem.  But since I cannot decipher the old code fully,
1054    instead of patching the problems up, I'm reimplementing it
1055    with a different algorithm.  The new code is more modular,
1056    smaller when compiled, and substantially faster
1057    (O(n log n) time and O(n) space).  Timing of the new spill module:
1058    
1059    4000  CPS 100 spill                           0.02u  0.00s  0.00g
1060          MLRISC ra                               0.25u  0.02s  0.15g
1061             (spills=1 reloads=3)
1062          TOTAL                                   7.74u  0.34s  1.62g
1063    
1064    Implementation details:
1065    
1066    As far as I can tell, the purpose of the CPS spill module is to make sure the
1067    number of live variables at any program point (the bandwidth)
1068    does not exceed a certain limit, which is determined by the
1069    size of the spill area.
1070    
1071    When the bandwidth is too large, we decrease the register pressure by
1072    packing live variables into spill records.  How we achieve this is
1073    completely different than what we did in the old code.
1074    
1075    First, there is something about the MLRiscGen code generator
1076    that we should be aware of:
1077    
1078    o MLRiscGen performs code motion!
1079    
1080       In particular, it will move floating point computations and
1081       address computations involving only the heap pointer to
1082       their use sites (if there is only a single use).
1083       What this means is that if we have a CPS record construction
1084       statement
1085    
1086           RECORD(k,vl,w,e)
1087    
1088       we should never count the new record address w as live if w
1089       has only one use (which is often the case).
1090    
1091       We should do something similar to floating point, but the transformation
1092       there is much more complex, so I won't deal with that.
1093    
1094    Secondly, there are now two new cps primops at our disposal:
1095    
1096     1. rawrecord of record_kind option
1097        This pure operator allocates some uninitialized storage from the heap.
1098        There are two forms:
1099    
1100         rawrecord NONE [INT n]  allocates a tagless record of length n
1101         rawrecord (SOME rk) [INT n] allocates a tagged record of length n
1102                                     and initializes the tag.
1103    
1104     2. rawupdate of cty
1105          rawupdate cty (v,i,x)
1106          Assigns to x to the ith component of record v.
1107          The storelist is not updated.
1108    
1109    We use these new primops for both spilling and increment record construction.
1110    
1111     1. Spilling.
1112    
1113        This is implemented with a linear scan algorithm (but generalized
1114        to trees).  The algorithm will create a single spill record at the
1115        beginning of the cps function and use rawupdate to spill to it,
1116        and SELECT or SELp to reload from it.  So both spills and reloads
1117        are fine-grain operations.  In contrast, in the old algorithm
1118        "spills" have to be bundled together in records.
1119    
1120        Ideally, we should sink the spill record construction to where
1121        it is needed.  We can even split the spill record into multiple ones
1122        at the places where they are needed.  But CPS is not a good
1123        representation for global code motion, so I'll keep it simple and
1124        am not attempting this.
1125    
1126     2. Incremental record construction (aka record splitting).
1127    
1128        Long records with many component values which are simulatenously live
1129        (recall that single use record addresses are not considered to
1130         be live) are constructed with rawrecord and rawupdate.
1131        We allocate space on the heap with rawrecord first, then gradually
1132        fill it in with rawupdate.  This is the technique suggested to me
1133        by Matthias.
1134    
1135        Some restrictions on when this is applicable:
1136        1. It is not a VECTOR record.  The code generator currently does not handle
1137           this case. VECTOR record uses double indirection like arrays.
1138        2. All the record component values are defined in the same "basic block"
1139           as the record constructor.  This is to prevent speculative
1140           record construction.
1141    
1142    ----------------------------------------------------------------------
1143    Name: Allen Leung
1144    Date: 2002/02/22 01:02:00 EST
1145    Tag: leunga-20020222-mlrisc-tools
1146    
1147    Minor bug fixes in the parser and rewriter
1148    
1149    ----------------------------------------------------------------------
1150    Name: Allen Leung
1151    Date: 2002/02/21 20:20:00 EST
1152    Tag: leunga-20020221-peephole
1153    
1154    Regenerated the peephole files.  Some contained typos in the specification
1155    and some didn't compile because of pretty printing bugs in the old version
1156    of 'nowhere'.
1157    
1158    ----------------------------------------------------------------------
1159    Name: Allen Leung
1160    Date: 2002/02/19 20:20:00 EST
1161    Tag: leunga-20020219-mlrisc-tools
1162    Description:
1163    
1164       Minor bug fixes to the mlrisc-tools library:
1165    
1166       1.  Fixed up parsing colon suffixed keywords
1167       2.  Added the ability to shut the error messages up
1168       3.  Reimplemented the pretty printer and fixed up/improved
1169           the pretty printing of handle and -> types.
1170       4.  Fixed up generation of literal symbols in the nowhere tool.
1171       5.  Added some SML keywords to to sml.sty
1172    
1173    ----------------------------------------------------------------------
1174    Name: Matthias Blume
1175    Date: 2002/02/19 16:20:00 EST
1176    Tag: blume-20020219-cmffi
1177    Description:
1178    
1179    A wild mix of changes, some minor, some major:
1180    
1181    * All C FFI-related libraries are now anchored under $c:
1182        $/c.cm      --> $c/c.cm
1183        $/c-int.cm  --> $c/internals/c-int.cm
1184        $/memory.cm --> $c/memory/memory.cm
1185    
1186    * "make" tool (in CM) now treats its argument pathname slightly
1187      differently:
1188        1. If the native expansion is an absolute name, then before invoking
1189           the "make" command on it, CM will apply OS.Path.mkRelative
1190           (with relativeTo = OS.FileSys.getDir()) to it.
1191        2. The argument will be passed through to subsequent phases of CM
1192           processing without "going native".  In particular, if the argument
1193           was an anchored path, then "make" will not lose track of that anchor.
1194    
1195    * Compiler backends now "know" their respective C calling conventions
1196      instead of having to be told about it by ml-nlffigen.  This relieves
1197      ml-nlffigen from one of its burdens.
1198    
1199    * The X86Backend has been split into X86CCallBackend and X86StdCallBackend.
1200    
1201    * Export C_DEBUG and C_Debug from $c/c.cm.
1202    
1203    * C type encoding in ml-nlffi-lib has been improved to model the conceptual
1204      subtyping relationship between incomplete pointers and their complete
1205      counterparts.  For this, ('t, 'c) ptr has been changed to 'o ptr --
1206      with the convention of instantiating 'o with ('t, 'c) obj whenever
1207      the pointer target type is complete.  In the incomplete case, 'o
1208      will be instantiated with some "'c iobj" -- a type obtained by
1209      using one of the functors PointerToIncompleteType or PointerToCompleteType.
1210    
1211      Operations that work on both incomplete and complete pointer types are
1212      typed as taking an 'o ptr while operations that require the target to
1213      be known are typed as taking some ('t, 'c) obj ptr.
1214    
1215      voidptr is now a bit "more concrete", namely "type voidptr = void ptr'"
1216      where void is an eqtype without any values.  This makes it possible
1217      to work on voidptr values using functions meant to operate on light
1218      incomplete pointers.
1219    
1220    * As a result of the above, signature POINTER_TO_INCOMPLETE_TYPE has
1221      been vastly simplified.
1222    
1223    ----------------------------------------------------------------------
1224    Name: Matthias Blume
1225    Date: 2002/02/19 10:48:00 EST
1226    Tag: blume-20020219-pqfix
1227    Description:
1228    
1229    Applied Chris Okasaki's bug fix for priority queues.
1230    
1231    ----------------------------------------------------------------------
1232    Name: Matthias Blume
1233    Date: 2002/02/15 17:05:00
1234    Tag: Release_110_39
1235    Description:
1236    
1237    Last-minute retagging is becoming a tradition... :-(
1238    
1239    This is the working release 110.39.
1240    
1241    ----------------------------------------------------------------------
1242    Name: Matthias Blume
1243    Date: 2002/02/15 16:00:00 EST
1244    Tag: Release_110_39-orig
1245    Description:
1246    
1247    Working release 110.39.  New bootfiles.
1248    
1249    (Update: There was a small bug in the installer so it wouldn't work
1250    with all shells.  So I retagged. -Matthias)
1251    
1252    ----------------------------------------------------------------------
1253    Name: Matthias Blume
1254    Date: 2002/02/15 14:17:00 EST
1255    Tag: blume-20020215-showbindings
1256    Description:
1257    
1258    Added EnvRef.listBoundSymbols and CM.State.showBindings.  Especially
1259    the latter can be useful for exploring what bindings are available at
1260    the interactive prompt.  (The first function returns only the list
1261    of symbols that are really bound, the second prints those but also the
1262    ones that CM's autoloading mechanism knows about.)
1263    
1264    ----------------------------------------------------------------------
1265    Name: Matthias Blume
1266    Date: 2002/02/15 12:08:00 EST
1267    Tag: blume-20020215-iptrs
1268    Description:
1269    
1270    Two improvements to ml-nlffigen:
1271    
1272      1. Write files only if they do not exist or if their current contents
1273         do not coincide with what's being written.  (That is, avoid messing
1274         with the time stamps unless absolutely necessary.)
1275    
1276      2. Implement a "repository" mechanism for generated files related
1277         to "incomplete pointer types".   See the README file for details.
1278    
1279    ----------------------------------------------------------------------
1280    Name: Matthias Blume
1281    Date: 2002/02/14 11:50:00 EST
1282    Tag: blume-20020214-quote
1283    Description:
1284    
1285    Added a type 't t_' to tag.sml (in ml-nlffi-lib.cm).  This is required
1286    because of the new and improved tag generation scheme.  (Thanks to Allen
1287    Leung for pointing it out.)
1288    
1289    ----------------------------------------------------------------------
1290    Name: Lal George
1291    Date: 2002/02/14 09:55:27 EST 2002
1292    Tag: george-20020214-isabelle-bug
1293    Description:
1294    
1295    Fixed the MLRISC bug sent by Markus Wenzel regarding the compilation
1296    of Isabelle on the x86.
1297    
1298    From Allen:
1299    -----------
1300     I've found the problem:
1301    
1302         in ra-core.sml, I use the counter "blocked" to keep track of the
1303         true number of elements in the freeze queue.  When the counter goes
1304         to zero, I skip examining the queue.  But I've messed up the
1305         bookkeeping in combine():
1306    
1307             else ();
1308             case !ucol of
1309               PSEUDO => (if !cntv > 0 then
1310                     (if !cntu > 0 then blocked := !blocked - 1 else ();
1311                                        ^^^^^^^^^^^^^^^^^^^^^^^
1312                      moveu := mergeMoveList(!movev, !moveu)
1313                     )
1314                  else ();
1315    
1316         combine() is called to coalesce two nodes u and v.
1317         I think I was thinking that if the move counts of u and v are both
1318         greater than zero then after they are coalesced then one node is
1319         removed from the freeze queue.  Apparently I was thinking that
1320         both u and v are of low degree, but that's clearly not necessarily true.
1321    
1322    
1323    02/12/2002:
1324        Here's the patch.  HOL now compiles.
1325    
1326        I don't know how this impact on performance (compile
1327        time or runtime).  This bug caused the RA (especially on the x86)
1328        to go thru the potential spill phase when there are still nodes on the
1329        freeze queue.
1330    
1331    
1332    
1333    
1334    ----------------------------------------------------------------------
1335    Name: Matthias Blume
1336    Date: 2002/02/13 22:40:00 EST
1337    Tag: blume-20020213-fptr-rtti
1338    Description:
1339    
1340    Fixed a bug in ml-nlffigen that was introduced with one of the previous
1341    updates.
1342    
1343    ----------------------------------------------------------------------
1344    Name: Matthias Blume
1345    Date: 2002/02/13 16:41:00 EST
1346    Tag: blume-20020213-cmlpq
1347    Description:
1348    
1349    Added new priority queue export symbols (which have just been added to
1350    smlnj-lib.cm) to CML's version of smlnj-lib.cm.  (Otherwise CML would
1351    not compile and the installer would choke.)
1352    
1353    ----------------------------------------------------------------------
1354    Name: Matthias Blume
1355    Date: 2002/02/13 16:15:00 EST
1356    Tag: blume-20020213-various
1357    Description:
1358    
1359    1. More tweaks to ml-nlffigen:
1360    
1361       - better internal datastructures (resulting in slight speedup)
1362       - "-match" option requires exact match
1363       - "localized" gensym counters (untagged structs/unions nested within
1364         other structs/unions or within typedefs get a fresh counter; their
1365         tag will be prefixed by a concatenation of their parents' tags)
1366       - bug fixes (related to calculation of transitive closure of types
1367         to be included in the output)
1368    
1369    2. Minor Basis updates:
1370    
1371       - added implementations for List.collate and Option.app
1372    
1373    ----------------------------------------------------------------------
1374    Name: Matthias Blume
1375    Date: 2002/02/11 15:55:00 EST
1376    Tag: blume-20020211-gensym
1377    Description:
1378    
1379    Added a "-gensym" option to command line of ml-nlffigen.  This can be
1380    used to specify a "stem" -- a string that is inserted in all "gensym'd"
1381    names (ML structure names that correspond to unnamed C structs, unions,
1382    and enums), so that separate runs of ml-nlffigen do not clash.
1383    
1384    ----------------------------------------------------------------------
1385    Name: Matthias Blume
1386    Date: 2002/02/11 12:05:00 EST
1387    Tag: blume-20020211-gensml
1388    Description:
1389    
1390    A quick fix for a problem with GenSML (in the pgraph-util library):
1391    Make generation of toplevel "local" optional.  (Strictly speaking,
1392    signature definitions within "local" are not legal SML.)
1393    
1394    Other than that: updates to INSTALL and cm/TODO.
1395    
1396    ----------------------------------------------------------------------
1397    Name: Matthias Blume
1398    Date: 2002/02/08 15:00:00 EST
1399    Tag: blume-20020208-uniquepid
1400    Description:
1401    
1402    0. Version number has been bumped to 110.38.1.  NEW BOOTFILES!!!
1403    
1404    1. The installer (config/install.sh) has gotten smarter:
1405    
1406         - Configuration options are a bit easier to specify now
1407           (in config/targets).
1408         - Bug in recognizing .tar.bz2 files fixed.
1409         - Installer automatically resolves dependencies between
1410           configuration options (e.g., if you ask for eXene, you will
1411           also get cml -- regardless whether you asked for it or not).
1412         - Installer can run in "quieter mode" by setting the environment
1413           variable INSTALL_QUIETLY to "true".  "Quieter" does not mean
1414           "completely silent", though.
1415         - Build HashCons library as part of smlnj-lib.
1416    
1417    2. A new scheme for assigning persistent identifiers to compilation
1418       units (and, by extension, to types etc.) has been put into place.
1419       This fixes a long-standing bug where types and even dynamic values
1420       can get internally confused, thereby compromising type safety
1421       (abstraction) and dynamic correctness.  See
1422    
1423         http://cm.bell-labs.com/cm/cs/who/blume/pid-confusion.tgz
1424    
1425       for an example of how things could go wrong until now.
1426    
1427       The downside of the new scheme is that pids are not quite as
1428       persistent as they used to be: CM will generate a fresh pid
1429       for every compilation unit that it thinks it sees for the first
1430       time.  That means that if you compile starting from a clean, fresh
1431       source tree at two different times, you end up with different
1432       binaries.
1433    
1434       Cutoff recompilation, however, has not been compromised because
1435       CM keeps pid information in special caches between runs.
1436    
1437    ----------------------------------------------------------------------
1438    Name: Lal George
1439    Date: 2002/02/07 15:34:13 EST 2002
1440    Tag: <none>
1441    Description:
1442    
1443    Compilers that generate assembly code may produce  global labels
1444    whose value is resolved at link time. The various peephole optimization
1445    modules did not take this in account.
1446    
1447    TODO. The Labels.addrOf function should really return an option
1448    type so that clients are forced to deal with this issue, rather
1449    than an exception being raised.
1450    
1451    ----------------------------------------------------------------------
1452    Name: Lal George
1453    Date: 2002/02/06 13:55:02 EST
1454    Tag: george-20020206-ra-breakup
1455    Description:
1456    
1457    1. A bug fix from Allen.
1458    
1459        A typo causes extra fstp %st(0)'s to be generated at compensation
1460        edges, which might cause stack underflow traps at runtime.  This
1461        occurs in fft where there are extraneous fstps right before the 'into'
1462        trap instruction (in this case they are harmless since none of the
1463        integers overflow.)
1464    
1465    2. Pulled out various utility modules that were embedded in the modules
1466       of the register allocator. I need these modules for other purposes, but
1467       they are not complete enough to put into a library (just yet).
1468    ----------------------------------------------------------------------
1469    Name: Matthias Blume
1470    Date: 2002/01/31 16:05:00 EST
1471    Tag: blume-20020131-sparc-ccalls
1472    Description:
1473    
1474    1. C-calls on Sparc needlessly allocated a huge chunk (96 bytes)
1475       of extra stack space by mistake.  Fixed.
1476    
1477    2. Bug in logic of handling of command-line options in ml-nlffigen fixed.
1478    
1479    ----------------------------------------------------------------------
1480    Name: Allen Leung
1481    Date: 2002/01/30
1482    Tag: leunga-20020130-nowhere-bug-fix
1483    Description:
1484    
1485       MLRISC bug fixes:
1486       1. Fixed a bindings computation bug in the 'nowhere' program generator tool.
1487       2. MachineInt.fromString was negating its value.
1488    
1489    ----------------------------------------------------------------------
1490    Name: Matthias Blume
1491    Date: 2002/01/29
1492    Tag: blume-20020129-INSTALL
1493    Description:
1494    
1495    - Added somewhat detailed installation instructions (file INSTALL).
1496    - Fixed curl-detection bug in config/install.sh.
1497    - It is now possible to select the URL getter using the URLGETTER
1498      environment variable:
1499    
1500          not set / "unknown"      --> automatic detection (script tries wget,
1501                                       curl, and lynx)
1502          "wget" / "curl" / "lynx" --> use the specified program (script "knows"
1503                                       how to properly invoke them)
1504          other                    --> use $URLGETTER directly, it must take
1505                                       precisely two command-line arguments
1506                                       (source URL and destination file name)
1507    
1508    ----------------------------------------------------------------------
1509    Name: Matthias Blume
1510    Date: 2002/01/28
1511    Tag: blume-20020128-sparc-ccalls
1512    Description:
1513    
1514    - Fixed problem with calculation of "used" registers in sparc-c-calls.
1515    - Make use of the allocParam argument in sparc-c-calls.
1516    
1517    ----------------------------------------------------------------------
1518    Name: Matthias Blume
1519    Date: 2002/01/28
1520    Tag: blume-20020128-allocParam
1521    Description:
1522    
1523    John Reppy:  Changes c-calls API to accept client-callback for
1524    allocating extra stack space.
1525    me: Corresponding changes to mlriscGen (using a dummy argument that
1526        does not change the current behavior).
1527    
1528    ----------------------------------------------------------------------
1529    Name: Matthias Blume
1530    Date: 2002/01/28 12:00:00
1531    Tag: Release_110_38
1532    Description:
1533    
1534    This time for real!!!
1535    
1536    ----------------------------------------------------------------------
1537    Name: Matthias Blume
1538    Date: 2002/01/28 10:56:00 EST
1539    Tag: blume-20020128-retraction
1540    Description:
1541    
1542    0. Retracted earlier 110.38.  (The Release_110_38 tag has been replaced
1543       with blume-Release_110_38-retracted.)
1544    
1545    1. Fixed a problem with incorrect rounding modes in real64.sml.
1546       (Thanks to Andrew Mccreight <andrew.mccreight@yale.edu>.)
1547    
1548    2. A bug in ml-nlffigen related to the handling of unnamed structs, unions,
1549       and enums fixed.  The naming of corresponding ML identifiers should
1550       now be consistent again.
1551    
1552    ----------------------------------------------------------------------
1553    Name: Allen Leung
1554    Date: 2002/01/27
1555    Tag: leunga-20020127-nowhere
1556    Description:
1557    
1558       Added a target called nowhere in the configuration scripts.
1559       Enabling this will build the MLRISC 'nowhere' tool (for translating
1560       programs with where-clauses into legal SML code) during installation.
1561    
1562    ----------------------------------------------------------------------
1563    Name: Matthias Blume
1564    Date: 2002/01/25 21:27:00 EST
1565    Tag: blume-Release_110_38-retracted
1566    Description:
1567    
1568    Call it a (working) release!  Version is 110.38. Bootfiles are ready.
1569    
1570    README will be added later.
1571    
1572    !!! NOTE:  Re-tagged as blume-Release_110_38-retracted. Original tag
1573    (Release_110_38) removed.  Reason: Last-minute bug fixes.
1574    
1575    ----------------------------------------------------------------------
1576    Name: Matthias Blume
1577    Date: 2002/01/25
1578    Tag: blume-20020125-ffi
1579    Description:
1580    
1581    A large number of tweaks and improvements to ml-nlffi-lib and
1582    ml-nlffigen:
1583    
1584       - ML represenation types have been streamlined
1585       - getter and setter functions work with concrete values, not abstract
1586         ones where possible
1587       - ml-nlffigen command line more flexible (see README file there)
1588       - some bugs have been fixed (hopefully)
1589    
1590    ----------------------------------------------------------------------
1591    Name: Lal George
1592    Date: 2002/01/24
1593    Tag: george-20020124-risc-ra-interface
1594    Description:
1595    
1596       There is a dramatic simplification in the interface to the
1597       register allocator for RISC architectures as a result of making
1598       parallel copy instructions explicit.
1599    
1600    ----------------------------------------------------------------------
1601    Name: Matthias Blume
1602    Date: 2002/01/22
1603    Tag: blume-20020122-x86-ccalls
1604    Description:
1605    
1606    Bug fix for c-calls on x86 (having to do with how char- and
1607    short-arguments are being handled).
1608    
1609    ----------------------------------------------------------------------
1610    Name: Matthias Blume
1611    Date: 2002/01/21
1612    Tag: blume-20020121-ff
1613    Description:
1614    
1615    Another day of fiddling with the FFI...
1616    
1617    1. Bug fix/workaround:  CKIT does not complain about negative array
1618       dimensions, so ml-nlffigen has to guard itself against this possibility.
1619       (Otherwise a negative dimension would send it into an infinite loop.)
1620    
1621    2. Some of the abstract types (light objects, light pointers, most "base"
1622       types) in structure C are now eqtypes.
1623    
1624    3. Added constructors and test functions for NULL function pointers.
1625    
1626    ----------------------------------------------------------------------
1627    Name: Matthias Blume
1628    Date: 2002/01/18
1629    Tag: blume-20020118-ready-for-new-release
1630    Description:
1631    
1632    Made config/srcarchiveurl point to a new place.  (Will provide boot
1633    files shortly.)
1634    
1635    Maybe we christen this to be 110.38?
1636    
1637    ----------------------------------------------------------------------
1638    Name: Matthias Blume
1639    Date: 2002/01/18
1640    Tag: blume-20020118-more-ffifiddle
1641    Description:
1642    
1643    Today's FFI fiddling:
1644    
1645      - Provided a structure CGetSet with "convenient" versions of C.Get.* and
1646        C.Set.* that use concrete (MLRep.*) arguments and results instead
1647        of abstract ones.
1648    
1649      - Provided word-style bit operations etc. for "int" representation
1650        types in MLRep.S<Foo>Bitops where <Foo> ranges over Char, Int, Short,
1651        and Long.
1652    
1653    ----------------------------------------------------------------------
1654    Name: Matthias Blume
1655    Date: 2002/01/18
1656    Tag: blume-20020118-use-x86-fp
1657    Description:
1658    
1659    Now that x86-fast-fp seems to be working, I turned it back on again
1660    by default.  (Seems to work fine now, even with the FFI.)
1661    
1662    Other than that, I added some documentation about the FFI to
1663    src/ml-nlffigen/README and updated the FFI test examples in
1664    src/ml-nlffi-lib/Tests/*.
1665    
1666    ----------------------------------------------------------------------
1667    Name: Allen Leung
1668    Date: 2002/01/17
1669    Tag: leunga-20020117-x86-fast-fp-call
1670    Description:
1671    
1672       1. Fixed a problem with handling return fp values when x86's fast fp
1673          mode is turned on.
1674    
1675       2. Minor pretty printing fix for cellset.  Print %st(0) as %st(0) instead
1676          of %f32.
1677    
1678       3. Added a constructor INT32lit to the ast of MLRISC tools.
1679    
1680    ----------------------------------------------------------------------
1681    Name: Matthias Blume
1682    Date: 2002/01/16
1683    Tag: blume-20020116-ffifiddle
1684    Description:
1685    
1686    More fiddling with the FFI interface:
1687    
1688     - Make constness 'c instead of rw wherever possible.  This eliminates
1689       the need for certain explicit coercions.  (However, due to ML's
1690       value polymorphism, there will still be many cases where explicit
1691       coercions are necessary.  Phantom types are not the whole answer
1692       to modeling a subtyping relationship in ML.)
1693    
1694     - ro/rw coersions for pointers added.  (Avoids the detour through */&.)
1695    
1696     - "printf" test example added to src/ml-nlffi-lib/Tests.  (Demonstrates
1697       clumsy workaround for varargs problem.)
1698    
1699    ----------------------------------------------------------------------
1700    Name: Lal George
1701    Date: 2002/01/15
1702    Tag: <none>
1703    Description:
1704    
1705    1. Since COPY instructions are no longer native to the architecture,
1706       a generic functor can be used to implement the expandCopies function.
1707    
1708    2. Allowed EXPORT and IMPORT pseudo-op declarations to appear inside a
1709       TEXT segment.
1710    
1711    ----------------------------------------------------------------------
1712    Name: Matthias Blume
1713    Date: 2002/01/15
1714    Tag: blume-20020115-ffiupdates
1715    Description:
1716    
1717    1. Fix for bug resulting in single-precision float values being returned
1718       incorrectly from FFI calls.
1719    
1720    2. Small modifications to C FFI API:
1721    
1722        - memory-allocation routines return straight objects (no options)
1723          and raise an exception in out-of-memory situations
1724        - unsafe extensions to cast between function pointers and pointers
1725          from/to ints
1726        - added structure C_Debug as an alternative to structure C where
1727          pointer-dereferencing (|*| and |*!) always check for null-pointers
1728        - added open_lib' to DynLinkage;  open_lib' works like open_lib
1729          but also takes a (possibly empty) list of existing library handles
1730          that the current library depends on
1731    
1732    ----------------------------------------------------------------------
1733    Name: Matthias Blume
1734    Date: 2002/01/10
1735    Tag: blume-20020110-newffigen
1736    Description:
1737    
1738    1. Updates to portable graph code.
1739    
1740    2. Major update to ml-nlffigen and ml-nlffi-lib.  Things are much
1741       more scalable now so that even huge interfaces such as the one
1742       for GTK compile in finite time and space. :-)
1743       See src/ml-nlffigen/README for details on what's new.
1744    
1745    ----------------------------------------------------------------------
1746    Name: Lal George
1747    Date: 2001/01/09 14:31:35 EST 2002
1748    Tag: george-20011206-rm-native-copy
1749    Description:
1750    
1751            Removed the native COPY and FCOPY instructions
1752            from all the architectures and replaced it with the
1753            explicit COPY instruction from the previous commit.
1754    
1755            It is now possible to simplify many of the optimizations
1756            modules that manipulate copies. This has not been
1757            done in this change.
1758    
1759    ----------------------------------------------------------------------
1760    Name: Lal George
1761    Date: 2001/12/06 16:50:13 EST 2001
1762    Tag: george-20011206-mlrisc-instruction
1763    Description:
1764    
1765    Changed the representation of instructions from being fully abstract
1766    to being partially concrete. That is to say:
1767    
1768      from
1769            type instruction
1770    
1771      to
1772            type instr                              (* machine instruction *)
1773    
1774            datatype instruction =
1775                LIVE of {regs: C.cellset, spilled: C.cellset}
1776              | KILL of {regs: C.cellset, spilled: C.cellset}
1777              | COPYXXX of {k: CB.cellkind, dst: CB.cell list, src: CB.cell list}
1778              | ANNOTATION of {i: instruction, a: Annotations.annotation}
1779              | INSTR of instr
1780    
1781    This makes the handling of certain special instructions that appear on
1782    all architectures easier and uniform.
1783    
1784    LIVE and KILL say that a list of registers are live or killed at the
1785    program point where they appear. No spill code is generated when an
1786    element of the 'regs' field is spilled, but the register is moved to
1787    the 'spilled' (which is present, more for debugging than anything else).
1788    
1789    LIVE replaces the (now deprecated) DEFFREG instruction on the alpha.
1790    We used to generate:
1791    
1792            DEFFREG f1
1793            f1 := f2 + f3
1794            trapb
1795    
1796    but now generate:
1797    
1798            f1 := f2 + f3
1799            trapb
1800            LIVE {regs=[f1,f2,f3], spilled=[]}
1801    
1802    Furthermore, the DEFFREG (hack) required that all floating point instruction
1803    use all registers mentioned in the instruction. Therefore f1 := f2 + f3,
1804    defines f1 and uses [f1,f2,f3]! This hack is no longer required resulting
1805    in a cleaner alpha implementation. (Hopefully, intel will not get rid of
1806    this architecture).
1807    
1808    COPYXXX is intended to replace the parallel COPY and FCOPY  available on
1809    all the architectures. This will result in further simplification of the
1810    register allocator that must be aware of them for coalescing purposes, and
1811    will also simplify certain aspects of the machine description that provides
1812    callbacks related to parallel copies.
1813    
1814    ANNOTATION should be obvious, and now INSTR represents the honest to God
1815    machine instruction set!
1816    
1817    The <arch>/instructions/<arch>Instr.sml files define certain utility
1818    functions for making porting easier -- essentially converting upper case
1819    to lower case. All machine instructions (of type instr) are in upper case,
1820    and the lower case form generates an MLRISC instruction. For example on
1821    the alpha we have:
1822    
1823      datatype instr =
1824         LDA of {r:cell, b:cell, d:operand}
1825       | ...
1826    
1827      val lda : {r:cell, b:cell, d:operand} -> instruction
1828        ...
1829    
1830    where lda is just (INSTR o LDA), etc.
1831    
1832    ----------------------------------------------------------------------
1833    Name: Matthias Blume
1834    Date: 2001/11/22 21:40:00 EST
1835    Tag: Release_110_37
1836    Description:
1837    
1838    Release 110.37.  This time for real.
1839    
1840    ----------------------------------------------------------------------
1841    Name: Matthias Blume
1842    Date: 2001/11/21 16:35:00 EST
1843    Tag: blume-20011121-foot-in-mouth
1844    Description:
1845    
1846    Removed the "Release_110_37" tag because of a serious bug.
1847    This will be re-tagged once the bug is fixed.
1848    
1849    ----------------------------------------------------------------------
1850    Name: Matthias Blume
1851    Date: 2001/11/21 16:14:00 EST
1852    Tag: blume-20011121-forgottenfile
1853    Description:
1854    
1855    Forgot to add a file.  (Just a .tex-file -- part of
1856    the CM manual source.)
1857    
1858    ----------------------------------------------------------------------
1859    Name: Matthias Blume
1860    Date: 2001/11/21 16:10:00 EST
1861    Tag: blume-20011121-invalid_110_37
1862    Description:
1863    
1864    Note: I removed the original tag "Release_110_37" from this commit
1865          because we found a serious bug in all non-x86 backends.
1866          - Matthias
1867    
1868    1. Modifications to the SML/NJ code generator and to the runtime system
1869       so that code object name strings are directly inserted into code
1870       objects at code generation time.  The only business the runtime system
1871       has with this is now to read the name strings on occasions.
1872       (The encoding of the name string has also changed somewhat.)
1873    
1874    2. CM now implements a simple "set calculus" for specifying export lists.
1875       In particular, it is now possible to refer to the export lists of
1876       other libraries/groups/sources and form unions as well as differences.
1877       See the latest CM manual for details.
1878    
1879    3. An separate notion of "proxy" libraries has again be eliminated from
1880       CM's model.  (Proxy libraries are now simply a special case of using
1881       the export list calculus.)
1882    
1883    4. Some of the existing libraries now take advantage of the new set
1884       calculus.
1885       (Notice that not all libraries have been converted because some
1886       of the existing .cm-files are supposed to be backward compatible
1887       with 110.0.x.)
1888    
1889    5. Some cleanup in stand-alone programs.  (Don't use "exnMessage" -- use
1890       "General.exnMessage"!  The former relies on a certain hook to be
1891       initialized, and that often does not happen in the stand-alone case.)
1892    
1893    ----------------------------------------------------------------------
1894    Name: Lal George
1895    Date: 2001/11/21  13:56:18 EST
1896    Tag: george-2001121-pseudo-ops
1897    Description:
1898    
1899      Implemented a complete redesign of MLRISC pseudo-ops. Now there
1900      ought to never be any question of incompatabilities with
1901      pseudo-op syntax expected by host assemblers.
1902    
1903      For now, only modules supporting GAS syntax are implemented
1904      but more should follow, such as MASM, and vendor assembler
1905      syntax, e.g. IBM as, Sun as, etc.
1906    
1907    ----------------------------------------------------------------------
1908    Name: Matthias Blume
1909    Date: 2001/11/14 11:52:00 EST
1910    Tag: blume-20011114-srcname
1911    Description:
1912    
1913    1. Routed the name of the current source file to mlriscgen where it
1914       should be directly emitted into the code object.  (This last part
1915       is yet to be done.)
1916    
1917    2. Some cleanup of the pgraph code to make it match the proposal that
1918       I put out the other day.  (The proposal notwithstanding, things are
1919       still in flux here.)
1920    
1921    ----------------------------------------------------------------------
1922    Name: Lal George
1923    Date: 2001/11/14 09:44:04 EST
1924    Tag:
1925    Description:
1926    
1927      Fix for a backpatching bug reported by Allen.
1928    
1929      Because the boundary between short and long span-dependent
1930      instructions is +/- 128, there are an astounding number of
1931      span-dependent instructions whose size is over estimated.
1932    
1933      Allen came up with the idea of letting the size of span
1934      dependent instructions be non-monotonic, for a maxIter
1935      number of times, after which the size must be monotonically
1936      increasing.
1937    
1938      This table shows the number of span-dependent instructions
1939      whose size was over-estimated as a function of maxIter, for the
1940      file Parse/parse/ml.grm.sml:
1941    
1942         maxIter            # of instructions:
1943            10                      687
1944            20                      438
1945            30                      198
1946            40                        0
1947    
1948      In compiling the compiler, there is no significant difference in
1949      compilation speed between maxIter=10 and maxIter=40. Actually,
1950      my measurements showed that maxIter=40 was a tad faster than
1951      maxIter=10! Also 96% of the  files in the compiler reach a fix
1952      point within 13 iterations, so fixing maxIter at 40, while high,
1953      is okay.
1954    
1955    ----------------------------------------------------------------------
1956    Name: Matthias Blume
1957    Date: 2001/10/31 15:25:00 EST
1958    Tag: blume-20011031-pgraph
1959    Description:
1960    
1961    CKIT:
1962    * Changed the "Function" constructor of type Ast.ctype to carry optional
1963      argument identifiers.
1964    * Changed the return type of TypeUtil.getFunction accordingly.
1965    * Type equality ignores the argument names.
1966    * TypeUtil.composite tries to preserve argument names but gives up quickly
1967      if there is a mismatch.
1968    
1969    installation script:
1970    * attempts to use "curl" if available (unless "wget" is available as well)
1971    
1972    CM:
1973    * has an experimental implementation of "portable graphs" which I will
1974      soon propose as an implementation-independent library format
1975    * there are also new libraries $/pgraph.cm and $/pgraph-util.cm
1976    
1977    NLFFI-LIB:
1978    * some cleanup (all cosmetic)
1979    
1980    NLFFIGEN:
1981    * temporarily disabled the mechanism that suppresses ML output for
1982      C definitions whose identifiers start with an underscore character
1983    * generate val bindings for enum constants
1984    * user can request that only one style (light or heavy) is being used;
1985      default is to use both (command-line arguments: -heavy and -light)
1986    * fixed bug in handling of function types involving incomplete pointers
1987    * generate ML entry points that take record arguments (i.e., using
1988      named arguments) for C functions that have a prototype with named
1989      arguments
1990      (see changes to CKIT)
1991    
1992    ----------------------------------------------------------------------
1993    Name: Allen Leung
1994    Date: 2001/10/27 20:34:00 EDT
1995    Tag: leunga-20011027-x86-fast-fp-call
1996    Description:
1997    
1998       Fixed the bug described in blume-20010920-slowfp.
1999    
2000       The fix involves
2001          1. generating FCOPYs in FSTP in ia32-svid
2002          2. marking a CALL with the appropriate annotation
2003    
2004    ----------------------------------------------------------------------
2005    Name: Matthias Blume
2006    Date: 2001/10/16 11:32:00 EDT
2007    Tag: blume-20011016-netbsd
2008    Description:
2009    
2010    Underscore patch from Chris Richards (fixing problem with compiling
2011    runtime system under recent NetBSD).
2012    
2013    ----------------------------------------------------------------------
2014    Name: Allen Leung
2015    Date: 2001/10/12 17:18:32 EDT 2001
2016    Tag: leung-20011012-x86-printflowgraph
2017    Description:
2018    
2019    X86RA now uses a valid (instead of dummy) PrintFlowgraph module.
2020    
2021    ----------------------------------------------------------------------
2022    Name: Lal George
2023    Date: 2001/10/11 23:51:34 EDT
2024    Tag: george-20011011-too-many-instrs
2025    Description:
2026    
2027    The representation of a program point never expected to see more
2028    than 65536 instructions in a basic block!
2029    
2030    ----------------------------------------------------------------------
2031    Name: Lal George
2032    Date: 2001/10/09 09:41:37 EDT
2033    Tag: george-20011008-mlrisc-labels
2034    Description:
2035    
2036    Changed the machine description files to support printing of
2037    local and global labels in assembly code, based on host assembler
2038    conventions.
2039    
2040    ----------------------------------------------------------------------
2041    Name: Matthias Blume
2042    Date: 2001/09/25 15:25:00 EDT
2043    Tag: blume-20010925-exninfo
2044    Description:
2045    
2046    I provided a non-hook implementation of exnName (at the toplevel) and
2047    made the "dummy" implementation of exnMessage (at the toplevel) more
2048    useful: if nothing gets "hooked in", then at least you are going to
2049    see the exception name and a message indicating why you don't see more.
2050    
2051    [For the time being, programs that need exnMessage and want to use
2052    ml-build should either use General.exnMessage (strongly recommended) or
2053    refer to structure General at some other point so that CM sees a
2054    static dependency.]
2055    
2056    [Similar remarks go for "print" and "use":  If you want to use their
2057    functionality in stand-alone programs generated by ml-build, then use
2058    TextIO.output and Backend.Interact.useFile (from $smlnj/compiler.cm).]
2059    
2060    ----------------------------------------------------------------------
2061    Name: Matthias Blume
2062    Date: 2001/09/20 17:28:00 EDT
2063    Tag: blume-20010920-slowfp
2064    Description:
2065    
2066    Allen says that x86-fast-fp is not safe yet, so I turned it off again...
2067    
2068    ----------------------------------------------------------------------
2069    Name: Matthias Blume
2070    Date: 2001/09/20 17:20:00 EDT
2071    Tag: blume-20010920-canonicalpaths
2072    Description:
2073    
2074    0. Updated the BOOT file (something that I forgot to do earlier).
2075    
2076    1. Small internal change to CM so that it avoids "/../" in filenames
2077       as much as possible (but only where it is safe).
2078    
2079    2. Changed config/_run-sml (resulting in a changed bin/.run-sml) so
2080       that arguments that contain delimiters are passed through correctly.
2081       This change also means that all "special" arguments of the form
2082       @SMLxxx... must come first.
2083    
2084    3. Changed install script to put relative anchor names for tool commands
2085       into pathconfig.
2086    
2087    ----------------------------------------------------------------------
2088    Name: Matthias Blume
2089    Date: 2001/09/18 15:35:00 EDT
2090    Tag: blume-20010918-readme11036
2091    Description:
2092    
2093    Added README files.
2094    
2095    ----------------------------------------------------------------------
2096    Name: Matthias Blume
2097    Date: 2001/09/18 11:45:00 EDT
2098    Tag: Release_110_36 (retag)
2099    Description:
2100    
2101    Fixed mistake in config/preloads. Retagged as 110.36.
2102    
2103    ----------------------------------------------------------------------
2104    Name: Matthias Blume
2105    Date: 2001/09/18 09:40:00 EDT
2106    Tag: Release_110_36_orig (tag changed)
2107    Description:
2108    
2109    New version (110.36).  New bootfiles.
2110    
2111    ----------------------------------------------------------------------
2112    Name: Matthias Blume
2113    Date: 2001/09/14 16:15:00 EDT
2114    Tag: blume-20010914-x86fastfp
2115    Description:
2116    
2117    John committed some changes that Allen made, in particular a (hopefully)
2118    correctly working version of the x86-fp module.
2119    
2120    I changed the default setting of the Control.MLRISC.getFlag "x86-fast-fp"
2121    flag to "true".  Everything seems to compile to a fixpoint ok, and
2122    "mandelbrot" speeds up by about 15%.
2123    
2124    ----------------------------------------------------------------------
2125    Name: Matthias Blume
2126    Date: 2001/09/13 11:20:00 EDT
2127    Tag: blume-20010913-minimal
2128    Description:
2129    
2130    1. Stefan Monnier's patch to fix a miscompilation problem that
2131       was brought to light by John Reppy's work on Moby.
2132    
2133    2. Implemented a minimal "structure Compiler" that contains just
2134       "version" and "architecture".  The minimal version will be
2135       available when the full version is not.  This is for backward-
2136       compatibility with code that wants to test Compiler.version.
2137    
2138    ----------------------------------------------------------------------
2139    Name: Matthias Blume
2140    Date: 2001/08/28 14:03:00 EDT
2141    Tag: blume-20010828-ml-lex
2142    Description:
2143    
2144    Fix for bug 1581, received from Neophytos Michael.
2145    
2146    ----------------------------------------------------------------------
2147    Name: Matthias Blume
2148    Date: 2001/08/27 11:20:00 EDT
2149    Tag: blume-20010827-readme11035
2150    Description:
2151    
2152    Fleshed out the README file for 110.35.
2153    
2154    ----------------------------------------------------------------------
2155    Name: Matthias Blume
2156    Date: 2001/08/24 17:10:00 EDT
2157    Tag: Release_110_35
2158    Description:
2159    
2160    New version number (110.35).  New bootfiles.
2161    
2162    ----------------------------------------------------------------------
2163    Name: Lal George
2164    Date: 2001/08/24 13:47:18 EDT 2001
2165    Tag: george-20010824-MLRISC-graphs
2166    Description:
2167    
2168     removed clusters from MLRISC completely and replaced with graphs.
2169    
2170    ----------------------------------------------------------------------
2171    Name: Matthias Blume
2172    Date: 2001/08/23 17:50:00 EDT
2173    Tag: blume-20010823-toplevel
2174    Description:
2175    
2176    - some reorganization of the code that implements various kinds of
2177      environments in the compiler (static, dynamic, symbolic, combined)
2178    - re-implemented the EnvRef module so that evalStream works properly
2179      (if the stream contains references to "use", "CM.make", etc.)
2180    - cleaned up evalloop.sml and interact.sml (but they need more cleaning)
2181    
2182    ----------------------------------------------------------------------
2183    Name: Matthias Blume
2184    Date: 2001/08/20 15:50 EDT
2185    Tag: blume20010820-slipup
2186    Description:
2187    
2188    I forgot to commit a few files.  Here they are...
2189    
2190    ----------------------------------------------------------------------
2191    Name: Matthias Blume
2192    Date: 2001/08/20 15:35:00 EDT
2193    Tag: blume-20010820-debugprof
2194    Description:
2195    
2196    !!!! NEW BOOTFILES !!!!
2197    
2198    This is another round of reorganizing the compiler sources.  This
2199    time the main goal was to factor out all the "instrumentation"
2200    passes (for profiling and backtracing) into their own library.
2201    The difficulty was to do it in such a way that it does not depend
2202    on elaborate.cm but only on elabdata.cm.
2203    
2204    Therefore there have been further changes to both elaborate.cm and
2205    elabdata.cm -- more "generic" things have been moved from the former
2206    to the latter.  As a result, I was forced to split the assignment
2207    of numbers indicating "primtyc"s into two portions: SML-generic and
2208    SML/NJ-specific.  Since it would have been awkward to maintain,
2209    I bit the bullet and actually _changed_ the mapping between these
2210    numbers and primtycs.  The bottom line of this is that you need
2211    a new set of bin- and bootfiles.
2212    
2213    I have built new bootfiles for all architectures, so doing a fresh
2214    checkout and config/install.sh should be all you need.
2215    
2216    The newly created library's name is
2217    
2218        $smlnj/viscomp/debugprof.cm
2219    
2220    and its sources live under
2221    
2222        src/compiler/DebugProf
2223    
2224    ----------------------------------------------------------------------
2225    Name: Matthias Blume
2226    Date: 2001/08/15 17:15:00 EDT
2227    Tag: blume-20010815-compreorg
2228    Description:
2229    
2230    This is a first cut at reorganizing the CM libraries that make up the
2231    core of the compiler.  The idea is to separate out pieces that could
2232    be used independently by tools, e.g., the parser, the typechecker, etc.
2233    
2234    The current status is a step in this direction, but it is not quite
2235    satisfactory yet.  Expect more changes in the future.
2236    
2237    Here is the current (new) organization...
2238    
2239        What used to be $smlnj/viscomp/core.cm is now divided into
2240        six CM libraries:
2241    
2242             $smlnj/viscomp/basics.cm
2243                           /parser.cm
2244                           /elabdata.cm
2245                           /elaborate.cm
2246                           /execute.cm
2247                           /core.cm
2248    
2249        The CM files for these libraries live under src/system/smlnj/viscomp.
2250        All these libraries are proxy libraries that contain precisely
2251        one CM library component.  Here are the locations of the components
2252        (all within the src/compiler tree):
2253    
2254             Basics/basics.cm
2255             Parse/parser.cm
2256             ElabData/elabdata.cm
2257             Elaborator/elaborate.cm
2258             Execution/execute.cm
2259             core.cm
2260    
2261         [This organization is the same that has been used already
2262         for a while for the architecture-specific parts of the visible
2263         compiler and for the old version of core.cm.]
2264    
2265         As you will notice, many source files have been moved from their
2266         respective original locations to a new home in one of the above
2267         subtrees.
2268    
2269         The division of labor between the new libraries is the following:
2270    
2271             basics.cm:
2272                - Simple, basic definitions that pertain to many (or all) of
2273                  the other libraries.
2274             parser.cm:
2275                - The SML parser, producing output of type Ast.dec.
2276                - The type family for Ast is also defined and exported here.
2277             elabdata.cm:
2278                - The datatypes that describe input and output of the elaborator.
2279                  This includes types, absyn, and static environments.
2280             elaborator.cm:
2281                - The SML/NJ type checker and elaborator.
2282                  This maps an Ast.dec (with a given static environment) to
2283                  an Absyn.dec (with a new static environment).
2284                - This libraries implements certain modules that used to be
2285                  structures as functors (to remove dependencies on FLINT).
2286             execute.cm:
2287                - Everything having to do with executing binary code objects.
2288                - Dynamic environments.
2289             core.cm:
2290                - SML/NJ-specific instantiations of the elaborator and MLRISC.
2291                - Top-level modules.
2292                - FLINT (this should eventually become its own library)
2293    
2294    Notes:
2295    
2296    I am not 100% happy with the way I separated the elaborator (and its
2297    data structures) from FLINT.  Two instances of the same problem:
2298    
2299        1. Data structures contain certain fields that carry FLINT-specific
2300           information.  I hacked around this using exn and the property list
2301           module from smlnj-lib.  But the fact that there are middle-end
2302           specific fields around at all is a bit annoying.
2303    
2304        2. The elaborator calculates certain FLINT-related information.  I tried
2305           to make this as abstract as I could using functorization, but, again,
2306           the fact that the elaborator has to perform calculations on behalf
2307           of the middle-end at all is not nice.
2308    
2309        3. Having to used exn and property lists is unfortunate because it
2310           weakens type checking.  The other alternative (parameterizing
2311           nearly *everything*) is not appealing, though.
2312    
2313    I removed the "rebinding =" warning hack because due to the new organization
2314    it was awkward to maintain it.  As a result, the compiler now issues some of
2315    these warnings when compiling init.cmi during bootstrap compilation. On
2316    the plus side, you also get a warning when you do, for example:
2317       val op = = Int32.+
2318    which was not the case up to now.
2319    
2320    I placed "assign" and "deref" into the _Core structure so that the
2321    code that deals with the "lazy" keyword can find them there.  This
2322    removes the need for having access to the primitive environment
2323    during elaboration.
2324    
2325    ----------------------------------------------------------------------
2326    Name: Matthias Blume
2327    Date: 2001/08/13
2328    Tag: blume-20010813-closures
2329    Description:
2330    
2331    This fix was sent to us by Zhong Shao.  It is supposed to improve the
2332    performance of certain loops by avoiding needless closure allocation.
2333    
2334    ----------------------------------------------------------------------
2335    Name: Lal George
2336    Date: 2001/07/31 10:03:23 EDT 2001
2337    Tag: george-20010731-x86-fmalloc
2338    Description: Fixed bug in x86 calls
2339    
2340        There was a bug where call instructions would mysteriously
2341        vanish. The call instruction had to be one that returned
2342        a floating point value.
2343    
2344    ----------------------------------------------------------------------
2345    Name: Lal George
2346    Date: 2001/07/19 16:36:29 EDT 2001
2347    Tag: george-20010719-simple-cells
2348    Description:
2349    
2350    I have dramatically simplified the interface for CELLS in MLRISC.
2351    
2352    In summary, the cells interface is broken up into three parts:
2353    
2354      1. CellsBasis : CELLS_BASIS
2355    
2356            CellsBasis is a top level structure and common for all
2357            architectures.  it contains the definitions of basic datatypes
2358            and utility  functions over these types.
2359    
2360      2. functor Cells() : CELLS
2361    
2362            Cells generates an interface for CELLS that incorporates the
2363            specific resources on the target architecture, such as the
2364            presence of special register classes, their number and size,
2365            and various useful substructures.
2366    
2367      3. <ARCH>CELLS
2368    
2369            e.g. SparcCells: SPARCCELLS
2370    
2371            <ARCH>CELLS usually contains additional bindings for special
2372            registers  on the architecture, such as:
2373    
2374                    val r0 : cell           (* register zero *)
2375                    val y : cell            (* Y register *)
2376                    val psr : cell          (* processor status register *)
2377                    ...
2378    
2379            The structure returned by applying the Cells functor is opened
2380            in this interface.
2381    
2382    The main implication of all this is that the datatypes for cells is
2383    split between CellsBasis and CELLS -- a fairly simple change for user
2384    code.
2385    
2386    In the old scheme the CELLS interface had a definitional binding of
2387    the form:
2388    
2389            signature CELLS = sig
2390    
2391               structure CellsBasis = CellsBasis
2392    
2393               ...
2394    
2395            end
2396    
2397    With all the sharing constraints that goes on in MLRISC, this old
2398    design  quickly leads to errors such as:
2399    
2400            "structure definition spec inside of sharing ... "
2401    
2402    
2403    and appears to require an unacceptable amount of sharing and where
2404    constraint hackery.
2405    
2406    I think this error message (the interaction of definitional specs and
2407    sharing) requires more explanation on our web page.
2408    
2409    ----------------------------------------------------------------------
2410    Name: Matthias Blume
2411    Date: 2001/07/19 15:00:00 EDT
2412    Tag: blume-20010719-libreorg
2413    Description:
2414    
2415    This update puts together a fairly extensive but straightforward change
2416    to the way the libraries that implement the interactive system are
2417    organized:
2418    
2419       The biggest change is the elimination of structure Compiler.  As a
2420       replacement for this structure, there is now a CM library
2421       (known as $smlnj/compiler.cm or $smlnj/compiler/current.cm)
2422       that exports all the substructures of the original structure Compiler
2423       directly.  So instead of saying Compiler.Foo.bar one now simply
2424       says Foo.bar.  (The CM libraries actually export a collection of
2425       structures that is richer than the collection of substructures of
2426       structure Compiler.)
2427    
2428       To make the transition smooth, there is a separate library called
2429       $smlnj/compiler/compiler.cm which puts together and exports the
2430       original structure Compiler (or at least something very close to it).
2431    
2432       There are five members of the original structure Compiler
2433       that are not exported directly but which instead became members
2434       of a new structure Backend (described by signature BACKEND).  These are:
2435       structure Profile (: PROFILE), structure Compile (: COMPILE), structure
2436       Interact (: INTERACT), structure Machine (: MACHINE), and val
2437       architecture (: string).
2438    
2439       Structure Compiler.Version has become structure CompilerVersion.
2440    
2441       Cross-compilers for alpha32, hppa, ppc, sparc, and x86 are provided
2442       by $smlnj/compiler/<arch>.cm where <arch> is alpha32, hppa, ppc, sparc,
2443       or x86, respectively.
2444       Each of these exports the same frontend structures that
2445       $smlnj/compiler.cm exports.  But they do not have a structure Backend
2446       and instead export some structure <Arch>Backend where <Arch> is Alpha32,
2447       Hppa, PPC, Sparc, or X86, respectively.
2448    
2449       Library $smlnj/compiler/all.cm exports the union of the exports of
2450       $smlnj/compiler/<arch>.cm
2451    
2452       There are no structures <Arch>Compiler anymore, use
2453       $smlnj/compiler/<arch>.cm instead.
2454    
2455       Library host-compiler-0.cm is gone.  Instead, the internal library
2456       that instantiates CM is now called cm0.cm.  Selection of the host
2457       compiler (backend) is no longer done here but. (Responsibility for it
2458       now lies with $smlnj/compiler/current.cm.  This seems to be more
2459       logical.)
2460    
2461       Many individual files have been moved or renamed.  Some files have
2462       been split into multiple files, and some "dead" files have been deleted.
2463    
2464    Aside from these changes to library organization, there are also changes
2465    to the way the code itself is organized:
2466    
2467       Structure Binfile has been re-implemented in such a way that it no
2468       longer needs any knowledge of the compiler.  It exclusively deals
2469       with the details of binfile layout.  It no longer invokes the
2470       compiler (for the purpose of creating new prospective binfile
2471       content), and it no longer has any knowledge of how to interpret
2472       pickles.
2473    
2474       Structure Compile (: COMPILE) has been stripped down to the bare
2475       essentials of compilation.  It no longer deals with linking/execution.
2476       The interface has been cleaned up considerably.
2477    
2478       Utility routines for dealing with linking and execution have been
2479       moved into their own substructures.
2480    
2481       (The ultimate goal of these changes is to provide a light-weight
2482       binfile loader/linker (at least for, e.g., stable libraries) that
2483       does not require CM or the compiler to be present.)
2484    
2485    CM documentation has been updated to reflect the changes to library
2486    organization.
2487    
2488    ----------------------------------------------------------------------
2489    Name: Matthias Blume
2490    Date: 2001/07/10 17:30:00 EDT
2491    Tag: Release_110_34
2492    Description:
2493    
2494    Minor tweak to 110.34 (re-tagged):
2495    
2496      - README.html file added to CVS repository
2497      - runtime compiles properly under FreeBSD 3.X and 4.X
2498    
2499    ----------------------------------------------------------------------
2500    Name: Matthias Blume
2501    Date: 2001/07/10 17:30:00 EDT
2502    Tag: Release_110_34
2503    Description:
2504    
2505    New version number (110.34). New bootfiles.
2506    
2507    ----------------------------------------------------------------------
2508    Name: Matthias Blume
2509    Date: 2001/07/09 16:00:00 EDT
2510    Tag: blume-20010709-more-varargs
2511    Description:
2512    
2513    I changed the handling of varargs in ml-nlffigen again:
2514    The ellipsis ... will now simply be ignored (with an accompanying warning).
2515    
2516    The immediate effect is that you can actually call a varargs function
2517    from ML -- but you can't actually supply any arguments beyond the ones
2518    specified explicitly.  (For example, you can call printf with its format
2519    string, but you cannot pass additional arguments.)
2520    
2521    This behavior is only marginally more useful than the one before, but
2522    it has the advantage that a function or, more importantly, a function
2523    type never gets dropped on the floor, thus avoiding follow-up problems with
2524    other types that refer to the offending one.
2525    
2526    ----------------------------------------------------------------------
2527    Name: Matthias Blume
2528    Date: 2001/07/09 11:25:00 EDT
2529    Tag: blume-20010709-varargs
2530    Description:
2531    
2532    1. ckit-lib.cm now exports structure Error
2533    2. ml-nlffigen reports occurences of "..." (i.e., varargs function types)
2534       with a warning accompanied by a source location.  Moreover, it
2535       merely skips the offending function or type and proceeds with the
2536       rest of its work.u  As a result, one can safely feed C code containing
2537       "..." to ml-nlffigen.
2538    3. There are some internal improvements to CM, providing slightly
2539       more general string substitutions in the tools subsystem.
2540    
2541    ----------------------------------------------------------------------
2542    Name: Matthias Blume
2543    Date: 2001/06/27 15:10:00 EDT
2544    Tag: blume-20010627-concur
2545    Description:
2546    
2547    Fixed a small bug in CM's handling of parallel compilation.
2548    (You could observe the bug by Control-C-interrupting an ordinary
2549    CMB.make or CM.stabilize and then attaching some compile servers.
2550    The result was that all of a sudden the previously interrupted
2551    compilation would continue on its own.  This was because of
2552    an over-optimization: CM did not bother to clean out certain queues
2553    when no servers were attached "anyway", resulting in the contents
2554    of these queues to grab control when new servers did get attached.)
2555    
2556    There is also another minor update to the CM manual.
2557    
2558    ----------------------------------------------------------------------
2559    Name: Matthias Blume
2560    Date: 2001/06/26 16:15:00 EDT
2561    Tag: blume-20010626-cmdoc
2562    Description:
2563    
2564    Minor typo fixed in CM manual (syntax diagram for libraries).
2565    
2566    ----------------------------------------------------------------------
2567    Name: Matthias Blume
2568    Date: 2001/06/25 22:55:00 EDT
2569    Tag: blume-20010625-x86pc
2570    Description:
2571    
2572    Fixed a nasty bug in the X86 assembly code that caused signal
2573    handlers to fail (crash) randomly.
2574    
2575    ----------------------------------------------------------------------
2576    Name: Matthias Blume
2577    Date: 2001/06/25 12:05:00 EDT
2578    Tag: blume-20010625-nlffigen
2579    Description:
2580    
2581    This update fixes a number of minor bugs in ml-nlffigen as reported by
2582    Nick Carter <nbc@andrew.cmu.edu>.
2583    
2584      1. Silly but ok typedefs of the form "typedef void myvoid;" are now accepted.
2585      2. Default names for generated files are now derived from the name of
2586         the C file *without its directory*.  In particular, this causes generated
2587         files to be placed locally even if the C file is in some system directory.
2588      3. Default names for generated signatures and structures are also derived
2589         from the C file name without its directory.  This avoids silly things
2590         like "structure GL/GL".
2591         (Other silly names are still possible because ml-nlffigen does not do
2592          a thorough check of whether generated names are legal ML identifiers.
2593          When in doubt, use command line arguments to force particular names.)
2594    
2595    ----------------------------------------------------------------------
2596    Name: Matthias Blume
2597    Date: 2001/06/21 12:25:00 EDT
2598    Tag: blume-20010621-eXene
2599    Description:
2600    
2601    eXene now compiles and (sort of) works again.
2602    
2603    The library name (for version > 110.33) is $/eXene.cm.
2604    
2605    I also added an new example in src/eXene/examples/nbody.  See the
2606    README file there for details.
2607    
2608    ----------------------------------------------------------------------
2609    Name: Matthias Blume
2610    Date: 2001/06/20 16:40:00 EDT
2611    Tag: blume-20010620-cml
2612    Description:
2613    
2614    CML now compiles and works again.
2615    
2616    Libraries (for version > 110.33):
2617    
2618      $cml/cml.cm            Main CML library.
2619      $cml/basis.cm          CML's version of $/basis.cm.
2620      $cml/cml-internal.cm   Internal helper library.
2621      $cml/core-cml.cm       Internal helper library.
2622      $cml-lib/trace-cml.cm  Tracing facility.
2623      $cml-lib/smlnj-lib.cm  CML's version of $/smlnj-lib.cm
2624    
2625    The installer (config/install.sh) has been taught how to properly
2626    install this stuff.
2627    
2628    ----------------------------------------------------------------------
2629    Name: Matthias Blume
2630    Date: 2001/06/19 17:55:00 EDT
2631    Tag: blume-20010619-instantiate
2632    Description:
2633    
2634    This un-breaks the fix for bug 1432.
2635    (The bug was originally fixed in 110.9 but I broke it again some
2636    time after that.)
2637    
2638    ----------------------------------------------------------------------
2639    Name: Matthias Blume
2640    Date: 2001/06/19 17:25:00 EDT
2641    Tag: blume-20010619-signals
2642    Description:
2643    
2644    This should (hopefully) fix the long-standing signal handling bug.
2645    (The runtime system was constructing a continuation record with an
2646    incorrect descriptor which would cause the GC to drop data on the floor...)
2647    
2648    ----------------------------------------------------------------------
2649    Name: Matthias Blume
2650    Date: 2001/06/15 15:05:00 EDT
2651    Tag: blume-20010615-moresparc
2652    Description:
2653    
2654    Here is a short late-hour update related to Sparc c-calls:
2655    
2656     -- made handling of double-word arguments a bit smarter
2657    
2658     -- instruction selection phase tries to collapse certain clumsily
2659        constructed ML-Trees; typical example:
2660    
2661            ADD(ty,ADD(_,e,LI d1),LI d2)  ->  ADD(ty,e,LI(d1+d2))
2662    
2663        This currently has no further impact on SML/NJ since mlriscGen does
2664        not seem to generate such patterns in the first place, and c-calls
2665        (which did generate them in the beginning) has meanwhile been fixed
2666        so as to avoid them as well.
2667    
2668    ----------------------------------------------------------------------
2669    Name: Matthias Blume
2670    Date: 2001/06/15 15:05:00 EDT
2671    Tag: blume-20010615-sparc
2672    Description:
2673    
2674    The purpose of this update is to provide an implementation of NLFFI
2675    on Sparc machines.
2676    
2677    Here are the changes in detail:
2678    
2679       * src/MLRISC/sparc/c-calls/sparc-c-calls.sml is a new file containing
2680       the Sparc implementation of the c-calls API.
2681       * The Sparc backend of SML/NJ has been modified to uniformely use %fp
2682       for accessing the ML frame.  Thus, we have a real frame pointer and
2683       can freely modify %sp without need for an omit-frame-ptr phase.
2684       The vfp logic in src/compiler/CodeGen/* has been changed to accomodate
2685       this case.
2686       * ml-nlffigen has been taught to produce code for different architectures
2687       and calling conventions.
2688       * In a way similar to what was done in the x86 case, the Sparc
2689       backend uses its own specific extension to mltree.  (For example,
2690       it needs to be able to generate UNIMP instructions which are part
2691       of the calling convention.)
2692       * ml-nlffi-lib was reorganized to make it more modular (in particular,
2693       to make it easier to plug in new machine- and os-dependent parts).
2694    
2695    There are some other fairly unrelated bug fixes and cleanups as well:
2696    
2697       * I further hacked the .cm files for MLRISC tools (like MDLGen) so
2698       that they properly share their libraries with existing SML/NJ libraries.
2699       * I fixed a minor cosmetic bug in CM, supressing certain spurious
2700       follow-up error messages.
2701       * Updates to CM/CMB documentation.
2702    
2703    TODO items:
2704    
2705       * MLRISC should use a different register as its asmTemp on the Sparc.
2706         (The current %o2 is a really bad choice because it is part of the
2707         calling conventions, so things might interfere in unexpected ways.)
2708    
2709    ----------------------------------------------------------------------
2710    Name: Matthias Blume
2711    Date: 2001/06/07
2712    Tag: blume-20010607-calls
2713    Description:
2714    
2715    A number of internal changes related to C calls and calling conventions:
2716    
2717    1. ML-Tree CALL statements now carry a "pops" field.  It indicates the
2718       number of bytes popped implicitly (by the callee).  In most cases
2719       this field is 0 but on x86/win32 it is some non-zero value.  This
2720       is information provided for the benefit of the "omit-frameptr" pass.
2721    2. The CALL instruction on the x86 carries a similar "pops" field.
2722       The instruction selection phase copies its value from the ML-Tree
2723       CALL statement.
2724    3. On all other architectures, the instruction selection phase checks
2725       whether "pops=0" and complains if not.
2726    4. The c-calls implementation for x86 now accepts two calling conventions:
2727       "ccall" and "stdcall".  When "ccall" is selected, the caller cleans
2728       up after the call and pops is set to 0.  For "stdcall", the caller
2729       does nothing, leaving the cleanup to the callee; pops is set to
2730       the number of bytes that were pushed onto the stack.
2731    5. The cproto decoder (compiler/Semant/types/cproto.sml) now can
2732       distinguish between "ccall" and "stdcall".
2733    6. The UNIMP instruction has been added to the supported Sparc instruction
2734       set. (This is needed for implementing the official C calling convention
2735       on this architecture.)
2736    7. I fixed some of the .cm files under src/MLRISC/Tools to make them
2737       work with the latest CM.
2738    
2739    ----------------------------------------------------------------------
2740    Name: Matthias Blume
2741    Date: 2001/06/05 15:10:00 EDT
2742    Tag: blume-20010605-cm-index
2743    Description:
2744    
2745    0. The "lambdasplit" parameter for class "sml" in CM has been documented.
2746    
2747    1. CM can now generate "index files".  These are human-readable files
2748       that list on a per-.cm-file basis each toplevel symbol defined or
2749       imported.  The location of the index file for
2750       <p>/<d>.cm is <p>/CM/INDEX/<d>.cm.
2751       To enable index-file generation, set CM.Control.generate_index to true
2752       or export an environment-symbol: export CM_GENERATE_INDEX=true.
2753    
2754       The CM manual has been updated accordingly.
2755    
2756    2. I made some slight modifications to the c-calls API in MLRISC.
2757    
2758         a) There is now a callback to support saving/restoring of
2759            dedicated but caller-save registers around the actual call
2760            instruction.
2761         b) One can optionally specify a comment-annotation for the
2762            call instruction.
2763    
2764    3. SML/NJ (mlriscGen.sml) uses this new API for the rawccall primop.
2765       (For example, the comment annotation shows the C prototype of
2766        the function being called.)
2767    
2768    ----------------------------------------------------------------------
2769    Name: Matthias Blume
2770    Date: 2001/06/01 13:30:00 EDT
2771    Tag: blume-20010601-nlffi-cleanup
2772    Description:
2773    
2774    This is mostly a cleanup of MLFFI stuff:
2775    
2776       - some signature files have been put into a more exposed place
2777       - the ugly 'f type parameter is gone (simplifies types tremendously!)
2778       - ml-nlffigen changed accordingly
2779       - tutorial updated
2780    
2781    Other changes:
2782    
2783       - author's affiliation in CM manual(s) updated
2784       - some more recognized keywords added to Allen's sml.sty
2785    
2786    ----------------------------------------------------------------------
2787    Name: Matthias Blume
2788    Date: 2001/05/25 15:30:00 EDT
2789    Tag: blume-20010525-iptr
2790    Description:
2791    
2792      - put the official 110.33-README (as it appears on the ftp server) under
2793        CVS
2794      - fixed a small bug related to incomplete pointer types in
2795        ml-nlffigen
2796      - small cosmetic change to the ml-nlffi-lib's "arr" type constructor
2797        (it does not need the 'f type parameter)
2798    
2799    ----------------------------------------------------------------------
2800    Name: Matthias Blume
2801    Date: 2001/05/23 14:30:00 EDT
2802    Tag: Release_110_33
2803    Description:
2804    
2805    New version number (110.33).  New bootfiles.
2806    
2807    ----------------------------------------------------------------------
2808    Name: Matthias Blume
2809    Date: 2001/05/22 18:06:00 EDT
2810    Tag: blume-20010522-targets
2811    Description:
2812    
2813    Made install.sh use file config/targets.customized if it exists, falling
2814    back to config/targets if it doesn't.  This way one can have a customized
2815    version of the targets file without touching the "real thing", thus
2816    eliminating the constant fear of accidentally checking something bogus
2817    back into the CVS repository...  (File config/targets.customized must
2818    not be added to the repository!)
2819    
2820    ----------------------------------------------------------------------
2821    Name: Matthias Blume
2822    Date: 2001/05/22 16:30:00 EDT
2823    Tag: blume-20010522-minitut
2824    Description:
2825    
2826    1. Bug fix in ml-nlffigen; now (hopefully) correctly handling
2827       struct returns.
2828    2. Added src/ml-nlffi-lib/Doc/mini-tutorial.txt.  This is some very
2829       incomplete, preliminary documentation for NLFFI.
2830    
2831    ----------------------------------------------------------------------
2832    Name: Matthias Blume
2833    Date: 2001/05/14 11:30:00 EDT
2834    Tag: blume-20010514-script
2835    Description:
2836    
2837    Some bugs in install script fixed.
2838    
2839    In addition to that I also made a slight change to the NLFFI API:
2840    Functors generated by ml-nlffigen now take the dynamic library as a
2841    straight functor argument, not as a suspended one.  (The original
2842    functor code used to force the suspension right away anyway, so there
2843    was nothing gained by this complication of the interface.)
2844    
2845    ----------------------------------------------------------------------
2846    Name: Matthias Blume
2847    Date: 2001/05/11 14:35:00 EDT
2848    Tag: blume-20010511-ml-nlffi
2849    Description:
2850    
2851    I finally took the plunge and added my new FFI code to the main
2852    repository.  For x86-linux it is now ready for prime-time.
2853    
2854    There are two new subdirectories of "src":
2855    
2856      - ml-nlffi-lib:
2857           The utility library for programs using the FFI interface.
2858           Here is the implementation of $/c.cm and its associated low-level
2859           partners $/c-int.cm and $/memory.cm.
2860      - ml-nlffigen:
2861           A stand-alone program for generating ML glue code from C source
2862           code.
2863    
2864    Building ml-nlffigen requires $/ckit-lib.cm.
2865    
2866    The config/install.sh script has been updates to do the Right Thing
2867    (hopefully).
2868    
2869    Notice that the source tree for the C-Kit will not be put under "src"
2870    but directly under the installation root directory.  (This is the
2871    structure that currently exists on the CVS server when you check out
2872    module "sml".)  Fortunately, config/install.sh knows about this oddity.
2873    
2874    Bugs: No documentation yet.
2875    
2876    ----------------------------------------------------------------------
2877    Name: Matthias Blume
2878    Date: 2001/05/09 16:35:00 EDT
2879    Tag: blume-20010509-cpscontract
2880    Description:
2881    
2882    Fixed a bug in the accounting code in cpsopt/contract.sml.  (The
2883    wrapper/unwrapper elimination did not decrement usage counts and some
2884    dead variables got overlooked by the dead-up logic.)
2885    
2886    ----------------------------------------------------------------------
2887    Name: Lal George
2888    Date: 2001/05/08  17:26:09 EDT
2889    Tag: george-20010508-omit-frameptr
2890    Description:
2891    
2892    Changes to implement the omit-frame-pointer optimization to support
2893    raw C calls. For now, there is only support on the Intel x86, but
2894    other architectures will follow as more experience is gained with this.
2895    
2896    
2897    ----------------------------------------------------------------------
2898    Name: Matthias Blume
2899    Date: 2001/05/07 14:40:00 EDT
2900    Tag: blume-20010507-proxies
2901    Description:
2902    
2903    I made into "proxy libraries" all libraries that qualify for such a
2904    change.  (A qualifying library is a library that has another library or
2905    groups as its sole member and repeats that member's export list
2906    verbatim.  A proxy library avoids this repetition by omitting its export
2907    list, effectively inheriting the list that its (only) member exports.
2908    See the CM manual for more explanation.)
2909    The main effect is that explicit export lists for these libraries
2910    do not have to be kepts in sync, making maintenance a bit easier.
2911    
2912    I also added copyright notices to many .cm-files.
2913    
2914    Last but not least, I made a new set of bootfiles.
2915    
2916    ----------------------------------------------------------------------
2917    Name: Matthias Blume
2918    Date: 2001/05/04 17:00:00 EDT
2919    Tag: blume-20010504-cm-lsplit
2920    Description:
2921    
2922    0. John merged pending changes to $/smlnj-lib.cm
2923    
2924    1. Allen's previous change accidentally backed out of one of Lal's
2925       earlier changes.  I undid this mistake (re-introducing Lal's change).
2926    
2927    2. I used the new topOrder' function from graph-scc.sml (from $/smlnj-lib.cm)
2928       within the compiler where applicable.  There is some code simplification
2929       because of that.
2930    
2931    3. The "split" phase (in FLINT) is now part of the default list of phases.
2932       Compiler.Control.LambdaSplitting.* can be used to globally control the
2933       lambda-splitting (cross-module-inlining) engine.  In addition to that,
2934       it can now also be controlled on a per-source basis: CM has been taught
2935       a new tool parameter applicable to ML source files.
2936    
2937       - To turn lambda-splitting off completely:
2938            local open Compiler.Control.LambdaSplitting in
2939                val _ = set Off
2940            end
2941       - To make "no lambda-splitting" the global default (but allow per-source
2942         overriding); this is the initial setting:
2943            local open Compiler.Control.LambdaSplitting in
2944                val _ = set (Default NONE)
2945            end
2946       - To make "lambda-splitting with aggressiveness a" the global default
2947         (and allow per-source overriding):
2948            local open Compiler.Control.LambdaSplitting in
2949                val _ = set (Default (SOME a))
2950            end
2951    
2952       - To turn lambda-splitting off for a given ML souce file (say: a.sml)
2953         write (in the respective .cm-file):
2954            a.sml (lambdasplitting:off)
2955       - To turn lambda-splitting for a.sml on with minimal aggressiveness:
2956            a.sml (lambdasplitting:on)
2957       - To turn lambda-splitting for a.sml on with aggressiveness <a> (where
2958         <a> is a decimal non-negative integer):
2959            a.sml (lambdasplitting:<a>)
2960       - To turn lambda-splitting for a.sml on with maximal aggressiveness:
2961            a.sml (lambdasplitting:infinity)
2962       - To use the global default for a.sml:
2963            a.sml (lambdasplitting:default)
2964         or simply
2965            a.sml
2966    
2967    ----------------------------------------------------------------------
2968    Name: Allen Leung
2969    Date: 2001/05/04 01:57:00 EDT
2970    Tag: leunga-20010504-sync
2971    Description:
2972    
2973      MLRISC features.
2974    
2975      1. Fix to CMPXCHG instructions.
2976      2. Changed RA interface to allow annotations in callbacks.
2977      3. Added a new method to the stream interface to allow annotations updates.
2978    
2979    ----------------------------------------------------------------------
2980    Name: Matthias Blume
2981    Date: 2001/05/01 11:45:00 EDT
2982    Tag: blume-20010501-pcedittmp
2983    Description:
2984    
2985    Changed install.sh to use the current working directory instead of
2986    /usr/tmp for a temporary file (pcedittmp).  The previous choice
2987    of /usr/tmp caused trouble with MacOS X because of file premission
2988    problems.
2989    
2990    ----------------------------------------------------------------------
2991    Name: Matthias Blume
2992    Date: 2001/04/20 11:10:00 EDT
2993    Tag: blume-20010420-inMLflag
2994    Description:
2995    
2996     - added vp_limitPtrMask to vproc-state.h
2997       (for use by the raw-C-calls mechanism to implement proper interrupt
2998        handling)
2999     - made the ML compiler aware of various data-structure offsets so it
3000       can generate code for accessing the vp_inML flag and vp_limitPtrMask
3001     - tweaked mlriscGen.sml to have it emit interrupt-handling code for
3002       raw C-calls
3003    
3004    ----------------------------------------------------------------------
3005    Name: Lal George
3006    Date: 2001/04/20 09:15:28 EDT
3007    Tag: george-20010420-macosX
3008    Description:
3009    
3010     - Changes to port to Mac OS X; Darwin.
3011    
3012     - In the process I found that sqrt was broken on the PPC, because the
3013       fsqrt instruction is not implemented.
3014    
3015    ----------------------------------------------------------------------
3016    Name: Matthias Blume
3017    Date: 2001/04/18 12:45:00 EDT
3018    Tag: blume-20010418-ccalls
3019    Description:
3020    
3021     - fixed two off-by-4 errors in the x86-specific c-calls implementation
3022       (this bug prevented structure arguments containing pointers from being
3023        passed correctly)
3024     - changed the raw-C-call code in mlriscGen.sml in such a way that
3025       structure arguments are represented as a pointer to the beginning
3026       of the structure (instead of having a series of synthesized arguments,
3027       one for each structure member)
3028    
3029     - made makeml script's verbosity level configurable via environment
3030       variable (MAKEML_VERBOSITY)
3031    
3032     - eliminated placeholder implementations for f32l, w16s, i16s, and f32s
3033       in rawmem-x86.sml; we are now using the real thing
3034    
3035    ----------------------------------------------------------------------
3036    Name: Matthias Blume
3037    Date: 2001/03/22 16:25:00 EST
3038    Tag: blume-20010322-bootfiles
3039    Description:
3040    
3041    Created a new set of bootfiles (for your automatic installation convenience).
3042    
3043    ----------------------------------------------------------------------
3044    Name: Matthias Blume
3045    Date: 2001/03/22 15:10:00 EST
3046    Tag: blume-20010322-rawmem-parcm
3047    Description:
3048    
3049    1. All "raw memory access" primitives for the new FFI are implemented now
3050       (at least on the x86).
3051    2. Some further cleanup of CM's parallel make mechanism.
3052    
3053    ----------------------------------------------------------------------
3054    Name: Matthias Blume
3055    Date: 2001/03/19 17:53:00 EST
3056    Tag: blume-20010319-parallel
3057    Description:
3058    
3059    Parallel make (using compile servers) now works again.
3060    
3061    To this end, CM.stabilize and CMB.make have been modified to work in
3062    two passes when compile servers are attached:
3063       1. Compile everything, do not perform stabilization; this pass
3064          uses compile servers
3065       2. Stabilize everything; this pass does not use compile servers
3066    If there are no compile servers, the two passes are combined into one
3067    (as before).  Splitting the passes increases the inherent parallelism
3068    in the dependency graph because the entire graph including all
3069    libraries is available at the same time.  This, in turn, improves
3070    server utilization.  The downside is that the master process will
3071    have to do some extra work after compilation is done (because for
3072    technical reasons it must re-read all the binfiles during stabilization).
3073    
3074    ----------------------------------------------------------------------
3075    Name: Matthias Blume
3076    Date: 2001/03/16 12:22:00 EST
3077    Tag: blume-20010316-bootfiles
3078    Description:
3079    
3080    Created a new set of bootfiles (for your automatic installation convenience).
3081    
3082    ----------------------------------------------------------------------
3083    Name: Matthias Blume
3084    Date: 2001/03/16 11:00:00 EST
3085    Tag: blume-20010316-MLTREE-fixup
3086    Description:
3087    
3088    This is a minor fixup for an (untagged) earlier commit by Allen.
3089    (A file was missing).
3090    
3091    ----------------------------------------------------------------------
3092    Name: Allen Leung
3093    Date: Mon Mar  5 18:54:57 EST 2001
3094    Tag: leunga-20010305-cut-support
3095    
3096    1. New support for alternative control-flow in MLTREE.
3097       Currently we support
3098    
3099          FLOW_TO(CALL ...., [k1,...,kn])
3100    
3101       This is needed for 'cuts to' in C-- and try/handle-like constructs
3102       in Moby
3103    
3104       New assembler flag "asm-show-cutsto" to turn on control-flow debugging.
3105    
3106    2. Register Allocator
3107    
3108       Changes in interface [from Fermin, John]
3109    
3110    3. Alpha 8-bit SLL support [Fermin]
3111    
3112    4. All architectures
3113    
3114       A new module (ClusterExpandCopies) for expanding parallel copies.
3115    
3116    ----------------------------------------------------------------------
3117    Name: Allen Leung
3118    Date: 2001/02/27 23:07:00 EST
3119    Tag: leunga-20010227-minor-stuff
3120    
3121    1. Alpha bug fix for CMOVNE
3122    2. Handle mltree COND(..,FCMP ...,...)
3123    3. Bug fix in simplifier
3124    
3125    ----------------------------------------------------------------------
3126    Name: Matthias Blume
3127    Date: 2001/01/30 17:50:00 EST
3128    Tag: blume-20010130-sync
3129    Description:
3130    
3131    This is just a minor update to sync my devel branch with the main brach.
3132    The only visible change is the addition of some README files.
3133    
3134    ----------------------------------------------------------------------
3135    Name: Matthias Blume
3136    Date: 2001/01/12 23:30:00 JST
3137    Tag: blume-20010112-bootfiles
3138    Description:
3139    
3140    Made a new set of bootfiles that goes with the current state of the
3141    repository.
3142    
3143    ----------------------------------------------------------------------
3144    Name: Matthias Blume
3145    Date: 2001/01/12 21:20:00 JST
3146    Tag: blume-20010112-sync
3147    Description:
3148    
3149    I am just flushing out some minor changes that had accumulated in
3150    my private branch in order to sync with the main tree.  (This is
3151    mainly because I had CVS trouble when trying to merge _into_ my
3152    private branch.)
3153    
3154    Most people should be completely unaffected by this.
3155    
3156    ----------------------------------------------------------------------
3157    Name: Allen Leung
3158    Date: Thu Jan 11 21:03:00 EST 2001
3159    Tag: leunga-20010111-labexp=mltree
3160    Description:
3161    
3162    1.  Removed the type LabelExp and replace it by MLTree.
3163    2.  Rewritten mltree-simplify with the pattern matcher tool.
3164    3.  There were some bugs in alpha code generator which would break
3165        64-bit code generation.
3166    4.  Redo the tools to generate code with the
3167    5.  The CM files in MLRISC (and in src/system/smlnj/MLRISC)
3168        are now generated by perl scripts.
3169    
3170    ----------------------------------------------------------------------
3171    Name: Matthias Blume
3172    Date: 2001/01/10 21:55:00 JST
3173    Tag: blume-20010110-rcc
3174    Description:
3175    
3176    The RCC stuff now seems to work (but only on the x86).
3177    This required hacking of the c-calls interface (and -implementation) in
3178    MLRISC.
3179    
3180    Normal compiler users should be unaffected.
3181    
3182    ----------------------------------------------------------------------
3183    Name: Matthias Blume
3184    Date: 2001/01/09 01:20:00 JST
3185    Tag: blume-20010109-rcc
3186    Description:
3187    
3188    This is a fairly big patch, flushing out a large number of pending
3189    changes that I made to my development copy over the last couple of days.
3190    
3191    Of practical relevance at this moment is a workaround for a pickling
3192    bug that Allen ran into the other day.  The cause of the bug itself is
3193    still unknown and it might be hard to fix it properly, but the
3194    workaround has some merits of its own (namely somewhat reducing pickling
3195    overhead for certain libraries).  Therefore, I think this solution should
3196    be satisfactory at this time.
3197    
3198    The rest of the changes (i.e., the vast majority) has to do with my
3199    ongoing efforts of providing direct support for C function calls from
3200    ML.  At the moment there is a new primop "RAW_CCALL", typing magic
3201    in types/cproto.sml (invoked from FLINT/trans/translate.sml), a new
3202    case in the FLINT CPS datatype (RCC), changes to cps/convert.sml to
3203    translate uses of RAW_CCALL into RCC, and changes to mlriscGen.sml to
3204    handle RCC.
3205    
3206    The last part (the changes to mlriscGen.sml) are still known to be
3207    wrong on the x86 and not implemented on all other architectures.  But
3208    the infrastructure is in place. I had to change a few functor
3209    signatures in the backend to be able to route the CCalls interface
3210    from MLRISC there, and I had to specialize the mltree type (on the
3211    x86) to include the necessary extensions. (The extensions themselves
3212    were already there and redy to go in MLRISC/x86).
3213    
3214    Everything should be very happy as soon as someone helps me with
3215    mlriscGen.sml...
3216    
3217    In any case, nothing of this should matter to anyone as long as the
3218    new primop is not being used (which is going to be the case unless you
3219    find it where I hid it :). The rest of the compiler is completely
3220    unaffected.
3221    
3222    ----------------------------------------------------------------------
3223    Name: Matthias Blume
3224    Date: 2001/01/05 00:30:00 JST
3225    Tag: blume-20010105-primops
3226    Description:
3227    
3228    Added some experimental support for work that I am doing right now.
3229    These changes mostly concern added primops, but there is also a new
3230    experimental C library in the runtime system (but currently not enabled
3231    anywhere except on Linux/X86).
3232    
3233    In the course of adding primops (and playing with them), I discovered that
3234    Zhong's INL_PRIM hack (no type info for certain primops) was, in fact, badly
3235    broken.  (Zhong was very right he labeled this stuff as "major gross hack".)
3236    To recover, I made type information in INL_PRIM mandatory and changed
3237    prim.sml as well as built-in.sml accordingly.  The InLine structure now
3238    has complete, correct type information (i.e., no bottom types).
3239    
3240    Since all these changes mean that we need new binfiles, I also bumped the
3241    version number to 110.32.1.
3242    
3243    ----------------------------------------------------------------------
3244    Name: Matthias Blume
3245    Date: 2000/12/30 22:10:00 JST
3246    Tag: blume-20001230-various
3247    Description:
3248    
3249    Added proxy libraries for MLRISC and let MLRISC libraries refer
3250    to each other using path anchors.  (See CM manual for explanation.)
3251    
3252    Updated CM documentation.
3253    
3254    Fixed some bugs in CM.
3255    
3256    Implemented "proxy" libraries (= syntactic sugar for CM).
3257    
3258    Added "-quiet" option to makeml and changed runtime system accordingly.
3259    
3260    Added cleanup handler for exportML to reset timers and compiler stats.
3261    
3262    ----------------------------------------------------------------------
3263    Name: Lal George
3264    Date: 2000/12/22 22:22:58 EST 2000
3265    Tag: Release_110_32
3266    Description:
3267    
3268            Infinite precision used throughout MLRISC.
3269            see MLRISC/mltree/machine-int.sig
3270    
3271    ----------------------------------------------------------------------
3272    Name: Matthias Blume
3273    Date: 2000/12/22 23:16:00 JST
3274    Tag: blume-20001222-warn
3275    Description:
3276    
3277    Corrected wording and formatting of some CM warning message which I
3278    broke in my previous patch.
3279    
3280    ----------------------------------------------------------------------
3281    Name: Matthias Blume
3282    Date: 2000/12/22 21:20:00 JST
3283    Tag: blume-20001222-anchorenv
3284    Description:
3285    
3286    Fixed CM's handling of anchor environments in connection with CMB.make.
3287    
3288    ----------------------------------------------------------------------
3289    Name: Matthias Blume
3290    Date: 2000/12/22 13:15:00 JST
3291    Tag: blume-20001222-cleanup
3292    Description:
3293    
3294    Removed src/cm/ffi which does not (and did not) belong here.
3295    
3296    ----------------------------------------------------------------------
3297    Name: Matthias Blume
3298    Date: 2000/12/21 23:55:00 JST
3299    Tag: blume-20001221-exn
3300    Description:
3301    
3302    Probably most important: CM no longer silently swallows all exceptions
3303    in the compiler.
3304    Plus: some other minor CM changes.  For example, CM now reports some
3305    sizes for generated binfiles (code, data, envpickle, lambdapickle).
3306    
3307    ----------------------------------------------------------------------
3308    Name: Matthias Blume
3309    Date: 2000/12/15 00:01:05 JST
3310    Tag: blume-20001215-dirtool
3311    Description:
3312    
3313    - "dir" tool added.
3314    - improvements and cleanup to Tools structure
3315    - documentation updates
3316    
3317    ----------------------------------------------------------------------
3318    Name: Allen Leung
3319    Date: Thu Dec 14 03:45:24 EST 2000
3320    Description:
3321    Tag:  leunga-20001214-int-inf
3322    Description:
3323    
3324       In IntInf, added these standard functions, which are missing from our
3325    implementation:
3326    
3327        andb : int * int -> int
3328        xorb : int * int -> int
3329        orb  : int * int -> int
3330        notb : int -> int
3331         <<   : int * word -> int
3332        ~>>  : int * word -> int
3333    
3334       Not tested, I hope they are correct.
3335    
3336    ----------------------------------------------------------------------
3337    Name: Allen Leung
3338    Date: Fri Dec  8 19:23:26 EST 2000
3339    Description:
3340    Tag:  leunga-20001208-nowhere
3341    Description:
3342    
3343      Slight improvements to the 'nowhere' tool to handle OR-patterns,
3344    to generate better error messages etc.  Plus a brief manual.
3345    
3346    ----------------------------------------------------------------------
3347    Name: Lal George
3348    Date: 2000/12/08 09:54:02 EST 2000
3349    Tag: Release_110_31
3350    Description:
3351    
3352    - Version 110.31
3353    ----------------------------------------------------------------------
3354    Name: Allen Leung
3355    Date: Thu Dec  7 22:01:04 EST 2000
3356    Tag:  leunga-20001207-cell-monster-hack
3357    Description:
3358    
3359    Major MLRISC internal changes.  Affect all clients.
3360    Summary:
3361    
3362    1.  Type CELLS.cell = int is now replaced by a datatype.
3363        As a result, the old regmap is now gone.  Almost all interfaces
3364        in MLRISC change as a consequence.
3365    
3366    2.  A new brand version of machine description tool (v3.0) that generates
3367        modules expecting the new interface.  The old version is removed.
3368    
3369    3.  The RA interface has been further abstracted into two new functors.
3370        RISC_RA and X86RA.  These functors have much simpler interfaces.
3371        [See also directory MLRISC/demo.]
3372    
3373    4.  Some other new source->source code generation tools are available:
3374    
3375        a. MLRISC/Tools/RewriteGen -- generate rewriters from rules.
3376        b. MLRISC/Tools/WhereGen -- expands conditional pattern matching rules.
3377           I use this tool to generate the peephole optimizers---with the new
3378           cell type changes, peephole rules are becoming difficult to write
3379           without conditional pattern matching.
3380    
3381    5.  More Intmap -> IntHashTable change.  Previous changes by Matthias didn't
3382        cover the entire MLRISC source tree so many things broke.
3383    
3384    6.  CM files have been moved to the subdirectory MLRISC/cm.
3385        They are moved because there are a lot of them and they clutter up the
3386        root dir.
3387    
3388    7.  More detailed documentation to come...
3389    
3390        NOTE: To rebuild from 110.30 (ftp distribution), you'll have to do
3391        a makeml -rebuild first.  This is because of other other
3392        changes that Matthias has made (see below).
3393    
3394    
3395    ----------------------------------------------------------------------
3396    Name: Matthias Blume
3397    Date: 2000/11/30 23:12:00 JST
3398    Tag: blume-20001130-filereorg
3399    Description:
3400    
3401    Some manual updates and some file reorganizations in CM.
3402    
3403    ----------------------------------------------------------------------
3404    Name: Matthias Blume
3405    Date: 2000/11/24 17:45:00 JST
3406    Tag: blume-20001124-link
3407    Description:
3408    
3409    Drastically improved link traversal code for the case that the dynamic
3410    value was already loaded at bootstrap time.  As a result, CM and CMB
3411    now both load blazingly fast -- even on a very slow machine.  Also,
3412    memory consumption has been further reduced by this.
3413    
3414    Warning: The format of the PIDMAP file has changed.  THerefore, to
3415    bootstrap you have to do this:
3416    
3417    1. Run CMB.make
3418    2. Make a symbolic link for the boot directory:
3419         ln -s sml.boot.ARCH-OS xxx
3420    3. "Rebuild" the boot directory:
3421         ./makeml -boot xxx -rebuild sml ; rm xxx
3422    4. Boot normally:
3423          ./makeml
3424    
3425    ----------------------------------------------------------------------
3426    Name: Matthias Blume
3427    Date: 2000/11/21 21:20:00 JST
3428    Tag: blume-20001121-tools
3429    Description:
3430    
3431    Continued hacking on autoloading problem -- with success this time.
3432    Also changed tool-plugin mechanism.  See new CM manual.
3433    
3434    ----------------------------------------------------------------------
3435    Name: Matthias Blume
3436    Date: 2000/11/19 14:30:00 JST
3437    Tag:  blume-20001119-autoload
3438    Description:
3439    
3440    Some hacking to make autoloading faster.  Success for CMB, no success
3441    so far for CM.  There is a reduced structure CM' that autoloads faster.
3442    (This is a temporary, non-documented hack to be eliminated again when
3443    the general problem is solved.)
3444    
3445    ----------------------------------------------------------------------
3446    Name: Matthias Blume
3447    Date: 2000/11/17 14:10:00 JST
3448    Tag: blume-20001117-pickle-lib
3449    Description:
3450    
3451    1. Eliminated comp-lib.cm
3452    2. Made pickle-lib.cm
3453    3. Eliminated all uses of intset.sml (from comp-lib.cm)
3454    4. Replaced all uses of intmap.{sig,sml} (from comp-lib.cm) with
3455       equivalent constructs from smlnj-lib.cm (INtHashTable).
3456    5. Point 4. also goes for those uses of intmap.* in MLRISC.
3457       Duplicated intmap modules thrown out.
3458    6. Hunted down all duplicated SCC code and replaced it with
3459       equivalent stuff (GraphSCCFn from smlnj-lib.cm).
3460    7. Rewrote Feedback module.
3461    8. Moved sortedlist.sml into viscomp-lib.cm.  Eventually it
3462       should be thrown out and equivalent modules from smlnj-lib.cm
3463       should be used (IntRedBlackSet, IntListSet, ...).
3464    
3465    Confirmed that compiler compiles to fixpoint.
3466    
3467    ----------------------------------------------------------------------
3468    Name: Allen Leung
3469    Date: 2000/11/10 18:00:00
3470    Tag: leunga-20001110-new-x86-fp
3471    
3472    A new x86 floating point code generator has been added.
3473    By default this is turned off.  To turn this on, do:
3474    
3475        CM.autoload "$smlnj/compiler.cm";
3476        Compiler.Control.MLRISC.getFlag "x86-fast-fp" := true;
3477    
3478    Changes:
3479    
3480    1.  Changed FTAN to FPTAN so that the assembly output is correct.
3481    2.  Changed the extension callback for FTANGENT to generate:
3482    
3483              fptan
3484              fstp  %st(0)
3485        instead of
3486              fptan
3487              fstpl ftempmem
3488    
3489    3.  Numerous assembly fixes for x86.
3490    
3491    5.  Cleaned up the machine code output module x86/x86MC.sml and added
3492        support for a whole bunch of instructions and addressing modes:
3493    
3494          fadd/fsub/fsubr/fmul/fdiv/fdivr  %st, %st(n)
3495          faddp/fsubp/fsubrp/fmulp/fdivp/fdivrp  %st, %st(n)
3496          fadd/fsub/fsubr/fmul/fdiv/fdivr  %st(n), %st
3497          fiadd/fisub/fisubr/fimul/fidiv/fidivr mem
3498          fxch %st(n)
3499          fld %st(n)
3500          fst %st(n)
3501          fst mem
3502          fstp %st(n)
3503          fucom %st(n)
3504          fucomp %st(n)
3505    
3506        All these are now generated when the fast fp mode is turned on.
3507    
3508    6.  Removed the dedicated registers %st(0), ..., %st(7) from X86CpsRegs
3509    
3510    ----------------------------------------------------------------------
3511    Name: Matthias Blume
3512    Date: 2000/11/09 11:20:00 JST
3513    Tag: blume-20001109-scc
3514    Description:
3515    
3516    Eliminated some code duplication:
3517    
3518    1. Added "where" clause to GraphSCCFn in SML/NJ Library.
3519       (Otherwise the functor is useless.)
3520    2. Used GraphSCCFn where SCCUtilFun was used previously.
3521    3. Got rid of SCCUtilFun (in comp-lib.cm).
3522    
3523    ----------------------------------------------------------------------
3524    Name: Lal George
3525    Date: 2000/11/06 09:02:21 EST 2000
3526    Tag: Release_110_30
3527    Description:
3528    
3529    - Version 110.30
3530    ----------------------------------------------------------------------
3531    Name: Matthias Blume
3532    Date: 2000/11/04 14:45:00
3533    Tag: blume-20001104-mlbuild
3534    Description:
3535    
3536    - Made ml-build faster on startup.
3537    - Documentation fixes.
3538    
3539    ----------------------------------------------------------------------
3540    Name: Matthias Blume
3541    Date: 2000/11/02 17:00:00 JST
3542    Tag: blume-20001102-condcomp
3543    Description:
3544    
3545    - Small tweaks to pickler -- new BOOTFILES!
3546    - Version bumped to 110.29.2.
3547    - Added conditional compilation facility to init.cmi (see comment there).
3548    ----------------------------------------------------------------------
3549    Name: Allen Leung
3550    Date: 2000/10/23 19:31:00
3551    Tag: leunga-20001023-demo-ra
3552    
3553    1. Minor RA changes that improves spilling on x86 (affects Moby and C-- only)
3554    2. Test programs for the graph library updated
3555    3. Some new MLRISC demo programs added
3556    
3557    ----------------------------------------------------------------------
3558    Name: Matthias Blume
3559    Date: 2000/08/31 22:15:00 JST
3560    Tag: blume-20001017-errmsg
3561    Description:
3562    
3563    More error message grief: Where there used to be no messages, there
3564    now were some that had bogus error regions.  Fixed.
3565    
3566    ----------------------------------------------------------------------
3567    Name: Matthias Blume
3568    Date: 2000/08/31 17:30:00 JST
3569    Tag: blume-20001017-v110p29p1
3570    Description:
3571    
3572    I made a version 110.29.1 with new bootfiles.
3573    
3574    Changes:  Modified pickler/unpickler for faster and leaner unpickling.
3575              CM documentation changes and a small bugfix in CM's error reporting.
3576    
3577    ----------------------------------------------------------------------
3578    Name: Lal George
3579    Date: 2000/09/27 14:42:35 EDT
3580    Tag: george-20000927-nodestatus
3581    Description:
3582    
3583    Changed the type of the nodestatus, so that:
3584    
3585            SPILLED(~1)             is now SPILLED
3586            SPILLED(m) where m>=0   is now MEMREG(m)
3587            SPILLED(s) where s<~1   is now SPILL_LOC(~s)
3588    
3589    ----------------------------------------------------------------------
3590    Name: Matthias Blume
3591    Date: 2000/09/07 14:45:00 JST
3592    Tag: blume-20000907-cmerrmsg
3593    Description:
3594    
3595    Small tweak to CM to avoid getting ML syntax error messages twice.
3596    
3597    ----------------------------------------------------------------------
3598    Name: Matthias Blume
3599    Date: 2000/08/31 18:00:00 JST
3600    Tag: blume-20000831-cvsbootfiles
3601    Description:
3602    
3603    New URL for boot files (because the 110.29 files on the BL server do
3604    now work correctly with my updated install scripts for yacc and lex).
3605    
3606    ----------------------------------------------------------------------
3607    Name: Matthias Blume
3608    Date: 2000/08/08 12:33:00 JST
3609    Tag: blume-20000808-manual
3610    Description:
3611    
3612    Tiny update to CM manual.
3613    
3614    ----------------------------------------------------------------------
3615    Name: Allen Leung
3616    Date: 2000/08/7 19:31:00
3617    Tag: leunga-20000807-a-whole-bunch-of-stuff
3618    
3619      Moby, C--, SSA, x86, machine descriptions etc.  Should only affect C--
3620    and Mobdy.
3621    
3622    1.  x86