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