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/branches/primop-branch-3/NOTES/HISTORY
ViewVC logotype

Diff of /sml/branches/primop-branch-3/NOTES/HISTORY

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

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