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

SCM Repository

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

Diff of /sml/trunk/NOTES/HISTORY

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

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