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

SCM Repository

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

Diff of /sml/trunk/HISTORY

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

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

Legend:
Removed from v.824  
changed lines
  Added in v.1261

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