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