Home My Page Projects Code Snippets Project Openings SML/NJ
Summary Activity Forums Tracker Lists Tasks Docs Surveys News SCM Files

SCM Repository

[smlnj] Diff of /sml/trunk/NOTES/HISTORY
ViewVC logotype

Diff of /sml/trunk/NOTES/HISTORY

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

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

Legend:
Removed from v.701  
changed lines
  Added in v.1192

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