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

SCM Repository

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

Diff of /sml/trunk/HISTORY

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

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

Legend:
Removed from v.716  
changed lines
  Added in v.1327

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