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

SCM Repository

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

Diff of /sml/trunk/HISTORY

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

revision 591, Mon Apr 3 01:19:20 2000 UTC revision 1063, Wed Feb 13 21:41:53 2002 UTC
# Line 8  Line 8 
8  The form of an entry should be:  The form of an entry should be:
9    
10  Name:  Name:
11  Date:  Date: yyyy/mm/dd
12  Tag: <post-commit CVS tag>  Tag: <post-commit CVS tag>
13  Description:  Description:
14    
15    ----------------------------------------------------------------------
16    Name: Matthias Blume
17    Date: 2002/02/13 16:41:00 EST
18    Tag: blume-20020213-cmlpq
19    Description:
20    
21    Added new priority queue export symbols (which have just been added to
22    smlnj-lib.cm) to CML's version of smlnj-lib.cm.  (Otherwise CML would
23    not compile and the installer would choke.)
24    
25    ----------------------------------------------------------------------
26    Name: Matthias Blume
27    Date: 2002/02/13 16:15:00 EST
28    Tag: blume-20020213-various
29    Description:
30    
31    1. More tweaks to ml-nlffigen:
32    
33       - better internal datastructures (resulting in slight speedup)
34       - "-match" option requires exact match
35       - "localized" gensym counters (untagged structs/unions nested within
36         other structs/unions or within typedefs get a fresh counter; their
37         tag will be prefixed by a concatenation of their parents' tags)
38       - bug fixes (related to calculation of transitive closure of types
39         to be included in the output)
40    
41    2. Minor Basis updates:
42    
43       - added implementations for List.collate and Option.app
44    
45    ----------------------------------------------------------------------
46    Name: Matthias Blume
47    Date: 2002/02/11 15:55:00 EST
48    Tag: blume-20020211-gensym
49    Description:
50    
51    Added a "-gensym" option to command line of ml-nlffigen.  This can be
52    used to specify a "stem" -- a string that is inserted in all "gensym'd"
53    names (ML structure names that correspond to unnamed C structs, unions,
54    and enums), so that separate runs of ml-nlffigen do not clash.
55    
56    ----------------------------------------------------------------------
57    Name: Matthias Blume
58    Date: 2002/02/11 12:05:00 EST
59    Tag: blume-20020211-gensml
60    Description:
61    
62    A quick fix for a problem with GenSML (in the pgraph-util library):
63    Make generation of toplevel "local" optional.  (Strictly speaking,
64    signature definitions within "local" are not legal SML.)
65    
66    Other than that: updates to INSTALL and cm/TODO.
67    
68    ----------------------------------------------------------------------
69    Name: Matthias Blume
70    Date: 2002/02/08 15:00:00 EST
71    Tag: blume-20020208-uniquepid
72    Description:
73    
74    0. Version number has been bumped to 110.38.1.  NEW BOOTFILES!!!
75    
76    1. The installer (config/install.sh) has gotten smarter:
77    
78         - Configuration options are a bit easier to specify now
79           (in config/targets).
80         - Bug in recognizing .tar.bz2 files fixed.
81         - Installer automatically resolves dependencies between
82           configuration options (e.g., if you ask for eXene, you will
83           also get cml -- regardless whether you asked for it or not).
84         - Installer can run in "quieter mode" by setting the environment
85           variable INSTALL_QUIETLY to "true".  "Quieter" does not mean
86           "completely silent", though.
87         - Build HashCons library as part of smlnj-lib.
88    
89    2. A new scheme for assigning persistent identifiers to compilation
90       units (and, by extension, to types etc.) has been put into place.
91       This fixes a long-standing bug where types and even dynamic values
92       can get internally confused, thereby compromising type safety
93       (abstraction) and dynamic correctness.  See
94    
95         http://cm.bell-labs.com/cm/cs/who/blume/pid-confusion.tgz
96    
97       for an example of how things could go wrong until now.
98    
99       The downside of the new scheme is that pids are not quite as
100       persistent as they used to be: CM will generate a fresh pid
101       for every compilation unit that it thinks it sees for the first
102       time.  That means that if you compile starting from a clean, fresh
103       source tree at two different times, you end up with different
104       binaries.
105    
106       Cutoff recompilation, however, has not been compromised because
107       CM keeps pid information in special caches between runs.
108    
109    ----------------------------------------------------------------------
110    Name: Lal George
111    Date: 2002/02/07 15:34:13 EST 2002
112    Tag: <none>
113    Description:
114    
115    Compilers that generate assembly code may produce  global labels
116    whose value is resolved at link time. The various peephole optimization
117    modules did not take this in account.
118    
119    TODO. The Labels.addrOf function should really return an option
120    type so that clients are forced to deal with this issue, rather
121    than an exception being raised.
122    
123    ----------------------------------------------------------------------
124    Name: Lal George
125    Date: 2002/02/06 13:55:02 EST
126    Tag: george-20020206-ra-breakup
127    Description:
128    
129    1. A bug fix from Allen.
130    
131        A typo causes extra fstp %st(0)'s to be generated at compensation
132        edges, which might cause stack underflow traps at runtime.  This
133        occurs in fft where there are extraneous fstps right before the 'into'
134        trap instruction (in this case they are harmless since none of the
135        integers overflow.)
136    
137    2. Pulled out various utility modules that were embedded in the modules
138       of the register allocator. I need these modules for other purposes, but
139       they are not complete enough to put into a library (just yet).
140    ----------------------------------------------------------------------
141    Name: Matthias Blume
142    Date: 2002/01/31 16:05:00 EST
143    Tag: blume-20020131-sparc-ccalls
144    Description:
145    
146    1. C-calls on Sparc needlessly allocated a huge chunk (96 bytes)
147       of extra stack space by mistake.  Fixed.
148    
149    2. Bug in logic of handling of command-line options in ml-nlffigen fixed.
150    
151    ----------------------------------------------------------------------
152    Name: Allen Leung
153    Date: 2002/01/30
154    Tag: leunga-20020130-nowhere-bug-fix
155    Description:
156    
157       MLRISC bug fixes:
158       1. Fixed a bindings computation bug in the 'nowhere' program generator tool.
159       2. MachineInt.fromString was negating its value.
160    
161    ----------------------------------------------------------------------
162    Name: Matthias Blume
163    Date: 2002/01/29
164    Tag: blume-20020129-INSTALL
165    Description:
166    
167    - Added somewhat detailed installation instructions (file INSTALL).
168    - Fixed curl-detection bug in config/install.sh.
169    - It is now possible to select the URL getter using the URLGETTER
170      environment variable:
171    
172          not set / "unknown"      --> automatic detection (script tries wget,
173                                       curl, and lynx)
174          "wget" / "curl" / "lynx" --> use the specified program (script "knows"
175                                       how to properly invoke them)
176          other                    --> use $URLGETTER directly, it must take
177                                       precisely two command-line arguments
178                                       (source URL and destination file name)
179    
180    ----------------------------------------------------------------------
181    Name: Matthias Blume
182    Date: 2002/01/28
183    Tag: blume-20020128-sparc-ccalls
184    Description:
185    
186    - Fixed problem with calculation of "used" registers in sparc-c-calls.
187    - Make use of the allocParam argument in sparc-c-calls.
188    
189    ----------------------------------------------------------------------
190    Name: Matthias Blume
191    Date: 2002/01/28
192    Tag: blume-20020128-allocParam
193    Description:
194    
195    John Reppy:  Changes c-calls API to accept client-callback for
196    allocating extra stack space.
197    me: Corresponding changes to mlriscGen (using a dummy argument that
198        does not change the current behavior).
199    
200    ----------------------------------------------------------------------
201    Name: Matthias Blume
202    Date: 2002/01/28 12:00:00
203    Tag: Release_110_38
204    Description:
205    
206    This time for real!!!
207    
208    ----------------------------------------------------------------------
209    Name: Matthias Blume
210    Date: 2002/01/28 10:56:00 EST
211    Tag: blume-20020128-retraction
212    Description:
213    
214    0. Retracted earlier 110.38.  (The Release_110_38 tag has been replaced
215       with blume-Release_110_38-retracted.)
216    
217    1. Fixed a problem with incorrect rounding modes in real64.sml.
218       (Thanks to Andrew Mccreight <andrew.mccreight@yale.edu>.)
219    
220    2. A bug in ml-nlffigen related to the handling of unnamed structs, unions,
221       and enums fixed.  The naming of corresponding ML identifiers should
222       now be consistent again.
223    
224    ----------------------------------------------------------------------
225    Name: Allen Leung
226    Date: 2002/01/27
227    Tag: leunga-20020127-nowhere
228    Description:
229    
230       Added a target called nowhere in the configuration scripts.
231       Enabling this will build the MLRISC 'nowhere' tool (for translating
232       programs with where-clauses into legal SML code) during installation.
233    
234    ----------------------------------------------------------------------
235    Name: Matthias Blume
236    Date: 2002/01/25 21:27:00 EST
237    Tag: blume-Release_110_38-retracted
238    Description:
239    
240    Call it a (working) release!  Version is 110.38. Bootfiles are ready.
241    
242    README will be added later.
243    
244    !!! NOTE:  Re-tagged as blume-Release_110_38-retracted. Original tag
245    (Release_110_38) removed.  Reason: Last-minute bug fixes.
246    
247    ----------------------------------------------------------------------
248    Name: Matthias Blume
249    Date: 2002/01/25
250    Tag: blume-20020125-ffi
251    Description:
252    
253    A large number of tweaks and improvements to ml-nlffi-lib and
254    ml-nlffigen:
255    
256       - ML represenation types have been streamlined
257       - getter and setter functions work with concrete values, not abstract
258         ones where possible
259       - ml-nlffigen command line more flexible (see README file there)
260       - some bugs have been fixed (hopefully)
261    
262    ----------------------------------------------------------------------
263    Name: Lal George
264    Date: 2002/01/24
265    Tag: george-20020124-risc-ra-interface
266    Description:
267    
268       There is a dramatic simplification in the interface to the
269       register allocator for RISC architectures as a result of making
270       parallel copy instructions explicit.
271    
272    ----------------------------------------------------------------------
273    Name: Matthias Blume
274    Date: 2002/01/22
275    Tag: blume-20020122-x86-ccalls
276    Description:
277    
278    Bug fix for c-calls on x86 (having to do with how char- and
279    short-arguments are being handled).
280    
281    ----------------------------------------------------------------------
282    Name: Matthias Blume
283    Date: 2002/01/21
284    Tag: blume-20020121-ff
285    Description:
286    
287    Another day of fiddling with the FFI...
288    
289    1. Bug fix/workaround:  CKIT does not complain about negative array
290       dimensions, so ml-nlffigen has to guard itself against this possibility.
291       (Otherwise a negative dimension would send it into an infinite loop.)
292    
293    2. Some of the abstract types (light objects, light pointers, most "base"
294       types) in structure C are now eqtypes.
295    
296    3. Added constructors and test functions for NULL function pointers.
297    
298    ----------------------------------------------------------------------
299    Name: Matthias Blume
300    Date: 2002/01/18
301    Tag: blume-20020118-ready-for-new-release
302    Description:
303    
304    Made config/srcarchiveurl point to a new place.  (Will provide boot
305    files shortly.)
306    
307    Maybe we christen this to be 110.38?
308    
309    ----------------------------------------------------------------------
310    Name: Matthias Blume
311    Date: 2002/01/18
312    Tag: blume-20020118-more-ffifiddle
313    Description:
314    
315    Today's FFI fiddling:
316    
317      - Provided a structure CGetSet with "convenient" versions of C.Get.* and
318        C.Set.* that use concrete (MLRep.*) arguments and results instead
319        of abstract ones.
320    
321      - Provided word-style bit operations etc. for "int" representation
322        types in MLRep.S<Foo>Bitops where <Foo> ranges over Char, Int, Short,
323        and Long.
324    
325    ----------------------------------------------------------------------
326    Name: Matthias Blume
327    Date: 2002/01/18
328    Tag: blume-20020118-use-x86-fp
329    Description:
330    
331    Now that x86-fast-fp seems to be working, I turned it back on again
332    by default.  (Seems to work fine now, even with the FFI.)
333    
334    Other than that, I added some documentation about the FFI to
335    src/ml-nlffigen/README and updated the FFI test examples in
336    src/ml-nlffi-lib/Tests/*.
337    
338    ----------------------------------------------------------------------
339    Name: Allen Leung
340    Date: 2002/01/17
341    Tag: leunga-20020117-x86-fast-fp-call
342    Description:
343    
344       1. Fixed a problem with handling return fp values when x86's fast fp
345          mode is turned on.
346    
347       2. Minor pretty printing fix for cellset.  Print %st(0) as %st(0) instead
348          of %f32.
349    
350       3. Added a constructor INT32lit to the ast of MLRISC tools.
351    
352    ----------------------------------------------------------------------
353    Name: Matthias Blume
354    Date: 2002/01/16
355    Tag: blume-20020116-ffifiddle
356    Description:
357    
358    More fiddling with the FFI interface:
359    
360     - Make constness 'c instead of rw wherever possible.  This eliminates
361       the need for certain explicit coercions.  (However, due to ML's
362       value polymorphism, there will still be many cases where explicit
363       coercions are necessary.  Phantom types are not the whole answer
364       to modeling a subtyping relationship in ML.)
365    
366     - ro/rw coersions for pointers added.  (Avoids the detour through */&.)
367    
368     - "printf" test example added to src/ml-nlffi-lib/Tests.  (Demonstrates
369       clumsy workaround for varargs problem.)
370    
371    ----------------------------------------------------------------------
372    Name: Lal George
373    Date: 2002/01/15
374    Tag: <none>
375    Description:
376    
377    1. Since COPY instructions are no longer native to the architecture,
378       a generic functor can be used to implement the expandCopies function.
379    
380    2. Allowed EXPORT and IMPORT pseudo-op declarations to appear inside a
381       TEXT segment.
382    
383    ----------------------------------------------------------------------
384    Name: Matthias Blume
385    Date: 2002/01/15
386    Tag: blume-20020115-ffiupdates
387    Description:
388    
389    1. Fix for bug resulting in single-precision float values being returned
390       incorrectly from FFI calls.
391    
392    2. Small modifications to C FFI API:
393    
394        - memory-allocation routines return straight objects (no options)
395          and raise an exception in out-of-memory situations
396        - unsafe extensions to cast between function pointers and pointers
397          from/to ints
398        - added structure C_Debug as an alternative to structure C where
399          pointer-dereferencing (|*| and |*!) always check for null-pointers
400        - added open_lib' to DynLinkage;  open_lib' works like open_lib
401          but also takes a (possibly empty) list of existing library handles
402          that the current library depends on
403    
404    ----------------------------------------------------------------------
405    Name: Matthias Blume
406    Date: 2002/01/10
407    Tag: blume-20020110-newffigen
408    Description:
409    
410    1. Updates to portable graph code.
411    
412    2. Major update to ml-nlffigen and ml-nlffi-lib.  Things are much
413       more scalable now so that even huge interfaces such as the one
414       for GTK compile in finite time and space. :-)
415       See src/ml-nlffigen/README for details on what's new.
416    
417    ----------------------------------------------------------------------
418    Name: Lal George
419    Date: 2001/01/09 14:31:35 EST 2002
420    Tag: george-20011206-rm-native-copy
421    Description:
422    
423            Removed the native COPY and FCOPY instructions
424            from all the architectures and replaced it with the
425            explicit COPY instruction from the previous commit.
426    
427            It is now possible to simplify many of the optimizations
428            modules that manipulate copies. This has not been
429            done in this change.
430    
431    ----------------------------------------------------------------------
432    Name: Lal George
433    Date: 2001/12/06 16:50:13 EST 2001
434    Tag: george-20011206-mlrisc-instruction
435    Description:
436    
437    Changed the representation of instructions from being fully abstract
438    to being partially concrete. That is to say:
439    
440      from
441            type instruction
442    
443      to
444            type instr                              (* machine instruction *)
445    
446            datatype instruction =
447                LIVE of {regs: C.cellset, spilled: C.cellset}
448              | KILL of {regs: C.cellset, spilled: C.cellset}
449              | COPYXXX of {k: CB.cellkind, dst: CB.cell list, src: CB.cell list}
450              | ANNOTATION of {i: instruction, a: Annotations.annotation}
451              | INSTR of instr
452    
453    This makes the handling of certain special instructions that appear on
454    all architectures easier and uniform.
455    
456    LIVE and KILL say that a list of registers are live or killed at the
457    program point where they appear. No spill code is generated when an
458    element of the 'regs' field is spilled, but the register is moved to
459    the 'spilled' (which is present, more for debugging than anything else).
460    
461    LIVE replaces the (now deprecated) DEFFREG instruction on the alpha.
462    We used to generate:
463    
464            DEFFREG f1
465            f1 := f2 + f3
466            trapb
467    
468    but now generate:
469    
470            f1 := f2 + f3
471            trapb
472            LIVE {regs=[f1,f2,f3], spilled=[]}
473    
474    Furthermore, the DEFFREG (hack) required that all floating point instruction
475    use all registers mentioned in the instruction. Therefore f1 := f2 + f3,
476    defines f1 and uses [f1,f2,f3]! This hack is no longer required resulting
477    in a cleaner alpha implementation. (Hopefully, intel will not get rid of
478    this architecture).
479    
480    COPYXXX is intended to replace the parallel COPY and FCOPY  available on
481    all the architectures. This will result in further simplification of the
482    register allocator that must be aware of them for coalescing purposes, and
483    will also simplify certain aspects of the machine description that provides
484    callbacks related to parallel copies.
485    
486    ANNOTATION should be obvious, and now INSTR represents the honest to God
487    machine instruction set!
488    
489    The <arch>/instructions/<arch>Instr.sml files define certain utility
490    functions for making porting easier -- essentially converting upper case
491    to lower case. All machine instructions (of type instr) are in upper case,
492    and the lower case form generates an MLRISC instruction. For example on
493    the alpha we have:
494    
495      datatype instr =
496         LDA of {r:cell, b:cell, d:operand}
497       | ...
498    
499      val lda : {r:cell, b:cell, d:operand} -> instruction
500        ...
501    
502    where lda is just (INSTR o LDA), etc.
503    
504    ----------------------------------------------------------------------
505    Name: Matthias Blume
506    Date: 2001/11/22 21:40:00 EST
507    Tag: Release_110_37
508    Description:
509    
510    Release 110.37.  This time for real.
511    
512    ----------------------------------------------------------------------
513    Name: Matthias Blume
514    Date: 2001/11/21 16:35:00 EST
515    Tag: blume-20011121-foot-in-mouth
516    Description:
517    
518    Removed the "Release_110_37" tag because of a serious bug.
519    This will be re-tagged once the bug is fixed.
520    
521    ----------------------------------------------------------------------
522    Name: Matthias Blume
523    Date: 2001/11/21 16:14:00 EST
524    Tag: blume-20011121-forgottenfile
525    Description:
526    
527    Forgot to add a file.  (Just a .tex-file -- part of
528    the CM manual source.)
529    
530    ----------------------------------------------------------------------
531    Name: Matthias Blume
532    Date: 2001/11/21 16:10:00 EST
533    Tag: blume-20011121-invalid_110_37
534    Description:
535    
536    Note: I removed the original tag "Release_110_37" from this commit
537          because we found a serious bug in all non-x86 backends.
538          - Matthias
539    
540    1. Modifications to the SML/NJ code generator and to the runtime system
541       so that code object name strings are directly inserted into code
542       objects at code generation time.  The only business the runtime system
543       has with this is now to read the name strings on occasions.
544       (The encoding of the name string has also changed somewhat.)
545    
546    2. CM now implements a simple "set calculus" for specifying export lists.
547       In particular, it is now possible to refer to the export lists of
548       other libraries/groups/sources and form unions as well as differences.
549       See the latest CM manual for details.
550    
551    3. An separate notion of "proxy" libraries has again be eliminated from
552       CM's model.  (Proxy libraries are now simply a special case of using
553       the export list calculus.)
554    
555    4. Some of the existing libraries now take advantage of the new set
556       calculus.
557       (Notice that not all libraries have been converted because some
558       of the existing .cm-files are supposed to be backward compatible
559       with 110.0.x.)
560    
561    5. Some cleanup in stand-alone programs.  (Don't use "exnMessage" -- use
562       "General.exnMessage"!  The former relies on a certain hook to be
563       initialized, and that often does not happen in the stand-alone case.)
564    
565    ----------------------------------------------------------------------
566    Name: Lal George
567    Date: 2001/11/21  13:56:18 EST
568    Tag: george-2001121-pseudo-ops
569    Description:
570    
571      Implemented a complete redesign of MLRISC pseudo-ops. Now there
572      ought to never be any question of incompatabilities with
573      pseudo-op syntax expected by host assemblers.
574    
575      For now, only modules supporting GAS syntax are implemented
576      but more should follow, such as MASM, and vendor assembler
577      syntax, e.g. IBM as, Sun as, etc.
578    
579    ----------------------------------------------------------------------
580    Name: Matthias Blume
581    Date: 2001/11/14 11:52:00 EST
582    Tag: blume-20011114-srcname
583    Description:
584    
585    1. Routed the name of the current source file to mlriscgen where it
586       should be directly emitted into the code object.  (This last part
587       is yet to be done.)
588    
589    2. Some cleanup of the pgraph code to make it match the proposal that
590       I put out the other day.  (The proposal notwithstanding, things are
591       still in flux here.)
592    
593    ----------------------------------------------------------------------
594    Name: Lal George
595    Date: 2001/11/14 09:44:04 EST
596    Tag:
597    Description:
598    
599      Fix for a backpatching bug reported by Allen.
600    
601      Because the boundary between short and long span-dependent
602      instructions is +/- 128, there are an astounding number of
603      span-dependent instructions whose size is over estimated.
604    
605      Allen came up with the idea of letting the size of span
606      dependent instructions be non-monotonic, for a maxIter
607      number of times, after which the size must be monotonically
608      increasing.
609    
610      This table shows the number of span-dependent instructions
611      whose size was over-estimated as a function of maxIter, for the
612      file Parse/parse/ml.grm.sml:
613    
614         maxIter            # of instructions:
615            10                      687
616            20                      438
617            30                      198
618            40                        0
619    
620      In compiling the compiler, there is no significant difference in
621      compilation speed between maxIter=10 and maxIter=40. Actually,
622      my measurements showed that maxIter=40 was a tad faster than
623      maxIter=10! Also 96% of the  files in the compiler reach a fix
624      point within 13 iterations, so fixing maxIter at 40, while high,
625      is okay.
626    
627    ----------------------------------------------------------------------
628    Name: Matthias Blume
629    Date: 2001/10/31 15:25:00 EST
630    Tag: blume-20011031-pgraph
631    Description:
632    
633    CKIT:
634    * Changed the "Function" constructor of type Ast.ctype to carry optional
635      argument identifiers.
636    * Changed the return type of TypeUtil.getFunction accordingly.
637    * Type equality ignores the argument names.
638    * TypeUtil.composite tries to preserve argument names but gives up quickly
639      if there is a mismatch.
640    
641    installation script:
642    * attempts to use "curl" if available (unless "wget" is available as well)
643    
644    CM:
645    * has an experimental implementation of "portable graphs" which I will
646      soon propose as an implementation-independent library format
647    * there are also new libraries $/pgraph.cm and $/pgraph-util.cm
648    
649    NLFFI-LIB:
650    * some cleanup (all cosmetic)
651    
652    NLFFIGEN:
653    * temporarily disabled the mechanism that suppresses ML output for
654      C definitions whose identifiers start with an underscore character
655    * generate val bindings for enum constants
656    * user can request that only one style (light or heavy) is being used;
657      default is to use both (command-line arguments: -heavy and -light)
658    * fixed bug in handling of function types involving incomplete pointers
659    * generate ML entry points that take record arguments (i.e., using
660      named arguments) for C functions that have a prototype with named
661      arguments
662      (see changes to CKIT)
663    
664    ----------------------------------------------------------------------
665    Name: Allen Leung
666    Date: 2001/10/27 20:34:00 EDT
667    Tag: leunga-20011027-x86-fast-fp-call
668    Description:
669    
670       Fixed the bug described in blume-20010920-slowfp.
671    
672       The fix involves
673          1. generating FCOPYs in FSTP in ia32-svid
674          2. marking a CALL with the appropriate annotation
675    
676    ----------------------------------------------------------------------
677    Name: Matthias Blume
678    Date: 2001/10/16 11:32:00 EDT
679    Tag: blume-20011016-netbsd
680    Description:
681    
682    Underscore patch from Chris Richards (fixing problem with compiling
683    runtime system under recent NetBSD).
684    
685    ----------------------------------------------------------------------
686    Name: Allen Leung
687    Date: 2001/10/12 17:18:32 EDT 2001
688    Tag: leung-20011012-x86-printflowgraph
689    Description:
690    
691    X86RA now uses a valid (instead of dummy) PrintFlowgraph module.
692    
693    ----------------------------------------------------------------------
694    Name: Lal George
695    Date: 2001/10/11 23:51:34 EDT
696    Tag: george-20011011-too-many-instrs
697    Description:
698    
699    The representation of a program point never expected to see more
700    than 65536 instructions in a basic block!
701    
702    ----------------------------------------------------------------------
703    Name: Lal George
704    Date: 2001/10/09 09:41:37 EDT
705    Tag: george-20011008-mlrisc-labels
706    Description:
707    
708    Changed the machine description files to support printing of
709    local and global labels in assembly code, based on host assembler
710    conventions.
711    
712    ----------------------------------------------------------------------
713    Name: Matthias Blume
714    Date: 2001/09/25 15:25:00 EDT
715    Tag: blume-20010925-exninfo
716    Description:
717    
718    I provided a non-hook implementation of exnName (at the toplevel) and
719    made the "dummy" implementation of exnMessage (at the toplevel) more
720    useful: if nothing gets "hooked in", then at least you are going to
721    see the exception name and a message indicating why you don't see more.
722    
723    [For the time being, programs that need exnMessage and want to use
724    ml-build should either use General.exnMessage (strongly recommended) or
725    refer to structure General at some other point so that CM sees a
726    static dependency.]
727    
728    [Similar remarks go for "print" and "use":  If you want to use their
729    functionality in stand-alone programs generated by ml-build, then use
730    TextIO.output and Backend.Interact.useFile (from $smlnj/compiler.cm).]
731    
732    ----------------------------------------------------------------------
733    Name: Matthias Blume
734    Date: 2001/09/20 17:28:00 EDT
735    Tag: blume-20010920-slowfp
736    Description:
737    
738    Allen says that x86-fast-fp is not safe yet, so I turned it off again...
739    
740    ----------------------------------------------------------------------
741    Name: Matthias Blume
742    Date: 2001/09/20 17:20:00 EDT
743    Tag: blume-20010920-canonicalpaths
744    Description:
745    
746    0. Updated the BOOT file (something that I forgot to do earlier).
747    
748    1. Small internal change to CM so that it avoids "/../" in filenames
749       as much as possible (but only where it is safe).
750    
751    2. Changed config/_run-sml (resulting in a changed bin/.run-sml) so
752       that arguments that contain delimiters are passed through correctly.
753       This change also means that all "special" arguments of the form
754       @SMLxxx... must come first.
755    
756    3. Changed install script to put relative anchor names for tool commands
757       into pathconfig.
758    
759    ----------------------------------------------------------------------
760    Name: Matthias Blume
761    Date: 2001/09/18 15:35:00 EDT
762    Tag: blume-20010918-readme11036
763    Description:
764    
765    Added README files.
766    
767    ----------------------------------------------------------------------
768    Name: Matthias Blume
769    Date: 2001/09/18 11:45:00 EDT
770    Tag: Release_110_36 (retag)
771    Description:
772    
773    Fixed mistake in config/preloads. Retagged as 110.36.
774    
775    ----------------------------------------------------------------------
776    Name: Matthias Blume
777    Date: 2001/09/18 09:40:00 EDT
778    Tag: Release_110_36_orig (tag changed)
779    Description:
780    
781    New version (110.36).  New bootfiles.
782    
783    ----------------------------------------------------------------------
784    Name: Matthias Blume
785    Date: 2001/09/14 16:15:00 EDT
786    Tag: blume-20010914-x86fastfp
787    Description:
788    
789    John committed some changes that Allen made, in particular a (hopefully)
790    correctly working version of the x86-fp module.
791    
792    I changed the default setting of the Control.MLRISC.getFlag "x86-fast-fp"
793    flag to "true".  Everything seems to compile to a fixpoint ok, and
794    "mandelbrot" speeds up by about 15%.
795    
796    ----------------------------------------------------------------------
797    Name: Matthias Blume
798    Date: 2001/09/13 11:20:00 EDT
799    Tag: blume-20010913-minimal
800    Description:
801    
802    1. Stefan Monnier's patch to fix a miscompilation problem that
803       was brought to light by John Reppy's work on Moby.
804    
805    2. Implemented a minimal "structure Compiler" that contains just
806       "version" and "architecture".  The minimal version will be
807       available when the full version is not.  This is for backward-
808       compatibility with code that wants to test Compiler.version.
809    
810    ----------------------------------------------------------------------
811    Name: Matthias Blume
812    Date: 2001/08/28 14:03:00 EDT
813    Tag: blume-20010828-ml-lex
814    Description:
815    
816    Fix for bug 1581, received from Neophytos Michael.
817    
818    ----------------------------------------------------------------------
819    Name: Matthias Blume
820    Date: 2001/08/27 11:20:00 EDT
821    Tag: blume-20010827-readme11035
822    Description:
823    
824    Fleshed out the README file for 110.35.
825    
826    ----------------------------------------------------------------------
827    Name: Matthias Blume
828    Date: 2001/08/24 17:10:00 EDT
829    Tag: Release_110_35
830    Description:
831    
832    New version number (110.35).  New bootfiles.
833    
834    ----------------------------------------------------------------------
835    Name: Lal George
836    Date: 2001/08/24 13:47:18 EDT 2001
837    Tag: george-20010824-MLRISC-graphs
838    Description:
839    
840     removed clusters from MLRISC completely and replaced with graphs.
841    
842    ----------------------------------------------------------------------
843    Name: Matthias Blume
844    Date: 2001/08/23 17:50:00 EDT
845    Tag: blume-20010823-toplevel
846    Description:
847    
848    - some reorganization of the code that implements various kinds of
849      environments in the compiler (static, dynamic, symbolic, combined)
850    - re-implemented the EnvRef module so that evalStream works properly
851      (if the stream contains references to "use", "CM.make", etc.)
852    - cleaned up evalloop.sml and interact.sml (but they need more cleaning)
853    
854    ----------------------------------------------------------------------
855    Name: Matthias Blume
856    Date: 2001/08/20 15:50 EDT
857    Tag: blume20010820-slipup
858    Description:
859    
860    I forgot to commit a few files.  Here they are...
861    
862    ----------------------------------------------------------------------
863    Name: Matthias Blume
864    Date: 2001/08/20 15:35:00 EDT
865    Tag: blume-20010820-debugprof
866    Description:
867    
868    !!!! NEW BOOTFILES !!!!
869    
870    This is another round of reorganizing the compiler sources.  This
871    time the main goal was to factor out all the "instrumentation"
872    passes (for profiling and backtracing) into their own library.
873    The difficulty was to do it in such a way that it does not depend
874    on elaborate.cm but only on elabdata.cm.
875    
876    Therefore there have been further changes to both elaborate.cm and
877    elabdata.cm -- more "generic" things have been moved from the former
878    to the latter.  As a result, I was forced to split the assignment
879    of numbers indicating "primtyc"s into two portions: SML-generic and
880    SML/NJ-specific.  Since it would have been awkward to maintain,
881    I bit the bullet and actually _changed_ the mapping between these
882    numbers and primtycs.  The bottom line of this is that you need
883    a new set of bin- and bootfiles.
884    
885    I have built new bootfiles for all architectures, so doing a fresh
886    checkout and config/install.sh should be all you need.
887    
888    The newly created library's name is
889    
890        $smlnj/viscomp/debugprof.cm
891    
892    and its sources live under
893    
894        src/compiler/DebugProf
895    
896    ----------------------------------------------------------------------
897    Name: Matthias Blume
898    Date: 2001/08/15 17:15:00 EDT
899    Tag: blume-20010815-compreorg
900    Description:
901    
902    This is a first cut at reorganizing the CM libraries that make up the
903    core of the compiler.  The idea is to separate out pieces that could
904    be used independently by tools, e.g., the parser, the typechecker, etc.
905    
906    The current status is a step in this direction, but it is not quite
907    satisfactory yet.  Expect more changes in the future.
908    
909    Here is the current (new) organization...
910    
911        What used to be $smlnj/viscomp/core.cm is now divided into
912        six CM libraries:
913    
914             $smlnj/viscomp/basics.cm
915                           /parser.cm
916                           /elabdata.cm
917                           /elaborate.cm
918                           /execute.cm
919                           /core.cm
920    
921        The CM files for these libraries live under src/system/smlnj/viscomp.
922        All these libraries are proxy libraries that contain precisely
923        one CM library component.  Here are the locations of the components
924        (all within the src/compiler tree):
925    
926             Basics/basics.cm
927             Parse/parser.cm
928             ElabData/elabdata.cm
929             Elaborator/elaborate.cm
930             Execution/execute.cm
931             core.cm
932    
933         [This organization is the same that has been used already
934         for a while for the architecture-specific parts of the visible
935         compiler and for the old version of core.cm.]
936    
937         As you will notice, many source files have been moved from their
938         respective original locations to a new home in one of the above
939         subtrees.
940    
941         The division of labor between the new libraries is the following:
942    
943             basics.cm:
944                - Simple, basic definitions that pertain to many (or all) of
945                  the other libraries.
946             parser.cm:
947                - The SML parser, producing output of type Ast.dec.
948                - The type family for Ast is also defined and exported here.
949             elabdata.cm:
950                - The datatypes that describe input and output of the elaborator.
951                  This includes types, absyn, and static environments.
952             elaborator.cm:
953                - The SML/NJ type checker and elaborator.
954                  This maps an Ast.dec (with a given static environment) to
955                  an Absyn.dec (with a new static environment).
956                - This libraries implements certain modules that used to be
957                  structures as functors (to remove dependencies on FLINT).
958             execute.cm:
959                - Everything having to do with executing binary code objects.
960                - Dynamic environments.
961             core.cm:
962                - SML/NJ-specific instantiations of the elaborator and MLRISC.
963                - Top-level modules.
964                - FLINT (this should eventually become its own library)
965    
966    Notes:
967    
968    I am not 100% happy with the way I separated the elaborator (and its
969    data structures) from FLINT.  Two instances of the same problem:
970    
971        1. Data structures contain certain fields that carry FLINT-specific
972           information.  I hacked around this using exn and the property list
973           module from smlnj-lib.  But the fact that there are middle-end
974           specific fields around at all is a bit annoying.
975    
976        2. The elaborator calculates certain FLINT-related information.  I tried
977           to make this as abstract as I could using functorization, but, again,
978           the fact that the elaborator has to perform calculations on behalf
979           of the middle-end at all is not nice.
980    
981        3. Having to used exn and property lists is unfortunate because it
982           weakens type checking.  The other alternative (parameterizing
983           nearly *everything*) is not appealing, though.
984    
985    I removed the "rebinding =" warning hack because due to the new organization
986    it was awkward to maintain it.  As a result, the compiler now issues some of
987    these warnings when compiling init.cmi during bootstrap compilation. On
988    the plus side, you also get a warning when you do, for example:
989       val op = = Int32.+
990    which was not the case up to now.
991    
992    I placed "assign" and "deref" into the _Core structure so that the
993    code that deals with the "lazy" keyword can find them there.  This
994    removes the need for having access to the primitive environment
995    during elaboration.
996    
997    ----------------------------------------------------------------------
998    Name: Matthias Blume
999    Date: 2001/08/13
1000    Tag: blume-20010813-closures
1001    Description:
1002    
1003    This fix was sent to us by Zhong Shao.  It is supposed to improve the
1004    performance of certain loops by avoiding needless closure allocation.
1005    
1006    ----------------------------------------------------------------------
1007    Name: Lal George
1008    Date: 2001/07/31 10:03:23 EDT 2001
1009    Tag: george-20010731-x86-fmalloc
1010    Description: Fixed bug in x86 calls
1011    
1012        There was a bug where call instructions would mysteriously
1013        vanish. The call instruction had to be one that returned
1014        a floating point value.
1015    
1016    ----------------------------------------------------------------------
1017    Name: Lal George
1018    Date: 2001/07/19 16:36:29 EDT 2001
1019    Tag: george-20010719-simple-cells
1020    Description:
1021    
1022    I have dramatically simplified the interface for CELLS in MLRISC.
1023    
1024    In summary, the cells interface is broken up into three parts:
1025    
1026      1. CellsBasis : CELLS_BASIS
1027    
1028            CellsBasis is a top level structure and common for all
1029            architectures.  it contains the definitions of basic datatypes
1030            and utility  functions over these types.
1031    
1032      2. functor Cells() : CELLS
1033    
1034            Cells generates an interface for CELLS that incorporates the
1035            specific resources on the target architecture, such as the
1036            presence of special register classes, their number and size,
1037            and various useful substructures.
1038    
1039      3. <ARCH>CELLS
1040    
1041            e.g. SparcCells: SPARCCELLS
1042    
1043            <ARCH>CELLS usually contains additional bindings for special
1044            registers  on the architecture, such as:
1045    
1046                    val r0 : cell           (* register zero *)
1047                    val y : cell            (* Y register *)
1048                    val psr : cell          (* processor status register *)
1049                    ...
1050    
1051            The structure returned by applying the Cells functor is opened
1052            in this interface.
1053    
1054    The main implication of all this is that the datatypes for cells is
1055    split between CellsBasis and CELLS -- a fairly simple change for user
1056    code.
1057    
1058    In the old scheme the CELLS interface had a definitional binding of
1059    the form:
1060    
1061            signature CELLS = sig
1062    
1063               structure CellsBasis = CellsBasis
1064    
1065               ...
1066    
1067            end
1068    
1069    With all the sharing constraints that goes on in MLRISC, this old
1070    design  quickly leads to errors such as:
1071    
1072            "structure definition spec inside of sharing ... "
1073    
1074    
1075    and appears to require an unacceptable amount of sharing and where
1076    constraint hackery.
1077    
1078    I think this error message (the interaction of definitional specs and
1079    sharing) requires more explanation on our web page.
1080    
1081    ----------------------------------------------------------------------
1082    Name: Matthias Blume
1083    Date: 2001/07/19 15:00:00 EDT
1084    Tag: blume-20010719-libreorg
1085    Description:
1086    
1087    This update puts together a fairly extensive but straightforward change
1088    to the way the libraries that implement the interactive system are
1089    organized:
1090    
1091       The biggest change is the elimination of structure Compiler.  As a
1092       replacement for this structure, there is now a CM library
1093       (known as $smlnj/compiler.cm or $smlnj/compiler/current.cm)
1094       that exports all the substructures of the original structure Compiler
1095       directly.  So instead of saying Compiler.Foo.bar one now simply
1096       says Foo.bar.  (The CM libraries actually export a collection of
1097       structures that is richer than the collection of substructures of
1098       structure Compiler.)
1099    
1100       To make the transition smooth, there is a separate library called
1101       $smlnj/compiler/compiler.cm which puts together and exports the
1102       original structure Compiler (or at least something very close to it).
1103    
1104       There are five members of the original structure Compiler
1105       that are not exported directly but which instead became members
1106       of a new structure Backend (described by signature BACKEND).  These are:
1107       structure Profile (: PROFILE), structure Compile (: COMPILE), structure
1108       Interact (: INTERACT), structure Machine (: MACHINE), and val
1109       architecture (: string).
1110    
1111       Structure Compiler.Version has become structure CompilerVersion.
1112    
1113       Cross-compilers for alpha32, hppa, ppc, sparc, and x86 are provided
1114       by $smlnj/compiler/<arch>.cm where <arch> is alpha32, hppa, ppc, sparc,
1115       or x86, respectively.
1116       Each of these exports the same frontend structures that
1117       $smlnj/compiler.cm exports.  But they do not have a structure Backend
1118       and instead export some structure <Arch>Backend where <Arch> is Alpha32,
1119       Hppa, PPC, Sparc, or X86, respectively.
1120    
1121       Library $smlnj/compiler/all.cm exports the union of the exports of
1122       $smlnj/compiler/<arch>.cm
1123    
1124       There are no structures <Arch>Compiler anymore, use
1125       $smlnj/compiler/<arch>.cm instead.
1126    
1127       Library host-compiler-0.cm is gone.  Instead, the internal library
1128       that instantiates CM is now called cm0.cm.  Selection of the host
1129       compiler (backend) is no longer done here but. (Responsibility for it
1130       now lies with $smlnj/compiler/current.cm.  This seems to be more
1131       logical.)
1132    
1133       Many individual files have been moved or renamed.  Some files have
1134       been split into multiple files, and some "dead" files have been deleted.
1135    
1136    Aside from these changes to library organization, there are also changes
1137    to the way the code itself is organized:
1138    
1139       Structure Binfile has been re-implemented in such a way that it no
1140       longer needs any knowledge of the compiler.  It exclusively deals
1141       with the details of binfile layout.  It no longer invokes the
1142       compiler (for the purpose of creating new prospective binfile
1143       content), and it no longer has any knowledge of how to interpret
1144       pickles.
1145    
1146       Structure Compile (: COMPILE) has been stripped down to the bare
1147       essentials of compilation.  It no longer deals with linking/execution.
1148       The interface has been cleaned up considerably.
1149    
1150       Utility routines for dealing with linking and execution have been
1151       moved into their own substructures.
1152    
1153       (The ultimate goal of these changes is to provide a light-weight
1154       binfile loader/linker (at least for, e.g., stable libraries) that
1155       does not require CM or the compiler to be present.)
1156    
1157    CM documentation has been updated to reflect the changes to library
1158    organization.
1159    
1160    ----------------------------------------------------------------------
1161    Name: Matthias Blume
1162    Date: 2001/07/10 17:30:00 EDT
1163    Tag: Release_110_34
1164    Description:
1165    
1166    Minor tweak to 110.34 (re-tagged):
1167    
1168      - README.html file added to CVS repository
1169      - runtime compiles properly under FreeBSD 3.X and 4.X
1170    
1171    ----------------------------------------------------------------------
1172    Name: Matthias Blume
1173    Date: 2001/07/10 17:30:00 EDT
1174    Tag: Release_110_34
1175    Description:
1176    
1177    New version number (110.34). New bootfiles.
1178    
1179    ----------------------------------------------------------------------
1180    Name: Matthias Blume
1181    Date: 2001/07/09 16:00:00 EDT
1182    Tag: blume-20010709-more-varargs
1183    Description:
1184    
1185    I changed the handling of varargs in ml-nlffigen again:
1186    The ellipsis ... will now simply be ignored (with an accompanying warning).
1187    
1188    The immediate effect is that you can actually call a varargs function
1189    from ML -- but you can't actually supply any arguments beyond the ones
1190    specified explicitly.  (For example, you can call printf with its format
1191    string, but you cannot pass additional arguments.)
1192    
1193    This behavior is only marginally more useful than the one before, but
1194    it has the advantage that a function or, more importantly, a function
1195    type never gets dropped on the floor, thus avoiding follow-up problems with
1196    other types that refer to the offending one.
1197    
1198    ----------------------------------------------------------------------
1199    Name: Matthias Blume
1200    Date: 2001/07/09 11:25:00 EDT
1201    Tag: blume-20010709-varargs
1202    Description:
1203    
1204    1. ckit-lib.cm now exports structure Error
1205    2. ml-nlffigen reports occurences of "..." (i.e., varargs function types)
1206       with a warning accompanied by a source location.  Moreover, it
1207       merely skips the offending function or type and proceeds with the
1208       rest of its work.u  As a result, one can safely feed C code containing
1209       "..." to ml-nlffigen.
1210    3. There are some internal improvements to CM, providing slightly
1211       more general string substitutions in the tools subsystem.
1212    
1213    ----------------------------------------------------------------------
1214    Name: Matthias Blume
1215    Date: 2001/06/27 15:10:00 EDT
1216    Tag: blume-20010627-concur
1217    Description:
1218    
1219    Fixed a small bug in CM's handling of parallel compilation.
1220    (You could observe the bug by Control-C-interrupting an ordinary
1221    CMB.make or CM.stabilize and then attaching some compile servers.
1222    The result was that all of a sudden the previously interrupted
1223    compilation would continue on its own.  This was because of
1224    an over-optimization: CM did not bother to clean out certain queues
1225    when no servers were attached "anyway", resulting in the contents
1226    of these queues to grab control when new servers did get attached.)
1227    
1228    There is also another minor update to the CM manual.
1229    
1230    ----------------------------------------------------------------------
1231    Name: Matthias Blume
1232    Date: 2001/06/26 16:15:00 EDT
1233    Tag: blume-20010626-cmdoc
1234    Description:
1235    
1236    Minor typo fixed in CM manual (syntax diagram for libraries).
1237    
1238    ----------------------------------------------------------------------
1239    Name: Matthias Blume
1240    Date: 2001/06/25 22:55:00 EDT
1241    Tag: blume-20010625-x86pc
1242    Description:
1243    
1244    Fixed a nasty bug in the X86 assembly code that caused signal
1245    handlers to fail (crash) randomly.
1246    
1247    ----------------------------------------------------------------------
1248    Name: Matthias Blume
1249    Date: 2001/06/25 12:05:00 EDT
1250    Tag: blume-20010625-nlffigen
1251    Description:
1252    
1253    This update fixes a number of minor bugs in ml-nlffigen as reported by
1254    Nick Carter <nbc@andrew.cmu.edu>.
1255    
1256      1. Silly but ok typedefs of the form "typedef void myvoid;" are now accepted.
1257      2. Default names for generated files are now derived from the name of
1258         the C file *without its directory*.  In particular, this causes generated
1259         files to be placed locally even if the C file is in some system directory.
1260      3. Default names for generated signatures and structures are also derived
1261         from the C file name without its directory.  This avoids silly things
1262         like "structure GL/GL".
1263         (Other silly names are still possible because ml-nlffigen does not do
1264          a thorough check of whether generated names are legal ML identifiers.
1265          When in doubt, use command line arguments to force particular names.)
1266    
1267    ----------------------------------------------------------------------
1268    Name: Matthias Blume
1269    Date: 2001/06/21 12:25:00 EDT
1270    Tag: blume-20010621-eXene
1271    Description:
1272    
1273    eXene now compiles and (sort of) works again.
1274    
1275    The library name (for version > 110.33) is $/eXene.cm.
1276    
1277    I also added an new example in src/eXene/examples/nbody.  See the
1278    README file there for details.
1279    
1280    ----------------------------------------------------------------------
1281    Name: Matthias Blume
1282    Date: 2001/06/20 16:40:00 EDT
1283    Tag: blume-20010620-cml
1284    Description:
1285    
1286    CML now compiles and works again.
1287    
1288    Libraries (for version > 110.33):
1289    
1290      $cml/cml.cm            Main CML library.
1291      $cml/basis.cm          CML's version of $/basis.cm.
1292      $cml/cml-internal.cm   Internal helper library.
1293      $cml/core-cml.cm       Internal helper library.
1294      $cml-lib/trace-cml.cm  Tracing facility.
1295      $cml-lib/smlnj-lib.cm  CML's version of $/smlnj-lib.cm
1296    
1297    The installer (config/install.sh) has been taught how to properly
1298    install this stuff.
1299    
1300    ----------------------------------------------------------------------
1301    Name: Matthias Blume
1302    Date: 2001/06/19 17:55:00 EDT
1303    Tag: blume-20010619-instantiate
1304    Description:
1305    
1306    This un-breaks the fix for bug 1432.
1307    (The bug was originally fixed in 110.9 but I broke it again some
1308    time after that.)
1309    
1310    ----------------------------------------------------------------------
1311    Name: Matthias Blume
1312    Date: 2001/06/19 17:25:00 EDT
1313    Tag: blume-20010619-signals
1314    Description:
1315    
1316    This should (hopefully) fix the long-standing signal handling bug.
1317    (The runtime system was constructing a continuation record with an
1318    incorrect descriptor which would cause the GC to drop data on the floor...)
1319    
1320    ----------------------------------------------------------------------
1321    Name: Matthias Blume
1322    Date: 2001/06/15 15:05:00 EDT
1323    Tag: blume-20010615-moresparc
1324    Description:
1325    
1326    Here is a short late-hour update related to Sparc c-calls:
1327    
1328     -- made handling of double-word arguments a bit smarter
1329    
1330     -- instruction selection phase tries to collapse certain clumsily
1331        constructed ML-Trees; typical example:
1332    
1333            ADD(ty,ADD(_,e,LI d1),LI d2)  ->  ADD(ty,e,LI(d1+d2))
1334    
1335        This currently has no further impact on SML/NJ since mlriscGen does
1336        not seem to generate such patterns in the first place, and c-calls
1337        (which did generate them in the beginning) has meanwhile been fixed
1338        so as to avoid them as well.
1339    
1340    ----------------------------------------------------------------------
1341    Name: Matthias Blume
1342    Date: 2001/06/15 15:05:00 EDT
1343    Tag: blume-20010615-sparc
1344    Description:
1345    
1346    The purpose of this update is to provide an implementation of NLFFI
1347    on Sparc machines.
1348    
1349    Here are the changes in detail:
1350    
1351       * src/MLRISC/sparc/c-calls/sparc-c-calls.sml is a new file containing
1352       the Sparc implementation of the c-calls API.
1353       * The Sparc backend of SML/NJ has been modified to uniformely use %fp
1354       for accessing the ML frame.  Thus, we have a real frame pointer and
1355       can freely modify %sp without need for an omit-frame-ptr phase.
1356       The vfp logic in src/compiler/CodeGen/* has been changed to accomodate
1357       this case.
1358       * ml-nlffigen has been taught to produce code for different architectures
1359       and calling conventions.
1360       * In a way similar to what was done in the x86 case, the Sparc
1361       backend uses its own specific extension to mltree.  (For example,
1362       it needs to be able to generate UNIMP instructions which are part
1363       of the calling convention.)
1364       * ml-nlffi-lib was reorganized to make it more modular (in particular,
1365       to make it easier to plug in new machine- and os-dependent parts).
1366    
1367    There are some other fairly unrelated bug fixes and cleanups as well:
1368    
1369       * I further hacked the .cm files for MLRISC tools (like MDLGen) so
1370       that they properly share their libraries with existing SML/NJ libraries.
1371       * I fixed a minor cosmetic bug in CM, supressing certain spurious
1372       follow-up error messages.
1373       * Updates to CM/CMB documentation.
1374    
1375    TODO items:
1376    
1377       * MLRISC should use a different register as its asmTemp on the Sparc.
1378         (The current %o2 is a really bad choice because it is part of the
1379         calling conventions, so things might interfere in unexpected ways.)
1380    
1381    ----------------------------------------------------------------------
1382    Name: Matthias Blume
1383    Date: 2001/06/07
1384    Tag: blume-20010607-calls
1385    Description:
1386    
1387    A number of internal changes related to C calls and calling conventions:
1388    
1389    1. ML-Tree CALL statements now carry a "pops" field.  It indicates the
1390       number of bytes popped implicitly (by the callee).  In most cases
1391       this field is 0 but on x86/win32 it is some non-zero value.  This
1392       is information provided for the benefit of the "omit-frameptr" pass.
1393    2. The CALL instruction on the x86 carries a similar "pops" field.
1394       The instruction selection phase copies its value from the ML-Tree
1395       CALL statement.
1396    3. On all other architectures, the instruction selection phase checks
1397       whether "pops=0" and complains if not.
1398    4. The c-calls implementation for x86 now accepts two calling conventions:
1399       "ccall" and "stdcall".  When "ccall" is selected, the caller cleans
1400       up after the call and pops is set to 0.  For "stdcall", the caller
1401       does nothing, leaving the cleanup to the callee; pops is set to
1402       the number of bytes that were pushed onto the stack.
1403    5. The cproto decoder (compiler/Semant/types/cproto.sml) now can
1404       distinguish between "ccall" and "stdcall".
1405    6. The UNIMP instruction has been added to the supported Sparc instruction
1406       set. (This is needed for implementing the official C calling convention
1407       on this architecture.)
1408    7. I fixed some of the .cm files under src/MLRISC/Tools to make them
1409       work with the latest CM.
1410    
1411    ----------------------------------------------------------------------
1412    Name: Matthias Blume
1413    Date: 2001/06/05 15:10:00 EDT
1414    Tag: blume-20010605-cm-index
1415    Description:
1416    
1417    0. The "lambdasplit" parameter for class "sml" in CM has been documented.
1418    
1419    1. CM can now generate "index files".  These are human-readable files
1420       that list on a per-.cm-file basis each toplevel symbol defined or
1421       imported.  The location of the index file for
1422       <p>/<d>.cm is <p>/CM/INDEX/<d>.cm.
1423       To enable index-file generation, set CM.Control.generate_index to true
1424       or export an environment-symbol: export CM_GENERATE_INDEX=true.
1425    
1426       The CM manual has been updated accordingly.
1427    
1428    2. I made some slight modifications to the c-calls API in MLRISC.
1429    
1430         a) There is now a callback to support saving/restoring of
1431            dedicated but caller-save registers around the actual call
1432            instruction.
1433         b) One can optionally specify a comment-annotation for the
1434            call instruction.
1435    
1436    3. SML/NJ (mlriscGen.sml) uses this new API for the rawccall primop.
1437       (For example, the comment annotation shows the C prototype of
1438        the function being called.)
1439    
1440    ----------------------------------------------------------------------
1441    Name: Matthias Blume
1442    Date: 2001/06/01 13:30:00 EDT
1443    Tag: blume-20010601-nlffi-cleanup
1444    Description:
1445    
1446    This is mostly a cleanup of MLFFI stuff:
1447    
1448       - some signature files have been put into a more exposed place
1449       - the ugly 'f type parameter is gone (simplifies types tremendously!)
1450       - ml-nlffigen changed accordingly
1451       - tutorial updated
1452    
1453    Other changes:
1454    
1455       - author's affiliation in CM manual(s) updated
1456       - some more recognized keywords added to Allen's sml.sty
1457    
1458    ----------------------------------------------------------------------
1459    Name: Matthias Blume
1460    Date: 2001/05/25 15:30:00 EDT
1461    Tag: blume-20010525-iptr
1462    Description:
1463    
1464      - put the official 110.33-README (as it appears on the ftp server) under
1465        CVS
1466      - fixed a small bug related to incomplete pointer types in
1467        ml-nlffigen
1468      - small cosmetic change to the ml-nlffi-lib's "arr" type constructor
1469        (it does not need the 'f type parameter)
1470    
1471    ----------------------------------------------------------------------
1472    Name: Matthias Blume
1473    Date: 2001/05/23 14:30:00 EDT
1474    Tag: Release_110_33
1475    Description:
1476    
1477    New version number (110.33).  New bootfiles.
1478    
1479    ----------------------------------------------------------------------
1480    Name: Matthias Blume
1481    Date: 2001/05/22 18:06:00 EDT
1482    Tag: blume-20010522-targets
1483    Description:
1484    
1485    Made install.sh use file config/targets.customized if it exists, falling
1486    back to config/targets if it doesn't.  This way one can have a customized
1487    version of the targets file without touching the "real thing", thus
1488    eliminating the constant fear of accidentally checking something bogus
1489    back into the CVS repository...  (File config/targets.customized must
1490    not be added to the repository!)
1491    
1492    ----------------------------------------------------------------------
1493    Name: Matthias Blume
1494    Date: 2001/05/22 16:30:00 EDT
1495    Tag: blume-20010522-minitut
1496    Description:
1497    
1498    1. Bug fix in ml-nlffigen; now (hopefully) correctly handling
1499       struct returns.
1500    2. Added src/ml-nlffi-lib/Doc/mini-tutorial.txt.  This is some very
1501       incomplete, preliminary documentation for NLFFI.
1502    
1503    ----------------------------------------------------------------------
1504    Name: Matthias Blume
1505    Date: 2001/05/14 11:30:00 EDT
1506    Tag: blume-20010514-script
1507    Description:
1508    
1509    Some bugs in install script fixed.
1510    
1511    In addition to that I also made a slight change to the NLFFI API:
1512    Functors generated by ml-nlffigen now take the dynamic library as a
1513    straight functor argument, not as a suspended one.  (The original
1514    functor code used to force the suspension right away anyway, so there
1515    was nothing gained by this complication of the interface.)
1516    
1517    ----------------------------------------------------------------------
1518    Name: Matthias Blume
1519    Date: 2001/05/11 14:35:00 EDT
1520    Tag: blume-20010511-ml-nlffi
1521    Description:
1522    
1523    I finally took the plunge and added my new FFI code to the main
1524    repository.  For x86-linux it is now ready for prime-time.
1525    
1526    There are two new subdirectories of "src":
1527    
1528      - ml-nlffi-lib:
1529           The utility library for programs using the FFI interface.
1530           Here is the implementation of $/c.cm and its associated low-level
1531           partners $/c-int.cm and $/memory.cm.
1532      - ml-nlffigen:
1533           A stand-alone program for generating ML glue code from C source
1534           code.
1535    
1536    Building ml-nlffigen requires $/ckit-lib.cm.
1537    
1538    The config/install.sh script has been updates to do the Right Thing
1539    (hopefully).
1540    
1541    Notice that the source tree for the C-Kit will not be put under "src"
1542    but directly under the installation root directory.  (This is the
1543    structure that currently exists on the CVS server when you check out
1544    module "sml".)  Fortunately, config/install.sh knows about this oddity.
1545    
1546    Bugs: No documentation yet.
1547    
1548    ----------------------------------------------------------------------
1549    Name: Matthias Blume
1550    Date: 2001/05/09 16:35:00 EDT
1551    Tag: blume-20010509-cpscontract
1552    Description:
1553    
1554    Fixed a bug in the accounting code in cpsopt/contract.sml.  (The
1555    wrapper/unwrapper elimination did not decrement usage counts and some
1556    dead variables got overlooked by the dead-up logic.)
1557    
1558    ----------------------------------------------------------------------
1559    Name: Lal George
1560    Date: 2001/05/08  17:26:09 EDT
1561    Tag: george-20010508-omit-frameptr
1562    Description:
1563    
1564    Changes to implement the omit-frame-pointer optimization to support
1565    raw C calls. For now, there is only support on the Intel x86, but
1566    other architectures will follow as more experience is gained with this.
1567    
1568    
1569    ----------------------------------------------------------------------
1570    Name: Matthias Blume
1571    Date: 2001/05/07 14:40:00 EDT
1572    Tag: blume-20010507-proxies
1573    Description:
1574    
1575    I made into "proxy libraries" all libraries that qualify for such a
1576    change.  (A qualifying library is a library that has another library or
1577    groups as its sole member and repeats that member's export list
1578    verbatim.  A proxy library avoids this repetition by omitting its export
1579    list, effectively inheriting the list that its (only) member exports.
1580    See the CM manual for more explanation.)
1581    The main effect is that explicit export lists for these libraries
1582    do not have to be kepts in sync, making maintenance a bit easier.
1583    
1584    I also added copyright notices to many .cm-files.
1585    
1586    Last but not least, I made a new set of bootfiles.
1587    
1588    ----------------------------------------------------------------------
1589    Name: Matthias Blume
1590    Date: 2001/05/04 17:00:00 EDT
1591    Tag: blume-20010504-cm-lsplit
1592    Description:
1593    
1594    0. John merged pending changes to $/smlnj-lib.cm
1595    
1596    1. Allen's previous change accidentally backed out of one of Lal's
1597       earlier changes.  I undid this mistake (re-introducing Lal's change).
1598    
1599    2. I used the new topOrder' function from graph-scc.sml (from $/smlnj-lib.cm)
1600       within the compiler where applicable.  There is some code simplification
1601       because of that.
1602    
1603    3. The "split" phase (in FLINT) is now part of the default list of phases.
1604       Compiler.Control.LambdaSplitting.* can be used to globally control the
1605       lambda-splitting (cross-module-inlining) engine.  In addition to that,
1606       it can now also be controlled on a per-source basis: CM has been taught
1607       a new tool parameter applicable to ML source files.
1608    
1609       - To turn lambda-splitting off completely:
1610            local open Compiler.Control.LambdaSplitting in
1611                val _ = set Off
1612            end
1613       - To make "no lambda-splitting" the global default (but allow per-source
1614         overriding); this is the initial setting:
1615            local open Compiler.Control.LambdaSplitting in
1616                val _ = set (Default NONE)
1617            end
1618       - To make "lambda-splitting with aggressiveness a" the global default
1619         (and allow per-source overriding):
1620            local open Compiler.Control.LambdaSplitting in
1621                val _ = set (Default (SOME a))
1622            end
1623    
1624       - To turn lambda-splitting off for a given ML souce file (say: a.sml)
1625         write (in the respective .cm-file):
1626            a.sml (lambdasplitting:off)
1627       - To turn lambda-splitting for a.sml on with minimal aggressiveness:
1628            a.sml (lambdasplitting:on)
1629       - To turn lambda-splitting for a.sml on with aggressiveness <a> (where
1630         <a> is a decimal non-negative integer):
1631            a.sml (lambdasplitting:<a>)
1632       - To turn lambda-splitting for a.sml on with maximal aggressiveness:
1633            a.sml (lambdasplitting:infinity)
1634       - To use the global default for a.sml:
1635            a.sml (lambdasplitting:default)
1636         or simply
1637            a.sml
1638    
1639    ----------------------------------------------------------------------
1640    Name: Allen Leung
1641    Date: 2001/05/04 01:57:00 EDT
1642    Tag: leunga-20010504-sync
1643    Description:
1644    
1645      MLRISC features.
1646    
1647      1. Fix to CMPXCHG instructions.
1648      2. Changed RA interface to allow annotations in callbacks.
1649      3. Added a new method to the stream interface to allow annotations updates.
1650    
1651    ----------------------------------------------------------------------
1652    Name: Matthias Blume
1653    Date: 2001/05/01 11:45:00 EDT
1654    Tag: blume-20010501-pcedittmp
1655    Description:
1656    
1657    Changed install.sh to use the current working directory instead of
1658    /usr/tmp for a temporary file (pcedittmp).  The previous choice
1659    of /usr/tmp caused trouble with MacOS X because of file premission
1660    problems.
1661    
1662    ----------------------------------------------------------------------
1663    Name: Matthias Blume
1664    Date: 2001/04/20 11:10:00 EDT
1665    Tag: blume-20010420-inMLflag
1666    Description:
1667    
1668     - added vp_limitPtrMask to vproc-state.h
1669       (for use by the raw-C-calls mechanism to implement proper interrupt
1670        handling)
1671     - made the ML compiler aware of various data-structure offsets so it
1672       can generate code for accessing the vp_inML flag and vp_limitPtrMask
1673     - tweaked mlriscGen.sml to have it emit interrupt-handling code for
1674       raw C-calls
1675    
1676    ----------------------------------------------------------------------
1677    Name: Lal George
1678    Date: 2001/04/20 09:15:28 EDT
1679    Tag: george-20010420-macosX
1680    Description:
1681    
1682     - Changes to port to Mac OS X; Darwin.
1683    
1684     - In the process I found that sqrt was broken on the PPC, because the
1685       fsqrt instruction is not implemented.
1686    
1687    ----------------------------------------------------------------------
1688    Name: Matthias Blume
1689    Date: 2001/04/18 12:45:00 EDT
1690    Tag: blume-20010418-ccalls
1691    Description:
1692    
1693     - fixed two off-by-4 errors in the x86-specific c-calls implementation
1694       (this bug prevented structure arguments containing pointers from being
1695        passed correctly)
1696     - changed the raw-C-call code in mlriscGen.sml in such a way that
1697       structure arguments are represented as a pointer to the beginning
1698       of the structure (instead of having a series of synthesized arguments,
1699       one for each structure member)
1700    
1701     - made makeml script's verbosity level configurable via environment
1702       variable (MAKEML_VERBOSITY)
1703    
1704     - eliminated placeholder implementations for f32l, w16s, i16s, and f32s
1705       in rawmem-x86.sml; we are now using the real thing
1706    
1707    ----------------------------------------------------------------------
1708    Name: Matthias Blume
1709    Date: 2001/03/22 16:25:00 EST
1710    Tag: blume-20010322-bootfiles
1711    Description:
1712    
1713    Created a new set of bootfiles (for your automatic installation convenience).
1714    
1715    ----------------------------------------------------------------------
1716    Name: Matthias Blume
1717    Date: 2001/03/22 15:10:00 EST
1718    Tag: blume-20010322-rawmem-parcm
1719    Description:
1720    
1721    1. All "raw memory access" primitives for the new FFI are implemented now
1722       (at least on the x86).
1723    2. Some further cleanup of CM's parallel make mechanism.
1724    
1725    ----------------------------------------------------------------------
1726    Name: Matthias Blume
1727    Date: 2001/03/19 17:53:00 EST
1728    Tag: blume-20010319-parallel
1729    Description:
1730    
1731    Parallel make (using compile servers) now works again.
1732    
1733    To this end, CM.stabilize and CMB.make have been modified to work in
1734    two passes when compile servers are attached:
1735       1. Compile everything, do not perform stabilization; this pass
1736          uses compile servers
1737       2. Stabilize everything; this pass does not use compile servers
1738    If there are no compile servers, the two passes are combined into one
1739    (as before).  Splitting the passes increases the inherent parallelism
1740    in the dependency graph because the entire graph including all
1741    libraries is available at the same time.  This, in turn, improves
1742    server utilization.  The downside is that the master process will
1743    have to do some extra work after compilation is done (because for
1744    technical reasons it must re-read all the binfiles during stabilization).
1745    
1746    ----------------------------------------------------------------------
1747    Name: Matthias Blume
1748    Date: 2001/03/16 12:22:00 EST
1749    Tag: blume-20010316-bootfiles
1750    Description:
1751    
1752    Created a new set of bootfiles (for your automatic installation convenience).
1753    
1754    ----------------------------------------------------------------------
1755    Name: Matthias Blume
1756    Date: 2001/03/16 11:00:00 EST
1757    Tag: blume-20010316-MLTREE-fixup
1758    Description:
1759    
1760    This is a minor fixup for an (untagged) earlier commit by Allen.
1761    (A file was missing).
1762    
1763    ----------------------------------------------------------------------
1764    Name: Allen Leung
1765    Date: Mon Mar  5 18:54:57 EST 2001
1766    Tag: leunga-20010305-cut-support
1767    
1768    1. New support for alternative control-flow in MLTREE.
1769       Currently we support
1770    
1771          FLOW_TO(CALL ...., [k1,...,kn])
1772    
1773       This is needed for 'cuts to' in C-- and try/handle-like constructs
1774       in Moby
1775    
1776       New assembler flag "asm-show-cutsto" to turn on control-flow debugging.
1777    
1778    2. Register Allocator
1779    
1780       Changes in interface [from Fermin, John]
1781    
1782    3. Alpha 8-bit SLL support [Fermin]
1783    
1784    4. All architectures
1785    
1786       A new module (ClusterExpandCopies) for expanding parallel copies.
1787    
1788    ----------------------------------------------------------------------
1789    Name: Allen Leung
1790    Date: 2001/02/27 23:07:00 EST
1791    Tag: leunga-20010227-minor-stuff
1792    
1793    1. Alpha bug fix for CMOVNE
1794    2. Handle mltree COND(..,FCMP ...,...)
1795    3. Bug fix in simplifier
1796    
1797    ----------------------------------------------------------------------
1798    Name: Matthias Blume
1799    Date: 2001/01/30 17:50:00 EST
1800    Tag: blume-20010130-sync
1801    Description:
1802    
1803    This is just a minor update to sync my devel branch with the main brach.
1804    The only visible change is the addition of some README files.
1805    
1806    ----------------------------------------------------------------------
1807    Name: Matthias Blume
1808    Date: 2001/01/12 23:30:00 JST
1809    Tag: blume-20010112-bootfiles
1810    Description:
1811    
1812    Made a new set of bootfiles that goes with the current state of the
1813    repository.
1814    
1815    ----------------------------------------------------------------------
1816    Name: Matthias Blume
1817    Date: 2001/01/12 21:20:00 JST
1818    Tag: blume-20010112-sync
1819    Description:
1820    
1821    I am just flushing out some minor changes that had accumulated in
1822    my private branch in order to sync with the main tree.  (This is
1823    mainly because I had CVS trouble when trying to merge _into_ my
1824    private branch.)
1825    
1826    Most people should be completely unaffected by this.
1827    
1828    ----------------------------------------------------------------------
1829    Name: Allen Leung
1830    Date: Thu Jan 11 21:03:00 EST 2001
1831    Tag: leunga-20010111-labexp=mltree
1832    Description:
1833    
1834    1.  Removed the type LabelExp and replace it by MLTree.
1835    2.  Rewritten mltree-simplify with the pattern matcher tool.
1836    3.  There were some bugs in alpha code generator which would break
1837        64-bit code generation.
1838    4.  Redo the tools to generate code with the
1839    5.  The CM files in MLRISC (and in src/system/smlnj/MLRISC)
1840        are now generated by perl scripts.
1841    
1842    ----------------------------------------------------------------------
1843    Name: Matthias Blume
1844    Date: 2001/01/10 21:55:00 JST
1845    Tag: blume-20010110-rcc
1846    Description:
1847    
1848    The RCC stuff now seems to work (but only on the x86).
1849    This required hacking of the c-calls interface (and -implementation) in
1850    MLRISC.
1851    
1852    Normal compiler users should be unaffected.
1853    
1854    ----------------------------------------------------------------------
1855    Name: Matthias Blume
1856    Date: 2001/01/09 01:20:00 JST
1857    Tag: blume-20010109-rcc
1858    Description:
1859    
1860    This is a fairly big patch, flushing out a large number of pending
1861    changes that I made to my development copy over the last couple of days.
1862    
1863    Of practical relevance at this moment is a workaround for a pickling
1864    bug that Allen ran into the other day.  The cause of the bug itself is
1865    still unknown and it might be hard to fix it properly, but the
1866    workaround has some merits of its own (namely somewhat reducing pickling
1867    overhead for certain libraries).  Therefore, I think this solution should
1868    be satisfactory at this time.
1869    
1870    The rest of the changes (i.e., the vast majority) has to do with my
1871    ongoing efforts of providing direct support for C function calls from
1872    ML.  At the moment there is a new primop "RAW_CCALL", typing magic
1873    in types/cproto.sml (invoked from FLINT/trans/translate.sml), a new
1874    case in the FLINT CPS datatype (RCC), changes to cps/convert.sml to
1875    translate uses of RAW_CCALL into RCC, and changes to mlriscGen.sml to
1876    handle RCC.
1877    
1878    The last part (the changes to mlriscGen.sml) are still known to be
1879    wrong on the x86 and not implemented on all other architectures.  But
1880    the infrastructure is in place. I had to change a few functor
1881    signatures in the backend to be able to route the CCalls interface
1882    from MLRISC there, and I had to specialize the mltree type (on the
1883    x86) to include the necessary extensions. (The extensions themselves
1884    were already there and redy to go in MLRISC/x86).
1885    
1886    Everything should be very happy as soon as someone helps me with
1887    mlriscGen.sml...
1888    
1889    In any case, nothing of this should matter to anyone as long as the
1890    new primop is not being used (which is going to be the case unless you
1891    find it where I hid it :). The rest of the compiler is completely
1892    unaffected.
1893    
1894    ----------------------------------------------------------------------
1895    Name: Matthias Blume
1896    Date: 2001/01/05 00:30:00 JST
1897    Tag: blume-20010105-primops
1898    Description:
1899    
1900    Added some experimental support for work that I am doing right now.
1901    These changes mostly concern added primops, but there is also a new
1902    experimental C library in the runtime system (but currently not enabled
1903    anywhere except on Linux/X86).
1904    
1905    In the course of adding primops (and playing with them), I discovered that
1906    Zhong's INL_PRIM hack (no type info for certain primops) was, in fact, badly
1907    broken.  (Zhong was very right he labeled this stuff as "major gross hack".)
1908    To recover, I made type information in INL_PRIM mandatory and changed
1909    prim.sml as well as built-in.sml accordingly.  The InLine structure now
1910    has complete, correct type information (i.e., no bottom types).
1911    
1912    Since all these changes mean that we need new binfiles, I also bumped the
1913    version number to 110.32.1.
1914    
1915    ----------------------------------------------------------------------
1916    Name: Matthias Blume
1917    Date: 2000/12/30 22:10:00 JST
1918    Tag: blume-20001230-various
1919    Description:
1920    
1921    Added proxy libraries for MLRISC and let MLRISC libraries refer
1922    to each other using path anchors.  (See CM manual for explanation.)
1923    
1924    Updated CM documentation.
1925    
1926    Fixed some bugs in CM.
1927    
1928    Implemented "proxy" libraries (= syntactic sugar for CM).
1929    
1930    Added "-quiet" option to makeml and changed runtime system accordingly.
1931    
1932    Added cleanup handler for exportML to reset timers and compiler stats.
1933    
1934    ----------------------------------------------------------------------
1935    Name: Lal George
1936    Date: 2000/12/22 22:22:58 EST 2000
1937    Tag: Release_110_32
1938    Description:
1939    
1940            Infinite precision used throughout MLRISC.
1941            see MLRISC/mltree/machine-int.sig
1942    
1943    ----------------------------------------------------------------------
1944    Name: Matthias Blume
1945    Date: 2000/12/22 23:16:00 JST
1946    Tag: blume-20001222-warn
1947    Description:
1948    
1949    Corrected wording and formatting of some CM warning message which I
1950    broke in my previous patch.
1951    
1952    ----------------------------------------------------------------------
1953    Name: Matthias Blume
1954    Date: 2000/12/22 21:20:00 JST
1955    Tag: blume-20001222-anchorenv
1956    Description:
1957    
1958    Fixed CM's handling of anchor environments in connection with CMB.make.
1959    
1960    ----------------------------------------------------------------------
1961    Name: Matthias Blume
1962    Date: 2000/12/22 13:15:00 JST
1963    Tag: blume-20001222-cleanup
1964    Description:
1965    
1966    Removed src/cm/ffi which does not (and did not) belong here.
1967    
1968    ----------------------------------------------------------------------
1969    Name: Matthias Blume
1970    Date: 2000/12/21 23:55:00 JST
1971    Tag: blume-20001221-exn
1972    Description:
1973    
1974    Probably most important: CM no longer silently swallows all exceptions
1975    in the compiler.
1976    Plus: some other minor CM changes.  For example, CM now reports some
1977    sizes for generated binfiles (code, data, envpickle, lambdapickle).
1978    
1979    ----------------------------------------------------------------------
1980    Name: Matthias Blume
1981    Date: 2000/12/15 00:01:05 JST
1982    Tag: blume-20001215-dirtool
1983    Description:
1984    
1985    - "dir" tool added.
1986    - improvements and cleanup to Tools structure
1987    - documentation updates
1988    
1989    ----------------------------------------------------------------------
1990    Name: Allen Leung
1991    Date: Thu Dec 14 03:45:24 EST 2000
1992    Description:
1993    Tag:  leunga-20001214-int-inf
1994    Description:
1995    
1996       In IntInf, added these standard functions, which are missing from our
1997    implementation:
1998    
1999        andb : int * int -> int
2000        xorb : int * int -> int
2001        orb  : int * int -> int
2002        notb : int -> int
2003         <<   : int * word -> int
2004        ~>>  : int * word -> int
2005    
2006       Not tested, I hope they are correct.
2007    
2008    ----------------------------------------------------------------------
2009    Name: Allen Leung
2010    Date: Fri Dec  8 19:23:26 EST 2000
2011    Description:
2012    Tag:  leunga-20001208-nowhere
2013    Description:
2014    
2015      Slight improvements to the 'nowhere' tool to handle OR-patterns,
2016    to generate better error messages etc.  Plus a brief manual.
2017    
2018    ----------------------------------------------------------------------
2019    Name: Lal George
2020    Date: 2000/12/08 09:54:02 EST 2000
2021    Tag: Release_110_31
2022    Description:
2023    
2024    - Version 110.31
2025    ----------------------------------------------------------------------
2026    Name: Allen Leung
2027    Date: Thu Dec  7 22:01:04 EST 2000
2028    Tag:  leunga-20001207-cell-monster-hack
2029    Description:
2030    
2031    Major MLRISC internal changes.  Affect all clients.
2032    Summary:
2033    
2034    1.  Type CELLS.cell = int is now replaced by a datatype.
2035        As a result, the old regmap is now gone.  Almost all interfaces
2036        in MLRISC change as a consequence.
2037    
2038    2.  A new brand version of machine description tool (v3.0) that generates
2039        modules expecting the new interface.  The old version is removed.
2040    
2041    3.  The RA interface has been further abstracted into two new functors.
2042        RISC_RA and X86RA.  These functors have much simpler interfaces.
2043        [See also directory MLRISC/demo.]
2044    
2045    4.  Some other new source->source code generation tools are available:
2046    
2047        a. MLRISC/Tools/RewriteGen -- generate rewriters from rules.
2048        b. MLRISC/Tools/WhereGen -- expands conditional pattern matching rules.
2049           I use this tool to generate the peephole optimizers---with the new
2050           cell type changes, peephole rules are becoming difficult to write
2051           without conditional pattern matching.
2052    
2053    5.  More Intmap -> IntHashTable change.  Previous changes by Matthias didn't
2054        cover the entire MLRISC source tree so many things broke.
2055    
2056    6.  CM files have been moved to the subdirectory MLRISC/cm.
2057        They are moved because there are a lot of them and they clutter up the
2058        root dir.
2059    
2060    7.  More detailed documentation to come...
2061    
2062        NOTE: To rebuild from 110.30 (ftp distribution), you'll have to do
2063        a makeml -rebuild first.  This is because of other other
2064        changes that Matthias has made (see below).
2065    
2066    
2067    ----------------------------------------------------------------------
2068    Name: Matthias Blume
2069    Date: 2000/11/30 23:12:00 JST
2070    Tag: blume-20001130-filereorg
2071    Description:
2072    
2073    Some manual updates and some file reorganizations in CM.
2074    
2075    ----------------------------------------------------------------------
2076    Name: Matthias Blume
2077    Date: 2000/11/24 17:45:00 JST
2078    Tag: blume-20001124-link
2079    Description:
2080    
2081    Drastically improved link traversal code for the case that the dynamic
2082    value was already loaded at bootstrap time.  As a result, CM and CMB
2083    now both load blazingly fast -- even on a very slow machine.  Also,
2084    memory consumption has been further reduced by this.
2085    
2086    Warning: The format of the PIDMAP file has changed.  THerefore, to
2087    bootstrap you have to do this:
2088    
2089    1. Run CMB.make
2090    2. Make a symbolic link for the boot directory:
2091         ln -s sml.boot.ARCH-OS xxx
2092    3. "Rebuild" the boot directory:
2093         ./makeml -boot xxx -rebuild sml ; rm xxx
2094    4. Boot normally:
2095          ./makeml
2096    
2097    ----------------------------------------------------------------------
2098    Name: Matthias Blume
2099    Date: 2000/11/21 21:20:00 JST
2100    Tag: blume-20001121-tools
2101    Description:
2102    
2103    Continued hacking on autoloading problem -- with success this time.
2104    Also changed tool-plugin mechanism.  See new CM manual.
2105    
2106    ----------------------------------------------------------------------
2107    Name: Matthias Blume
2108    Date: 2000/11/19 14:30:00 JST
2109    Tag:  blume-20001119-autoload
2110    Description:
2111    
2112    Some hacking to make autoloading faster.  Success for CMB, no success
2113    so far for CM.  There is a reduced structure CM' that autoloads faster.
2114    (This is a temporary, non-documented hack to be eliminated again when
2115    the general problem is solved.)
2116    
2117    ----------------------------------------------------------------------
2118    Name: Matthias Blume
2119    Date: 2000/11/17 14:10:00 JST
2120    Tag: blume-20001117-pickle-lib
2121    Description:
2122    
2123    1. Eliminated comp-lib.cm
2124    2. Made pickle-lib.cm
2125    3. Eliminated all uses of intset.sml (from comp-lib.cm)
2126    4. Replaced all uses of intmap.{sig,sml} (from comp-lib.cm) with
2127       equivalent constructs from smlnj-lib.cm (INtHashTable).
2128    5. Point 4. also goes for those uses of intmap.* in MLRISC.
2129       Duplicated intmap modules thrown out.
2130    6. Hunted down all duplicated SCC code and replaced it with
2131       equivalent stuff (GraphSCCFn from smlnj-lib.cm).
2132    7. Rewrote Feedback module.
2133    8. Moved sortedlist.sml into viscomp-lib.cm.  Eventually it
2134       should be thrown out and equivalent modules from smlnj-lib.cm
2135       should be used (IntRedBlackSet, IntListSet, ...).
2136    
2137    Confirmed that compiler compiles to fixpoint.
2138    
2139    ----------------------------------------------------------------------
2140    Name: Allen Leung
2141    Date: 2000/11/10 18:00:00
2142    Tag: leunga-20001110-new-x86-fp
2143    
2144    A new x86 floating point code generator has been added.
2145    By default this is turned off.  To turn this on, do:
2146    
2147        CM.autoload "$smlnj/compiler.cm";
2148        Compiler.Control.MLRISC.getFlag "x86-fast-fp" := true;
2149    
2150    Changes:
2151    
2152    1.  Changed FTAN to FPTAN so that the assembly output is correct.
2153    2.  Changed the extension callback for FTANGENT to generate:
2154    
2155              fptan
2156              fstp  %st(0)
2157        instead of
2158              fptan
2159              fstpl ftempmem
2160    
2161    3.  Numerous assembly fixes for x86.
2162    
2163    5.  Cleaned up the machine code output module x86/x86MC.sml and added
2164        support for a whole bunch of instructions and addressing modes:
2165    
2166          fadd/fsub/fsubr/fmul/fdiv/fdivr  %st, %st(n)
2167          faddp/fsubp/fsubrp/fmulp/fdivp/fdivrp  %st, %st(n)
2168          fadd/fsub/fsubr/fmul/fdiv/fdivr  %st(n), %st
2169          fiadd/fisub/fisubr/fimul/fidiv/fidivr mem
2170          fxch %st(n)
2171          fld %st(n)
2172          fst %st(n)
2173          fst mem
2174          fstp %st(n)
2175          fucom %st(n)
2176          fucomp %st(n)
2177    
2178        All these are now generated when the fast fp mode is turned on.
2179    
2180    6.  Removed the dedicated registers %st(0), ..., %st(7) from X86CpsRegs
2181    
2182    ----------------------------------------------------------------------
2183    Name: Matthias Blume
2184    Date: 2000/11/09 11:20:00 JST
2185    Tag: blume-20001109-scc
2186    Description:
2187    
2188    Eliminated some code duplication:
2189    
2190    1. Added "where" clause to GraphSCCFn in SML/NJ Library.
2191       (Otherwise the functor is useless.)
2192    2. Used GraphSCCFn where SCCUtilFun was used previously.
2193    3. Got rid of SCCUtilFun (in comp-lib.cm).
2194    
2195    ----------------------------------------------------------------------
2196    Name: Lal George
2197    Date: 2000/11/06 09:02:21 EST 2000
2198    Tag: Release_110_30
2199    Description:
2200    
2201    - Version 110.30
2202    ----------------------------------------------------------------------
2203    Name: Matthias Blume
2204    Date: 2000/11/04 14:45:00
2205    Tag: blume-20001104-mlbuild
2206    Description:
2207    
2208    - Made ml-build faster on startup.
2209    - Documentation fixes.
2210    
2211    ----------------------------------------------------------------------
2212    Name: Matthias Blume
2213    Date: 2000/11/02 17:00:00 JST
2214    Tag: blume-20001102-condcomp
2215    Description:
2216    
2217    - Small tweaks to pickler -- new BOOTFILES!
2218    - Version bumped to 110.29.2.
2219    - Added conditional compilation facility to init.cmi (see comment there).
2220    ----------------------------------------------------------------------
2221    Name: Allen Leung
2222    Date: 2000/10/23 19:31:00
2223    Tag: leunga-20001023-demo-ra
2224    
2225    1. Minor RA changes that improves spilling on x86 (affects Moby and C-- only)
2226    2. Test programs for the graph library updated
2227    3. Some new MLRISC demo programs added
2228    
2229    ----------------------------------------------------------------------
2230    Name: Matthias Blume
2231    Date: 2000/08/31 22:15:00 JST
2232    Tag: blume-20001017-errmsg
2233    Description:
2234    
2235    More error message grief: Where there used to be no messages, there
2236    now were some that had bogus error regions.  Fixed.
2237    
2238    ----------------------------------------------------------------------
2239    Name: Matthias Blume
2240    Date: 2000/08/31 17:30:00 JST
2241    Tag: blume-20001017-v110p29p1
2242    Description:
2243    
2244    I made a version 110.29.1 with new bootfiles.
2245    
2246    Changes:  Modified pickler/unpickler for faster and leaner unpickling.
2247              CM documentation changes and a small bugfix in CM's error reporting.
2248    
2249    ----------------------------------------------------------------------
2250    Name: Lal George
2251    Date: 2000/09/27 14:42:35 EDT
2252    Tag: george-20000927-nodestatus
2253    Description:
2254    
2255    Changed the type of the nodestatus, so that:
2256    
2257            SPILLED(~1)             is now SPILLED
2258            SPILLED(m) where m>=0   is now MEMREG(m)
2259            SPILLED(s) where s<~1   is now SPILL_LOC(~s)
2260    
2261    ----------------------------------------------------------------------
2262    Name: Matthias Blume
2263    Date: 2000/09/07 14:45:00 JST
2264    Tag: blume-20000907-cmerrmsg
2265    Description:
2266    
2267    Small tweak to CM to avoid getting ML syntax error messages twice.
2268    
2269    ----------------------------------------------------------------------
2270    Name: Matthias Blume
2271    Date: 2000/08/31 18:00:00 JST
2272    Tag: blume-20000831-cvsbootfiles
2273    Description:
2274    
2275    New URL for boot files (because the 110.29 files on the BL server do
2276    now work correctly with my updated install scripts for yacc and lex).
2277    
2278    ----------------------------------------------------------------------
2279    Name: Matthias Blume
2280    Date: 2000/08/08 12:33:00 JST
2281    Tag: blume-20000808-manual
2282    Description:
2283    
2284    Tiny update to CM manual.
2285    
2286    ----------------------------------------------------------------------
2287    Name: Allen Leung
2288    Date: 2000/08/7 19:31:00
2289    Tag: leunga-20000807-a-whole-bunch-of-stuff
2290    
2291      Moby, C--, SSA, x86, machine descriptions etc.  Should only affect C--
2292    and Mobdy.
2293    
2294    1.  x86
2295    
2296       a.  Fixes to peephole module by John and Dan.
2297       b.  Assembly fix to SETcc by Allen.
2298       c.  Fix to c-call by John.
2299       d.  Fix to spilling by John.  (This one deals with the missing FSTPT case)
2300       e.  Instruction selection optimization to SETcc as suggested by John.
2301    
2302           For example,
2303    
2304            MV(32, x, COND(32, CMP(32, LT, a, b), LI 1, LI 0))
2305    
2306           should generate:
2307    
2308            MOVL a, x
2309            SUBL b, x
2310            SHRL 31, x
2311    
2312    2.  IR stuff
2313    
2314         A bunch of new DJ-graph related algorithms added.  These
2315         speed up SSA construction.
2316    
2317    3.  SSA + Scheduling
2318    
2319         Added code for SSA and scheduling to the repository
2320    
2321    ----------------------------------------------------------------------
2322    Name: Lal George
2323    Date: 2000/07/27 11:53:14 EDT
2324    
2325    Tag: lal-20000727-linux-ppc
2326    Description:
2327    
2328     Made changes to support Linux PPC.
2329     p.s. I have confirmation that the 110.29 boot files work fine.
2330    
2331    ----------------------------------------------------------------------
2332    Name: Matthias Blume
2333    Date: 2000/07/27 17:40:00 JST
2334    Tag: blume-20000727-scripts
2335    Description:
2336    
2337    !!!! WARNING !!!!
2338    You must recompile the runtime system!
2339    !!!! WARNING !!!!
2340    
2341    This is basically another round of script-enhancements:
2342    
2343    1. sml, ml-build, and ml-makedepend accept options -D and -U to define
2344       and undefine CM preprocessor symbols.
2345    
2346    2. ml-build avoids generating a new heap image if it finds that the
2347       existing one is still ok.  (The condition is that no ML file had to
2348       be recompiled and all ML files are found to be older that the heap
2349       file.)
2350    
2351       To make this work smoothly, I also hacked the runtime system as
2352       well as SMLofNJ.SysInfo to get access to the heap image suffix
2353       (.sparc-solaris, ...) that is currently being used.
2354    
2355       Moreover, the signature of CM.mk_standalone has changed.  See the
2356       CM manual.
2357    
2358    3. ml-makedepend accepts additional options -n, -a, and -o.  (See the
2359       CM manual for details.)
2360    
2361    4. More CM manual updates:
2362        - all of the above has been documented.
2363        - there is now a section describing the (CM-related) command line
2364          arguments that are accepted by the "sml" command
2365    
2366    ----------------------------------------------------------------------
2367    Name: Matthias Blume
2368    Date: 2000/07/25 16:20:00 JST
2369    Tag: blume-20000725-makedepend
2370    Description:
2371    
2372    Added a script called ml-makedepend.  This can be used in makefiles
2373    for Unix' make in a way very similar to the "makedepend" command for
2374    C.
2375    
2376    The script internally uses function CM.sources.
2377    
2378    Synopsis:
2379    
2380        ml-makedepend [-f makefile] cmfile targetname
2381    
2382    The default for the makefile is "makefile" (or "Makefile" should
2383    "makefile" not exist).
2384    
2385    ml-makedepend adds a cmfile/targetname-specific section to this
2386    makefile (after removing the previous version of this section).  The
2387    section contains a single dependency specification with targetname on
2388    the LHS (targetname is an arbitrary name), and a list of files derived
2389    from the cmfile on the RHS.  Some of the files on the RHS are
2390    ARCH/OPSYS-specific.  Therefore, ml-makedepend inserts references to
2391    "make" variables $(ARCH) and $(OPSYS) in place of the corresponding
2392    path names.  The makefile writer is responsible for making sure that
2393    these variables have correct at the time "make" is invoked.
2394    
2395    ----------------------------------------------------------------------
2396    Name: Matthias Blume
2397    Date: 2000/07/22 23:30:00 JST
2398    Tag: blume-20000722-urlupdate
2399    Description:
2400    
2401    Changed BOOT and config/srcarchiveurl to point to BL server:
2402    
2403        ftp://ftp.research.bell-labs.com/dist/smlnj/working/110.29/
2404    
2405    ----------------------------------------------------------------------
2406    Name: Matthias Blume
2407    Date: 2000/07/18 18:00:00 JST
2408    Tag: blume-20000718-Version_110_29
2409    Description:
2410    
2411    1. Updated src/compiler/TopLevel/main/version.sml to version 110.29
2412    
2413    2. Updated config/version to 110.29
2414    
2415    3. Updated config/srcarchiveurl
2416    
2417    3. New boot files!
2418       ftp://ftp.cs.princeton.edu/pub/people/blume/sml/110.29-autofetch
2419    
2420    ----------------------------------------------------------------------
2421    Name: Matthias Blume
2422    Date: 2000/07/11 13:58:00 JST
2423    Tag: blume-20000711-doctypo
2424    Description:
2425    
2426    Fixed a few typos in CM manual.
2427    
2428    ----------------------------------------------------------------------
2429    Name: Allen Leung
2430    Date: 2000/06/15 00:38:00
2431    Tag: leunga-20000704-sparc-x86
2432    
2433    1. x86 peephole improvement sp += k; sp -= k => nop  [from John]
2434    2. fix to x86 RET bug [found by Dan Grossman]
2435    3. sparc assembly bug fix for ticc instructions [found by Fermin]
2436    
2437       Affects c-- and moby only
2438    
2439    ----------------------------------------------------------------------
2440    Name: Matthias Blume
2441    Date: 2000/07/04 15:26:00
2442    Tag: blume-20000704-trigger
2443    Description:
2444    
2445    1. Improvements to CM manual.
2446    2. SMLofNJ.Internals.BTrace.trigger reinstated as an alternative way
2447       of getting a back-trace.  The function, when called, raises an
2448       internal exception which explicitly carries the full back-trace history,
2449       so it is unaffected by any intervening handle-raise pairs ("trivial"
2450       or not).  The interactive loop will print that history once it arrives
2451       at top level.
2452       Short of having all exceptions implicitly carry the full history, the
2453       recommended way of using this facility is:
2454         - compile your program with instrumentation "on"
2455         - run it, when it raises an exception, look at the history
2456         - if the history is "cut off" because of some handler, go and modify
2457           your program so that it explicitly calls BTrace.trigger
2458         - recompile (still instrumented), and rerun; look at the full history
2459    
2460    ----------------------------------------------------------------------
2461    Name: Matthias Blume
2462    Date: 2000/07/03 15:36:00 JST
2463    Tag: blume-20000702-manual
2464    Description:
2465    
2466    Small corrections and updates to CM manual.
2467    
2468    ----------------------------------------------------------------------
2469    Name: Matthias Blume
2470    Date: 2000/06/29 16:04:00 JST
2471    Tag: blume-20000629-yacctool
2472    Description:
2473    
2474    Changes:
2475    
2476    1. Class "mlyacc" now takes separate arguments to pass options to
2477       generated .sml- and .sig-files independently.
2478    2. Corresponding CM manual updates.
2479    3. BTrace module now also reports call sites.  (However, for loop clusters
2480       it only shows from where the cluster was entered.)  There are associated
2481       modifications to core.sml, internals.{sig,sml}, btrace.sml, and btimp.sml.
2482    
2483    ----------------------------------------------------------------------
2484    Name: Matthias Blume
2485    Date: 2000/06/27 16:51:00 JST
2486    Tag: blume-20000627-noweb
2487    Description:
2488    
2489    Changes:
2490    
2491     1. Implemented "subdir" and "witness" options for noweb tool.
2492        This caused some slight internal changes in CM's tool implementation.
2493     2. Fixed bug in "tool plugin" mechanism.  This is essentially cleaning
2494        some remaining issues from earlier path anchor changes.
2495     3. Updated CM manual accordingly.
2496    
2497     4. Changed implementation of back-tracing so that I now consider it
2498        ready for prime-time.
2499    
2500        In particular, you don't have to explicitly trigger the back-trace
2501        anymore.  Instead, if you are running BTrace-instrumented code and
2502        there is an uncaught exception (regardless of whether or not it was
2503        raised in instrumented code), the top-level evalloop will print
2504        the back-trace.
2505    
2506        Features:
2507    
2508          - Instrumented and uninstrumented code work together seemlessly.
2509            (Of course, uninstrumented code is never mentioned in actual
2510             back-traces.)
2511    
2512          - Asymptotic time- and space-complexity of instrumented code is
2513            equal to that of uninstrumented code.  (This means that
2514            tail-recursion is preserved by the instrumentation phase.)
2515    
2516          - Modules whose code has been instrumented in different sessions
2517            work together without problem.
2518    
2519          - There is no penalty whatsoever on uninstrumented code.
2520    
2521          - There is no penalty on "raise" expressions, even in
2522            instrumented code.
2523    
2524        A potential bug (or perhaps it is a feature, too):
2525    
2526          A back-trace reaches no further than the outermost instrumented
2527          non-trivial "raise".  Here, a "trivial" raise is one that is the
2528          sole RHS of a "handle" rule.  Thus, back-traces reach trough
2529    
2530               <exp> handle e => raise e
2531    
2532          and even
2533    
2534               <exp> handle Foo => raise Bar
2535    
2536          and, of course, through
2537    
2538               <exp> handle Foo => ...
2539    
2540         if the exception was not Foo.
2541    
2542         Back-traces always reach right through any un-instrumented code
2543         including any of its "handle" expressions, trivial or not.
2544    
2545       To try this out, do the following:
2546    
2547         - Erase all existing binfiles for your program.
2548           (You may keep binfiles for those modules where you think you
2549            definitely don't need back-tracing.)
2550         - Turn on back-trace instrumentation:
2551              SMLofNJ.Internals.BTrace.mode (SOME true);
2552         - Recompile your program.  (I.e., run "CM.make" or "use".)
2553         - You may now turn instrumentation off again (if you want):
2554              SMLofNJ.Internals.BTrace.mode (SOME false);
2555         - Run your program as usual.  If it raises an exception that
2556           reaches the interactive toplevel, then a back-trace will
2557           automatically be printed.  After that, the toplevel loop
2558           will print the exception history as usual.
2559    
2560    ----------------------------------------------------------------------
2561    Name: Matthias Blume
2562    Date: 2000/06/26 09:56:46 JST
2563    Tag: blume-20000626-setup
2564    Description:
2565    
2566    CM: - setup-parameter to "sml" added; this can be used to run arbitrary
2567          ML code before and after compiling a file (e.g., to set compiler
2568          flags)
2569    
2570    Compiler: - improved btrace API (in core.sml, internals.{sig,sml})
2571              - associated changes to btrace.sml (BTrace instrumentation pass)
2572              - cleaner implementation of btimp.sml (BTrace tracing and report
2573                module)
2574    
2575    CM manual: * new path encoding documented
2576               * description of setup-parameter to "sml" added
2577    
2578    The biggest user-visible change to back-tracing is that it is no
2579    longer necessary to compile all traced modules within the same
2580    session.  (This was a real limitation.)
2581    
2582    ----------------------------------------------------------------------
2583    Name: Matthias Blume
2584    Date: 2000/06/24 12:40:00 JST
2585    Tag: blume-20000624-startup
2586    Description:
2587    
2588    Fixes startup slowdown problem.  (I was calling SrcPath.sync a _tad_
2589    bit too often -- to put it mildly. :)
2590    
2591    ----------------------------------------------------------------------
2592    Name: Matthias Blume
2593    Date: 2000/06/23 18:20:00 JST
2594    Tag: blume-20000623-btrace
2595    Description:
2596    
2597    This updates adds a backtrace facility to aid programmers in debugging
2598    their programs.  This involves the following changes:
2599    
2600    1. Module system/smlnj/init/core.sml (structure _Core) now has hooks for
2601       keeping track of the current call stack.  When programs are compiled
2602       in a special mode, the compiler will insert calls to these hooks
2603       into the user program.
2604       "Hook" means that it is possible for different implementations of
2605       back-tracing to register themselves (at different times).
2606    
2607    2. compiler/MiscUtil/profile/btrace.sml implements the annotation phase
2608       as an Absyn.dec->Absyn.dec rewrite.  Normally this phase is turned off.
2609       It can be turned on using this call:
2610         SMLofNJ.Internals.BTrace.mode (SOME true);
2611       Turning it off again:
2612         SMLofNJ.Internals.BTrace.mode (SOME false);
2613       Querying the current status:
2614         SMLofNJ.Internals.BTrace.mode NONE;
2615       Annotated programs are about twice as big as normal ones, and they
2616       run a factor of 2 to 4 slower with a dummy back-trace plugin (one
2617       where all hooks do nothing).  The slowdown with a plugin that is
2618       actually useful (such as the one supplied by default) is even greater,
2619       but in the case of the default plugin it is still only an constant
2620       factor (amortized).
2621    
2622    3. system/Basis/Implementation/NJ/internals.{sig,sml} have been augmented
2623       with a sub-structure BTrace for controlling back-tracing.  In particular,
2624       the above-mentioned function "mode" controls whether the annotation
2625       phase is invoked by the compiler.  Another important function is
2626       "trigger": when called it aborts the current execution and causes
2627       the top-level loop to print a full back-trace.
2628    
2629    4. compiler/MiscUtil/profile/btimp.sml is the current default plugin
2630       for back-tracing.  It keeps track of the dynamic call stack and in
2631       addition to that it keeps a partial history at each "level" of that
2632       stack.  For example, if a tail-calls b, b tail-calls c, and c tail-calls
2633       d and b (at separate times, dynamically), then the report will show:
2634    
2635       GOTO   d
2636             /c
2637       GOTO  \b
2638       CALL   a
2639    
2640       This shows that there was an initial non-tail call of a, then a
2641       tail-call to b or c, looping behavior in a cluster of functions that
2642       consist of b and c, and then a goto from that cluster (i.e., either from
2643       b or from c) to d.
2644    
2645       Note that (depending on the user program) the amount of information
2646       that the back-trace module has to keep track of at each level is bounded
2647       by a constant.  Thus, the whole implementation has the same asymptotical
2648       complexity as the original program (both in space and in time).
2649    
2650    5. compiler/TopLevel/interact/evalloop.sml has been modified to
2651       handle the special exception SMLofNJ.Internals.BTrace.BTrace
2652       which is raised by the "trigger" function mentioned above.
2653    
2654    Notes on usage:
2655    
2656    - Annotated code works well together with unannotated code:
2657    Unannotated calls simply do not show up at all in the backtrace.
2658    
2659    - It is not a good idea to let modules that were annotated during
2660    different sessions run at the same time.  This is because the compiler
2661    chooses small integers to identify individual functions, and there
2662    will be clashes if different modules were compiled in separate sessions.
2663    (Nothing will crash, and you will even be told about the clashes, but
2664    back-trace information will in general not be useful.)
2665    
2666    - Back-tracing can be confused by callcc and capture.
2667    
2668    - The only way of getting a back-trace right now is to explicitly
2669    invoke the "trigger" function from your user program.  Eventually, we
2670    should make every exception carry back-trace information (if
2671    available).  But since this creates more overhead at "raise"-time
2672    (similar to the current exnHistory overhead), I have not yet
2673    implemented this.  (The implementation will be rather easy.)  With
2674    exceptions carrying back-trace information, this facility will be even
2675    more useful because users don't need to modify their programs...
2676    
2677    - While it is possible to compile the compiler with back-trace
2678    annotations turned on (I did it to get some confidence in
2679    correctness), you must make absolutely sure that core.sml and
2680    btimp.sml are compiled WITHOUT annotation!  (core.sml cannot actually
2681    be compiled with annotation because there is no core access yet, but
2682    if you compile btimp.sml with annotation, then the system will go into
2683    an infinite recursion and crash.)
2684    Since CM currently does not know about BTrace, the only way to turn
2685    annotations on and off for different modules of the compiler is to
2686    interrupt CMB.make, change the settings, and re-invoke it.  Of course,
2687    this is awkward and clumsy.
2688    
2689    Sample sessions:
2690    
2691    Standard ML of New Jersey v110.28.1 [FLINT v1.5], June 5, 2000
2692    - SMLofNJ.Internals.BTrace.mode (SOME true);
2693    [autoloading]
2694    [autoloading done]
2695    val it = false : bool
2696    - structure X = struct
2697    -     fun main n = let
2698    -         fun a (x, 0) = d x
2699    -           | a (x, n) = b (x, n - 1)
2700    -         and b (x, n) = c (x, n)
2701    -         and c (x, n) = a (x, n)
2702    -         and d x = e (x, 3)
2703    -         and e (x, 0) = f x
2704    -           | e (x, n) = e (x, n - 1)
2705    -         and f 0 = SMLofNJ.Internals.BTrace.trigger ()
2706    -           | f n = n * g (n - 1)
2707    -         and g n = a (n, 3)
2708    -     in
2709    -         f n
2710    -     end
2711    - end;
2712    structure X : sig val main : int -> int end
2713    - X.main 3;
2714    *** BACK-TRACE ***
2715    GOTO   stdIn:4.2-13.20: X.main[2].f
2716    GOTO-( stdIn:4.2-13.20: X.main[2].e
2717    GOTO   stdIn:4.2-13.20: X.main[2].d
2718         / stdIn:4.2-13.20: X.main[2].a
2719         | stdIn:4.2-13.20: X.main[2].b
2720    GOTO-\ stdIn:4.2-13.20: X.main[2].c
2721    CALL   stdIn:4.2-13.20: X.main[2].g
2722    GOTO   stdIn:4.2-13.20: X.main[2].f
2723    GOTO-( stdIn:4.2-13.20: X.main[2].e
2724    GOTO   stdIn:4.2-13.20: X.main[2].d
2725         / stdIn:4.2-13.20: X.main[2].a
2726         | stdIn:4.2-13.20: X.main[2].b
2727    GOTO-\ stdIn:4.2-13.20: X.main[2].c
2728    CALL   stdIn:4.2-13.20: X.main[2].g
2729    GOTO   stdIn:4.2-13.20: X.main[2].f
2730    GOTO-( stdIn:4.2-13.20: X.main[2].e
2731    GOTO   stdIn:4.2-13.20: X.main[2].d
2732         / stdIn:4.2-13.20: X.main[2].a
2733         | stdIn:4.2-13.20: X.main[2].b
2734    GOTO-\ stdIn:4.2-13.20: X.main[2].c
2735    CALL   stdIn:4.2-13.20: X.main[2].g
2736    GOTO   stdIn:4.2-13.20: X.main[2].f
2737    CALL   stdIn:2.15-17.4: X.main[2]
2738    -
2739    
2740    (Note that because of a FLINt bug the above code currently does not
2741    compile without BTrace turned on.)
2742    
2743    Here is another example, using my modified Tiger compiler:
2744    
2745    Standard ML of New Jersey v110.28.1 [FLINT v1.5], June 5, 2000
2746    - SMLofNJ.Internals.BTrace.mode (SOME true);
2747    [autoloading]
2748    [autoloading done]
2749    val it = false : bool
2750    - CM.make "sources.cm";
2751    [autoloading]
2752    ...
2753    [autoloading done]
2754    [scanning sources.cm]
2755    [parsing (sources.cm):parse.sml]
2756    [creating directory CM/SKEL ...]
2757    [parsing (sources.cm):tiger.lex.sml]
2758    ...
2759    [wrote CM/sparc-unix/semant.sml]
2760    [compiling (sources.cm):main.sml]
2761    [wrote CM/sparc-unix/main.sml]
2762    [New bindings added.]
2763    val it = true : bool
2764    - Main.compile ("../testcases/merge.tig", "foo.out");
2765    *** BACK-TRACE ***
2766    CALL   lib/semant.sml:99.2-396.21: SemantFun[2].transExp.trvar
2767    CALL   lib/semant.sml:99.2-396.21: SemantFun[2].transExp.trexp
2768    CALL   lib/semant.sml:289.3-295.22: SemantFun[2].transExp.trexp.check[2]
2769    GOTO   lib/semant.sml:289.3-295.22: SemantFun[2].transExp.trexp.check[2]
2770    CALL   lib/semant.sml:99.2-396.21: SemantFun[2].transExp.trexp
2771    CALL   lib/semant.sml:99.2-396.21: SemantFun[2].transExp.trexp
2772    CALL   lib/semant.sml:488.3-505.6: SemantFun[2].transDec.trdec[2].transBody[2]
2773         / lib/semant.sml:411.65-543.8: SemantFun[2].transDec
2774    CALL-\ lib/semant.sml:413.2-540.9: SemantFun[2].transDec.trdec[2]
2775    CALL   lib/semant.sml:99.2-396.21: SemantFun[2].transExp.trexp
2776    CALL   lib/semant.sml:8.52-558.4: SemantFun[2].transProg[2]
2777    CALL   main.sml:1.18-118.4: Main.compile[2]
2778    -
2779    
2780    ----------------------------------------------------------------------
2781    Name: Matthias Blumen
2782    Date: 2000/06/21 18:00:00 JST
2783    Tag: blume-20000621-manual
2784    Description:
2785    
2786    CM manual update: Path environments documented.
2787    
2788    ----------------------------------------------------------------------
2789    Name: Matthias Blume
2790    Date: 2000/06/19 13:40:00
2791    Tag: blume-20000619-manual
2792    Description:
2793    
2794    CM manual and system/README update.  This only covers the fact that
2795    there are no more implicit anchors.  (Path environments and the "bind"
2796    option to "cm" have yet to be documented.)
2797    
2798    ----------------------------------------------------------------------
2799    Name: Matthias Blume
2800    Date: 2000/06/19 11:05:00 JST
2801    Tag: blume-20000619-chdir-bugfix
2802    Description:
2803    
2804    Fixed a bug in new SrcPath module that sometimes led to a bad chDir call.
2805    
2806    ----------------------------------------------------------------------
2807    Name: Matthias Blume
2808    Date: 2000/06/18 22:00:10 JST
2809    Tag: blume-20000618-implicit-anchors-really-gone
2810    Description:
2811    
2812    I updates the previous HISTORY entry where I forgot to mention that
2813    implicit anchors are no longer with us.
2814    
2815    The current update also gets rid of the (now useless) controller
2816    CM.Control.implicit_anchors.
2817    
2818    ----------------------------------------------------------------------
2819    Name: Matthias Blume
2820    Date: 2000/06/16 17:30:00 JST
2821    Tag: blume-20000616-anchorenv
2822    Description:
2823    
2824    This patch implements the long anticipated (just kidding :) "anchor
2825    environment" mechanism.  In the course of doing this, I also
2826    re-implemented CM's internal "SrcPath" module from scratch.  The new
2827    one should be more robust in certain boundary cases.  In any case, it
2828    is a lot cleaner than its predecessor (IMHO).
2829    
2830    This time, although there is yet another boot file format change, I
2831    kept the unpickler backward-compatible.  As a result, no new bootfiles
2832    are necessary and bootstrapping is straightforward.  (You cannot read
2833    new bootfiles into an old system, but the other way around is no
2834    problem.)
2835    
2836    Visible changes:
2837    
2838    ** 0. Implicit path anchors (without the leading $-symbol) are no
2839    longer recognized at all. This means that such path names are not
2840    illegal either.  For example, the name basis.cm simply refers to a
2841    local file called "basis.cm" (i.e, the name is an ordinary path
2842    relative to .cm-files directory).  Or, to put it differently, only
2843    names that start with $ are anchored paths.
2844    
2845    ** 1. The $<singlearc> abbreviation for $/<singlearc> has finally
2846    vanished.
2847    
2848    John (Reppy) had critizised this as soon as I originally proposed and
2849    implemented it, but at that time I did not really deeply believe
2850    him. :) Now I came full-circle because I need the $<singlearc> syntax
2851    in another place where it cannot be seen as an abbreviation for
2852    $/<singlearc>.  To avoid the confusion, $<singlearc> now means what it
2853    seems to mean (i.e., it "expands" into the corresponding anchor
2854    value).
2855    
2856    However, when paths are used as members in CM description files, it
2857    continues to be true that there must be at least another arc after the
2858    anchor.  This is now enforced separately during semantic analysis
2859    (i.e., from a lexical/syntactical point of view, the notation is ok.)
2860    
2861    ** 2. The "cm" class now accepts an option "bind".  The option's value
2862    is a sub-option list of precisely two items -- one labeled "anchor"
2863    and the other one labeled "value".  As you might expect, "anchor" is
2864    used to specify an anchor name to be bound, and "value" specifies what
2865    the anchor is being bound to.
2866    
2867    The value must be a directory name and can be given in either standard
2868    syntax (including the possibility that it is itself an anchored path)
2869    or native syntax.
2870    
2871    Examples:
2872    
2873       foo.cm (bind:(anchor:bar value:$mystuff/bar))
2874       lib.cm (bind:(anchor:a value:"H:\\x\\y\\z"))  (* only works under windows *)
2875    
2876    and so on.
2877    
2878    The meaning of this is that the .cm-file will be processed with an
2879    augmented anchor environment where the given anchor(s) is/are bound to
2880    the given values(s).
2881    
2882    The rationale for having this feature is this: Suppose you are trying
2883    to use two different (already stable) libraries a.cm and b.cm (that
2884    you perhaps didn't write yourself).  Further, suppose each of these
2885    two libraries internally uses its own auxiliary library $aux/lib.cm.
2886    Normally you would now have a problem because the anchor "lib" can not
2887    be bound to more than one value globally.  Therefore, the project that
2888    uses both a.cm and b.cm must locally redirect the anchor to some other
2889    place:
2890    
2891       a.cm (bind:(anchor:lib value:/usr/lib/smlnj/a-stuff))
2892       b.cm (bind:(anchor:lib value:/usr/lib/smlnj/b-stuff))
2893    
2894    This hard-wires $lib/aux.cm to /usr/lib/smlnj/a-stuff/aux.cm or
2895    /usr/lib/smlnj/b-stuff/aux.cm, respectively.
2896    
2897    Hard-wiring path names is a bit inflexible (and CM will verbosely warn
2898    you when you do so at the time of CM.stabilize).  Therefore, you can
2899    also use an anchored path as the value:
2900    
2901      a.cm (bind:(anchor:lib value:$a-lib))
2902      b.cm (bind:(anchor:lib value:$b-lib))
2903    
2904    Now you can globally configure (using the usual CM.Anchor.anchor or
2905    pathconfig machinery) bindings for "a-lib" and "b-lib".  Since "lib"
2906    itself is always locally bound, setting it globally is no longer
2907    meaningful or necessary (but it does not hurt either).  In fact, "lib"
2908    can still be used as a global anchor for separate purposes.  As a
2909    matter of fact, one can locally define "lib" in terms of a global
2910    "lib":
2911    
2912      a.cm (bind:(anchor:lib value:$lib/a))
2913      b.cm (bind:(anchor:lib value:$lib/b))
2914    
2915    ** 3: The encoding of path names has changed.  This affects the way
2916    path names are shown in CM's progress report and also the internal
2917    protocol encoding used for parallel make.
2918    
2919    The encoding now uses one or more ':'-separated segments.  Each
2920    segments corresponds to a file that has been specified relative to the
2921    file given by its preceding segment.  The first segment is either
2922    relative to the CWD, absolute, or anchored.  Each segment itself is
2923    basically a Unix pathname; all segments but the first are relative.
2924    
2925    Example:
2926    
2927       $foo/bar/baz.cm:a/b/c.sml
2928    
2929    This path denotes the file bar/a/b/c.sml relative to the directory
2930    denoted by anchor "foo".  Notice that the encoding also includes
2931    baz.cm which is the .cm-file that listed a/b/c.sml.  As usual, such
2932    paths are resolved relative to the .cm-files directory, so baz.cm must
2933    be ignored to get the "real" pathname.
2934    
2935    To make this fact more obvious, CM puts the names of such "virtual
2936    arcs" into parentheses when they appear in progress reports. (No
2937    parentheses will appear in the internal protocol encoding.)  Thus,
2938    what you really see is:
2939    
2940      $foo/bar/(baz.cm):a/b/c.sml
2941    
2942    I find this notation to be much more informative than before.
2943    
2944    Another new feature of the encoding is that special characters
2945    including parentheses, colons, (back)slashes, and white space are
2946    written as \ddd (where ddd is the decimal encoding of the character).
2947    
2948    *** The CM manual still needs to be updated.
2949    
2950    ----------------------------------------------------------------------
2951    Name: Allen Leung
2952    Date: 2000/06/15 00:38:00
2953    Tag: leunga-20000615-x86-peephole
2954    
2955    x86 Peephole fix by Fermin.  Affects c-- and moby only.
2956    
2957    ----------------------------------------------------------------------
2958    Name: Matthias Blume
2959    Date: 2000/06/12 11:40:00
2960    Tag: blume-20000612-parmakefix
2961    Description:
2962    
2963    More cleanup after changing the file naming scheme: This time I
2964    repaired the parallel make mechanism for CMB.make which I broke earlier.
2965    
2966    ----------------------------------------------------------------------
2967    Name: Allen Leung
2968    Date: 2000/06/09 01:25:00
2969    Tag: leunga-20000609-various
2970    
2971    None of these things should affect normal SML/NJ operations
2972    
2973    1. Peephole improvements provided by Fermin (c--)
2974    2. New annotation DEFUSE for adding extra dependence (moby)
2975    3. New X86 LOCK instructions (moby)
2976    4. New machine description language for reservation tables (scheduling)
2977    5. Fixes to various optimization/analysis modules (branch chaining, dominator
2978       trees etc.)
2979    6. I've changed the CM files so that they can work with versions
2980       110.0.6, 110.25 and 110.28
2981    
2982    ----------------------------------------------------------------------
2983    Name: Matthias Blume
2984    Date: 2000/06/09 12:40:00
2985    Tag: blume-20000609-log
2986    Description:
2987    
2988    - Removed all(?) remaining RCS Log entries from sources.
2989    
2990    - Fixed bug in ml-yacc and ml-lex sources (use explicit anchors for
2991      anchored paths).
2992    
2993    ----------------------------------------------------------------------
2994    Name: Matthias Blume
2995    Date: 2000/06/07 17:00:00 JST
2996    Tag: blume-20000607-no-implicit-anchors
2997    Description:
2998    
2999    1. This update changes the default setting for
3000    CM.Control.implicit_anchors from true to false.  This means that
3001    implicit anchors are no longer permitted by default.  I also tried to
3002    make sure that nothing else still relies on implicit anchors.
3003    (This is the next step on the schedule towards a CM that does not even
3004    have the notion of implicit anchors anymore.)
3005    
3006    2. More CM manual updates.
3007    
3008    3. I managed to track down and fix the pickling bug I mentioned last
3009    time.  Because of the previously existing workaround, this entails no
3010    immediate practical changes.
3011    
3012    ----------------------------------------------------------------------
3013    Name: Matthias Blume
3014    Date: 2000/06/06 11:15:00 JST
3015    Tag: blume-20000606-lazierpickle
3016    Description:
3017    
3018    !!!! NEW BOOT FILES !!!!
3019    
3020    * The main purpose of this update is to make library pickles lazier in
3021    order to reduce the initial space penalty for autoloading a library.
3022    As a result, it is now possible to have $smlnj/compiler.cm
3023    pre-registered.  This should take care of the many complaints or
3024    inquiries about missing structure Compiler.  This required changes to
3025    CM's internal data structures and small tweaks to some algorithms.
3026    
3027    As a neat additional effect, it is no longer necessary (for the sake
3028    of lean heap image files) to distinguish between a "minimal" CM and a
3029    "full" CM.  Now, there is only one CM (i.e., the "full" version:
3030    $smlnj/cm.cm aka $smlnj/cm/full.cm), and it is always available at the
3031    interactive top level. ($smlnj/cm/minimal.cm is gone.)
3032    
3033    To make the life of compiler-hackers easier, "makeml" now also
3034    pre-registers $smlnj/cmb.cm (aka $smlnj/cmb/current.cm).  In other
3035    words, after you bootstrap a new sml for the first time, you will not
3036    have to autoload $smlnj/cmb.cm again afterwards.  (The first time
3037    around you will still have to do it, though.)
3038    
3039    * A second change consists of major updates to the CM manual.  There
3040    are now several appendices with summary information and also a full
3041    specification of the CM description file syntax.
3042    
3043    * In directory src/system I added the script "allcross".  This script
3044    invokes sml and cross-compiles the compiler for all supported
3045    architectures.  (Useful when providing a new set of boot files.)
3046    
3047    * There seems to be a latent bug in my "lazy pickles" mechanism.  I
3048    added a small tweak to pickle-util.sml to work around this problem,
3049    but it is not a proper fix yet.  I will investigate further.  (The
3050    effect of the bug was an inflation of library pickle size.)
3051    
3052    * Version number increased to 110.28.1 (to avoid compatibility problems).
3053    
3054    ----------------------------------------------------------------------
3055    Name: Allen Leung
3056    Date: 2000/05/25 17:28 EDT
3057    Tag: leunga-20000525-ra
3058    Description:
3059    
3060      Fixed a bug in freezing phase of the register allocator.
3061    
3062    ----------------------------------------------------------------------
3063    Name: Allen Leung
3064    Date: 2000/05/15 22:53 EDT
3065    Tag: leunga-20000515-alpha-x86-ra
3066    Description:
3067    
3068      1. Alpha
3069    
3070          Slight cleanup.  Removed the instruction SGNXL
3071    
3072      2. X86
3073    
3074          Added the following instructions to the instruction set:
3075    
3076            ROLx, RORx,
3077            BTx, BTSx, BTLx, BTRx,
3078            XCHGx, and variants with the LOCK prefix
3079    
3080      3. Register Allocation
3081    
3082          The module ra-rewrite-with-renaming has been improved.
3083    
3084      These have no effect on SML/NJ.
3085    
3086    ----------------------------------------------------------------------
3087    Name: Matthias Blume
3088    Date: 2000/05/15 16:20:00 JST
3089    Tag: blume-20000515-lightrebuild
3090    Description:
3091    
3092    1. I added an alternative to "-rebuild" to "makeml".  The difference is
3093       that prior to calling CMB.make' the CM-variable "LIGHT" will be
3094       defined.  In effect, the command will not build any cross-compiler
3095       backends and therefore finish more quickly.
3096    
3097       The "fixpt" script also takes a "-light" switch to be able to use
3098       this new facility while compiling for a fixpoint.
3099    
3100    2. I replaced all mentions of anchored paths in group owner specifications
3101       with simple relative paths (usually starting with "..").
3102       The rationale is that a library's internal workings should not be
3103       compromised by the lack of some anchor.  (An anchor is necessary
3104       for someone who wants to refer to the library by an anchored path,
3105       but it should not be necessary to build the same library in the first
3106       place.)
3107    
3108    3. I changed the way CM's tool mechanism determines the shell command
3109       string used for things like ml-yacc etc. so that it does not break
3110       when CM.Control.implicit_anchors is turned off.
3111    
3112    ----------------------------------------------------------------------
3113    Name: Matthias Blume
3114    Date: 2000/05/12 18:20:00 JST
3115    Tag: blume-20000512-ml-build
3116    Description:
3117    
3118    Fixed a bug in config/_ml-build that prevented ml-yacc and ml-lex from
3119    getting installed properly (by config/install.sh).
3120    
3121    ----------------------------------------------------------------------
3122    Name: Matthias Blume
3123    Date: 2000/05/12 17:30:00 JST
3124    Tag: blume-20000512-anchors
3125    Description:
3126    
3127    !!! NEW BOOT FILES !!!
3128    
3129    This change is in preparation of fading out support for "implicitly
3130    anchored path names".  I went through all sources and used the
3131    explicit (and relatively new) $-notation.  See system/README and the
3132    CM manual for more info on this.
3133    
3134    I also modified the anchoring scheme for some things such as "smlnj",
3135    "MLRISC", "cm", etc. to take advantage of the fact that explicit
3136    anchors are more expressive: anchor name and first arc do not have to
3137    coincide.  This entails the following user-visible change:
3138    
3139    You have to write $smlnj/foo/bar instead of smlnj/foo/bar.  In
3140    particular, when you fire up sml with a command-line argument, say,
3141    e.g.:
3142    
3143       sml '$smlnj/cmb.cm'
3144    
3145    At the ML toplevel prompt:
3146    
3147       CM.autoload "$smlnj/cmb.cm";
3148    
3149    There is also a new controller in CM.Control that can be used to turn
3150    off all remaining support for implicit anchors by saying:
3151    
3152        CM.autoload "$smlnj/
3153        #set CM.Control.implicit_anchors false;
3154    
3155    This causes CM to reject implicitly anchored paths.  This is (for the
3156    time being) less permissive than the "final" version where there will
3157    be no more such implicit anchors and relative paths will be just that:
3158    relative.
3159    
3160    The next step (version after next version?) will be to make the
3161    default for CM.Control.implicit_anchors false.  After the dust has
3162    settled, I can then produce the "final" version of this...
3163    
3164    Note: Since bootstrapping is a bit tricky, I provided new boot files.
3165    
3166    ----------------------------------------------------------------------
3167    Name: Matthias Blume
3168    Date: 2000/05/11 16:30:00 JST
3169    Tag: blume-20000511-sources
3170    Description:
3171    
3172    The main change is that I added function CM.sources as a generalized
3173    version of the earlier CM.makedepend.  This entails the following
3174    additional changes:
3175    
3176      - CM.makedepend has been dropped.
3177    
3178      - CM manual has been updated.
3179    
3180      - TOOLS signature and API have been changed.
3181    
3182    ----------------------------------------------------------------------
3183    Name: Allen Leung
3184    Date: 2000/05/10 21:17 EDT
3185    Tag: leunga-20000510-moby-c--ssa
3186    Description:
3187    
3188      Various bug fixes and new features for C--, Moby and MLRISC optimizations.
3189    None of these affect SML/NJ.
3190    
3191    1. Register Allocation
3192    
3193        a. A new ra spilling module (ra/ra-spill-with-renaming) is implemented.
3194           This module tries to remove local (i.e. basic block level) redundancies
3195           during spilling.
3196    
3197        b. A new framework for performing region based register allocation.
3198           Not yet entirely functional.
3199    
3200    2. X86
3201    
3202       a. DefUse for POP was missing the stack pointer [found by Lal]
3203       b. Reload for CALL was incorrect in X86Spill [found by John]
3204       c. Various fixes in X86Spill so that it can be used correctly for
3205          the new spilling module.
3206    
3207    3. SSA/IR
3208    
3209       a. New module ir/dj-dataflow.sml implements elimination based
3210          data flow analysis.
3211    
3212    4. MLRiscGen
3213    
3214       a. Fix for gc type annotation
3215    
3216    5. MDGen
3217    
3218       Various fixes for machine description -> ml code translation.  For ssa
3219       only.
3220    
3221    ----------------------------------------------------------------------
3222    Name: Allen Leung
3223    Date: 2000/05/08 22:17 EDT
3224    Tag: leunga-20000508-labexp
3225    Description:
3226    
3227      Fermin has found a few assembly problems with constant expressions
3228      generated in LabelExp.  Mostly, the problems involve extra parentheses,
3229      which choke on dumb assemblers.  This is his fix.
3230    
3231    ----------------------------------------------------------------------
3232    Name: Dave MacQueen
3233    Date: 2000/04/09 14:00 EDT
3234    Tag: dbm-20000502-Version_110_28
3235    Description:
3236    
3237    1. Updated src/compiler/TopLevel/main/version.sml to version 110.28
3238    
3239    2. Updated config/version to 110.28
3240    
3241    3. Updated config/srcarchiveurl
3242    
3243    3. New boot files!
3244       ftp://ftp.research.bell-labs.com/dist/smlnj/working/110.28/
3245    
3246    ----------------------------------------------------------------------
3247    Name: Matthias Blume
3248    Date: 2000/05/01 19:05:00 JST
3249    Tag: blume-20000501-noweb
3250    Description:
3251    
3252    A new noweb tool has been added.  The existing system is entirely
3253    unaffected by this, but some CM users have asked for renewed noweb
3254    support.  Everything is documented in the CM manual.
3255    
3256    New (plugin) libraries:
3257    
3258       noweb-tool.cm
3259       nw-ext.cm
3260    
3261    ----------------------------------------------------------------------
3262    Name: Dave MacQueen
3263    Date: 2000/04/30 12:40PM EDT
3264    Tag: dbm-20000430-bug_fixes
3265    Description:
3266    
3267    1. Fix for bug 1498
3268       smlnj/src/system/Basis/Implementation/Unsafe/object.sig
3269       smlnj/src/system/Basis/Implementation/Unsafe/object.sml
3270         added toRealArray function
3271       smlnj/src/compiler/MiscUtil/print/ppobj.sml
3272         added check for tag Obj.RealArray to array printing case in ppObj
3273    
3274    2. Fix for bug 1510
3275       smlnj/src/compiler/Semant/types/typesutil.sml
3276         fixed definition of dummyargs (used by equalTycon) so that
3277         dummy args are distinct types
3278    
3279    ----------------------------------------------------------------------
3280    Name: Matthias Blume
3281    Date: 2000/04/30 01:00:00 JST
3282    Tag: blume-20000430-versions
3283    Description:
3284    
3285    1. CM version numbering added.  This is an implementation of Lal's
3286       proposal for adding version numbers and version checking to .cm
3287       files.  Lal said that his proposal was just that -- a proposal.
3288       For the time being I went ahead and implemented it so that people
3289       can comment on it.  Everything is completely backward-compatible
3290       (except for the stable library format, i.e., new bootfiles!).
3291    
3292       As usual, see the CM manual for details.
3293    
3294    2. An alternative syntax for anchored paths has been implemented.
3295       Dave has recently voiced the same concerns that I had when I did
3296       this, so there should be some support.  My take is that eventually
3297       I will let support for the current syntax (where anchors are
3298       "implicit") fade out in favor of the new, explicit syntax.
3299       In order to be backward-compatible, both old and new syntax are
3300       currently supported.
3301    
3302       Again, see the CM manual for details.
3303    
3304    3. Parallel make is trying to be slightly smarter:  When the master
3305       process finds a "bottleneck", i.e., when there is only one
3306       compilation unit that can be compiled and everybody else is
3307       waiting on it, then it will simply compile it directly instead
3308       of clumsily telling one of the slaves to do it.
3309    
3310    4. Support for "unsharing" added.  This is necessary in order to be
3311       able to have two different versions of the same library running
3312       at the same time (e.g., for trying out a new MLRISC while still
3313       having the old MLRISC linked into the current compiler, etc.)
3314       See the CM manual.
3315    
3316    5. Simple "makedepend" functionality added for generating Makefile
3317       dependency information.  (This is rather crude at the moment.
3318       Expect some changes here in the future.)
3319    
3320    6. ".fun" added as a recognized suffix for ML files. Also documented
3321       explicitly in the manual that the fallback behavior (unknown suffix
3322       -> ML file) is not an official feature!
3323    
3324    7. Small changes to the pickler for stable libraries.
3325    
3326    8. Several internal changes to CM (for cleanup/improvement).
3327    
3328    
3329    !!!! NEW BINFILES !!!!
3330    
3331    ----------------------------------------------------------------------
3332    Name: Matthias Blume
3333    Date: 2000/04/28 17:30:00 JST
3334    Tag: blume-20000428-pathconfig
3335    Description:
3336    
3337    1. I changed config/install.sh to remove duplicate entries from the
3338       lib/pathconfig file at the end.  Moreover, the final version of
3339       lib/pathconfig is sorted alphabetically.  The same (sorting) is done
3340       in src/system/installml.
3341    
3342    2. The config/install.sh script now consistently uses relative
3343       pathnames in lib/pathconfig whenever the anchor is in the lib
3344       directory.  (So far this was true for the libraries that come
3345       pre-compiled and bundled as part of the bootfiles but not for
3346       libraries that are compiled by the script itself.)
3347    
3348    ----------------------------------------------------------------------
3349    Name: Matthias Blume
3350    Date: 2000/04/26 13:10:00 JST
3351    Tag: blume-20000426-fun_suffix
3352    Description:
3353    
3354    Added ".fun" as a recognized file name suffix (for ML code).
3355    
3356    ----------------------------------------------------------------------
3357    Name: Allen Leung
3358    Date: 2000/04/25 17:00:00 EST
3359    Tag: leunga-20000425-alpha-ra
3360    Description:
3361    
3362    1. Alpha
3363    
3364        PSEUDOARITH was missing in AlphaRewrite.  This causes an endless loop
3365    in C--.
3366    
3367    2. RA
3368    
3369       Added a flag "ra-dump-size" to print out the size of the flowgraph
3370       and the interference graph.
3371    
3372    ----------------------------------------------------------------------
3373    Name: Dave MacQueen
3374    Date: 2000/04/25/
3375    Tag: dbm-20000425-mlyacc_doc_examples
3376    Description:
3377      Updated mlyacc.tex sections 5 and 7 for SML '97 and CM.
3378      Updated all three examples in src/ml-yacc/examples to run
3379      under 110.* using CM.make.
3380    
3381    ----------------------------------------------------------------------
3382    Name: Allen Leung
3383    Date: 2000/04/20 23:04:00 EST
3384    Tag: leunga-20000420-ssa-c---stuff
3385    Description:
3386    
3387      This update synchronizes my repository with Yale's.  Most of these
3388    changes, however, do not affect SML/NJ at all (the RA is an exception).
3389    
3390    1. Register Allocator
3391    
3392       a. An improvement in the interference graph construction:
3393          Given a copy
3394    
3395                s <- t
3396    
3397          no interference edge between s and t is added for this definition of s.
3398    
3399       b. I've added two new spill heuristic modules that Fermin and I developed
3400          (in the new library RA.cm). These are unused in SML/NJ but maybe
3401          useful for others (Moby?)
3402    
3403    2. X86
3404    
3405       a. Various fixes in the backend provided by Fermin [C--] and Lal.
3406    
3407    3. Alpha
3408    
3409       a. Added the BSR instruction and code generation that goes with it [C--]
3410       b. Other fixes too numerous to recount provided by Fermin [C--]
3411    
3412    4. Regmaps
3413    
3414       a. The regmaps are not initialized with the identity physical bindings
3415          at creation time.  This is unneeded.
3416    
3417    5. MLRISC Optimizations
3418    
3419       a. The DJ-Graph module can now compute the iterated dominance frontiers
3420          intersects with liveness incrementally in linear time! Woohoo!
3421          This is now used in my new SSA construction algorithm.
3422    
3423       b. THe branch reorganization module is now smarter about linear chains of
3424          basic blocks.
3425    
3426    
3427    ----------------------------------------------------------------------
3428    Name: Matthias Blume
3429    Date: 2000/04/12 13:52:00 JST
3430    Tag: blume_main_v110p27_1
3431    Description:
3432    
3433    Changed install.sh script to handle archive files without version number
3434    and to use "boot.<arch>-<os>" instead of "sml.boot.<arch>-<os>" for the
3435    name of the boot file archive.
3436    
3437    ----------------------------------------------------------------------
3438    Name: Dave MacQueen
3439    Date: 2000/04/09 14:00 EDT
3440    Tag: dbm-20000410-Version_110_27
3441    Description:
3442    
3443    1. Updated src/compiler/TopLevel/main/version.sml to version 110.27
3444    
3445    2. Updated src/config/version to 110.27
3446    
3447    3. New boot files!
3448    
3449    ----------------------------------------------------------------------
3450    Name: Allen Leung
3451    Date: 2000/04/09 19:09:00 EST
3452    Tag: leunga-20000409-misc
3453    Description:
3454    
3455    1.  Yet another fix for x86 assembly for idivl, imull, mull and friends.
3456    
3457    2.  Miscellaneous improvements to MLRISC (unused in sml/nj)
3458    
3459    ----------------------------------------------------------------------
3460    Name: Stefan
3461    Date: 2000/04/07 10:00:00 EDT
3462    Tag: monnier-20000406-branch-handling
3463    Description:
3464    
3465    Improved handling of branches (mostly those generated from
3466    polymorphic equality), removed switchoff and changed the
3467    default optimization settings (more cpsopt and less flintopt).
3468    
3469    ----------------------------------------------------------------------
3470    Name: Allen Leung
3471    Date: 2000/04/06 01:30:00 EST
3472    Tag: leunga-20000406-peephole-x86-SSA-2
3473    Description:
3474    
3475       Forgot a few files.
3476    
3477    ----------------------------------------------------------------------
3478    Name: Allen Leung
3479    Date: 2000/04/06 00:36:00 EST
3480    Tag: leunga-20000406-peephole-x86-SSA
3481    Description:
3482    
3483    1.  New Peephole code
3484    
3485    2.  Minor improvement to X86 instruction selection
3486    
3487    3.  Various fixes to SSA and machine description -> code translator
3488    
3489    ----------------------------------------------------------------------
3490    Name: Matthias Blume
3491    Date: 2000/04/05 12:30:00 JST
3492    Tag: blume_main_v110p26p2_3
3493    Description:
3494    
3495    This update just merges three minor cosmetic updates to CM's sources
3496    to get ready for the 110.27 code freeze on Friday.  No functionality
3497    has changed.
3498    
3499    ----------------------------------------------------------------------
3500    Name: Allen Leung
3501    Date: 2000/04/04 19:39:00 EST
3502    Tag: leunga-20000404-x86-asm
3503    Description:
3504    
3505    1.  Fixed a problem in X86 assembly.
3506    
3507        Things like
3508    
3509           jmp %eax
3510           jmp (%eax)
3511    
3512        should be output as
3513    
3514           jmp *%eax
3515           jmp *(%eax)
3516    
3517    2.  Assembly output
3518    
3519          Added a new flag
3520    
3521              "asm-indent-copies" (default to false)
3522    
3523          When this flag is on, parallel copies will be indented an extra level.
3524    
3525    ----------------------------------------------------------------------
3526    Name: Allen Leung
3527    Date: 2000/04/04 03:18:00 EST
3528    Tag: leunga-20000404-C--Moby
3529    Description:
3530    
3531        All of these fixes are related to C--, Moby, and my own optimization
3532        stuff; so they shouldn't affect SML/NJ.
3533    
3534    1.  X86
3535    
3536        Various fixes related floating point, and extensions.
3537    
3538    2.  Alpha
3539    
3540        Some extra patterns related to loads with signed/zero extension
3541        provided by Fermin.
3542    
3543    3.  Assembly
3544    
3545        When generating assembly, resolve the value of client defined constants,
3546        instead of generating symbolic values.  This is controlled by the
3547        new flag "asm-resolve-constants", which is default to true.
3548    
3549    4.  Machine Descriptions
3550    
3551        a. The precedence parser was slightly broken when parsing infixr symbols.
3552        b. The type generalizing code had the bound variables reversed, resulting
3553           in a problem during arity raising.
3554        c. Various fixes in machine descriptions.
3555    
3556    ----------------------------------------------------------------------
3557    Name: Matthias Blume
3558    Date: 2000/04/03 16:05:00 JST
3559    Tag: blume_main_v110p26p2_2
3560    Description:
3561    
3562    I eliminated coreEnv from compInfo.  Access to the "Core" structure is
3563    now done via the ordinary static environment that is context to each
3564    compilation unit.
3565    
3566    To this end, I arranged that instead of "structure Core" as "structure
3567    _Core" is bound in the pervasive environment.  Core access is done via
3568    _Core (which can never be accidentally rebound because _Core is not a
3569    legal surface-syntax symbol).
3570    
3571    The current solution is much cleaner because the core environment is
3572    now simply part of the pervasive environment which is part of every
3573    compilation unit's context anyway.  In particular, this eliminates all
3574    special-case handling that was necessary until now in order to deal
3575    with dynamic and symbolic parts of the core environment.
3576    
3577    Remaining hackery (to bind the "magic" symbol _Core) is localized in the
3578    compilation manager's bootstrap compiler (actually: in the "init group"
3579    handling).  See the comments in src/system/smlnj/init/init.cmi for
3580    more details.
3581    
3582    I also tried to track down all mentions of "Core" (as string argument
3583    to Symbol.strSymbol) in the compiler and replaced them with a
3584    reference to the new CoreSym.coreSym.  Seems cleaner since the actual
3585    name appears in one place only.
3586    
3587    Binfile and bootfile format have not changed, but the switchover from
3588    the old "init.cmi" to the new one is a bit tricky, so I supplied new
3589    bootfiles anyway.
3590    
3591  ----------------------------------------------------------------------  ----------------------------------------------------------------------
3592  Name: Allen Leung  Name: Allen Leung
3593  Date: 2000/04/02 21:17:00 EST  Date: 2000/04/02 21:17:00 EST
# Line 113  Line 3690 
3690     (specified in the .cm file at each instance where the tool's class is     (specified in the .cm file at each instance where the tool's class is
3691     used).     used).
3692    
3693     This was done to accomodate the new "make" and "shell" tools which     This was done to accommodate the new "make" and "shell" tools which
3694     facilitate fairly seemless hookup to portions of code managed using     facilitate fairly seamless hookup to portions of code managed using
3695     Makefiles or Shell scripts.     Makefiles or Shell scripts.
3696    
3697     There are no classes "shared" or "private" anymore.  Instead, the     There are no classes "shared" or "private" anymore.  Instead, the
# Line 126  Line 3703 
3703    
3704     All existing tools are described in the CM manual.     All existing tools are described in the CM manual.
3705    
3706     - Slightly better error handling.  (CM now surpresses many followup     - Slightly better error handling.  (CM now suppresses many followup
3707     error messages that tended to be more annoying than helpful.)     error messages that tended to be more annoying than helpful.)
3708    
3709  2. Major changes to the compiler's static environment data structures.  2. Major changes to the compiler's static environment data structures.
# Line 157  Line 3734 
3734       elaborator). There were a lot of changes during my "linkpath" trials       elaborator). There were a lot of changes during my "linkpath" trials
3735       that could have been reverted to their original state but weren't.       that could have been reverted to their original state but weren't.
3736       Please, don't be too harsh on me for messing with this code a bit more       Please, don't be too harsh on me for messing with this code a bit more
3737       than what was strictly necessary...  (I _did_ resist the tempation       than what was strictly necessary...  (I _did_ resist the temptation
3738       of doing any "global reformatting" to avoid an untimely death at       of doing any "global reformatting" to avoid an untimely death at
3739       Dave's hands. :)       Dave's hands. :)
3740    
# Line 260  Line 3837 
3837    
3838       I've changed andl to testl in the floating point test sequence       I've changed andl to testl in the floating point test sequence
3839       whenever appropriate.  The Intel optimization guide states that       whenever appropriate.  The Intel optimization guide states that
3840       testl is perferable to andl.       testl is preferable to andl.
3841    
3842  7. RA (x86 only)  7. RA (x86 only)
3843    
# Line 442  Line 4019 
4019    
4020<