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