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 605, Fri Apr 7 14:06:42 2000 UTC revision 928, Tue Sep 18 13:38:46 2001 UTC
# Line 11  Line 11 
11  Date:  Date:
12  Tag: <post-commit CVS tag>  Tag: <post-commit CVS tag>
13  Description:  Description:
14    
15    ----------------------------------------------------------------------
16    Name: Matthias Blume
17    Date: 2001/09/18 09:40:00 EDT
18    Tag: Release_110_36
19    Description:
20    
21    New version (110.36).  New bootfiles.
22    
23    ----------------------------------------------------------------------
24    Name: Matthias Blume
25    Date: 2001/09/14 16:15:00 EDT
26    Tag: blume-20010914-x86fastfp
27    Description:
28    
29    John committed some changes that Allen made, in particular a (hopefully)
30    correctly working version of the x86-fp module.
31    
32    I changed the default setting of the Control.MLRISC.getFlag "x86-fast-fp"
33    flag to "true".  Everything seems to compile to a fixpoint ok, and
34    "mandelbrot" speeds up by about 15%.
35    
36    ----------------------------------------------------------------------
37    Name: Matthias Blume
38    Date: 2001/09/13 11:20:00 EDT
39    Tag: blume-20010913-minimal
40    Description:
41    
42    1. Stefan Monnier's patch to fix a miscompilation problem that
43       was brought to light by John Reppy's work on Moby.
44    
45    2. Implemented a minimal "structure Compiler" that contains just
46       "version" and "architecture".  The minimal version will be
47       available when the full version is not.  This is for backward-
48       compatibility with code that wants to test Compiler.version.
49    
50    ----------------------------------------------------------------------
51    Name: Matthias Blume
52    Date: 2001/08/28 14:03:00 EDT
53    Tag: blume-20010828-ml-lex
54    Description:
55    
56    Fix for bug 1581, received from Neophytos Michael.
57    
58    ----------------------------------------------------------------------
59    Name: Matthias Blume
60    Date: 2001/08/27 11:20:00 EDT
61    Tag: blume-20010827-readme11035
62    Description:
63    
64    Fleshed out the README file for 110.35.
65    
66    ----------------------------------------------------------------------
67    Name: Matthias Blume
68    Date: 2001/08/24 17:10:00 EDT
69    Tag: Release_110_35
70    Description:
71    
72    New version number (110.35).  New bootfiles.
73    
74    ----------------------------------------------------------------------
75    Name: Lal George
76    Date: 2001/08/24 13:47:18 EDT 2001
77    Tag: george-20010824-MLRISC-graphs
78    Description:
79    
80     removed clusters from MLRISC completely and replaced with graphs.
81    
82    ----------------------------------------------------------------------
83    Name: Matthias Blume
84    Date: 2001/08/23 17:50:00 EDT
85    Tag: blume-20010823-toplevel
86    Description:
87    
88    - some reorganization of the code that implements various kinds of
89      environments in the compiler (static, dynamic, symbolic, combined)
90    - re-implemented the EnvRef module so that evalStream works properly
91      (if the stream contains references to "use", "CM.make", etc.)
92    - cleaned up evalloop.sml and interact.sml (but they need more cleaning)
93    
94    ----------------------------------------------------------------------
95    Name: Matthias Blume
96    Date: 2001/08/20 15:50 EDT
97    Tag: blume20010820-slipup
98    Description:
99    
100    I forgot to commit a few files.  Here they are...
101    
102    ----------------------------------------------------------------------
103    Name: Matthias Blume
104    Date: 2001/08/20 15:35:00 EDT
105    Tag: blume-20010820-debugprof
106    Description:
107    
108    !!!! NEW BOOTFILES !!!!
109    
110    This is another round of reorganizing the compiler sources.  This
111    time the main goal was to factor out all the "instrumentation"
112    passes (for profiling and backtracing) into their own library.
113    The difficulty was to do it in such a way that it does not depend
114    on elaborate.cm but only on elabdata.cm.
115    
116    Therefore there have been further changes to both elaborate.cm and
117    elabdata.cm -- more "generic" things have been moved from the former
118    to the latter.  As a result, I was forced to split the assignment
119    of numbers indicating "primtyc"s into two portions: SML-generic and
120    SML/NJ-specific.  Since it would have been awkward to maintain,
121    I bit the bullet and actually _changed_ the mapping between these
122    numbers and primtycs.  The bottom line of this is that you need
123    a new set of bin- and bootfiles.
124    
125    I have built new bootfiles for all architectures, so doing a fresh
126    checkout and config/install.sh should be all you need.
127    
128    The newly created library's name is
129    
130        $smlnj/viscomp/debugprof.cm
131    
132    and its sources live under
133    
134        src/compiler/DebugProf
135    
136    ----------------------------------------------------------------------
137    Name: Matthias Blume
138    Date: 2001/08/15 17:15:00 EDT
139    Tag: blume-20010815-compreorg
140    Description:
141    
142    This is a first cut at reorganizing the CM libraries that make up the
143    core of the compiler.  The idea is to separate out pieces that could
144    be used independently by tools, e.g., the parser, the typechecker, etc.
145    
146    The current status is a step in this direction, but it is not quite
147    satisfactory yet.  Expect more changes in the future.
148    
149    Here is the current (new) organization...
150    
151        What used to be $smlnj/viscomp/core.cm is now divided into
152        six CM libraries:
153    
154             $smlnj/viscomp/basics.cm
155                           /parser.cm
156                           /elabdata.cm
157                           /elaborate.cm
158                           /execute.cm
159                           /core.cm
160    
161        The CM files for these libraries live under src/system/smlnj/viscomp.
162        All these libraries are proxy libraries that contain precisely
163        one CM library component.  Here are the locations of the components
164        (all within the src/compiler tree):
165    
166             Basics/basics.cm
167             Parse/parser.cm
168             ElabData/elabdata.cm
169             Elaborator/elaborate.cm
170             Execution/execute.cm
171             core.cm
172    
173         [This organization is the same that has been used already
174         for a while for the architecture-specific parts of the visible
175         compiler and for the old version of core.cm.]
176    
177         As you will notice, many source files have been moved from their
178         respective original locations to a new home in one of the above
179         subtrees.
180    
181         The division of labor between the new libraries is the following:
182    
183             basics.cm:
184                - Simple, basic definitions that pertain to many (or all) of
185                  the other libraries.
186             parser.cm:
187                - The SML parser, producing output of type Ast.dec.
188                - The type family for Ast is also defined and exported here.
189             elabdata.cm:
190                - The datatypes that describe input and output of the elaborator.
191                  This includes types, absyn, and static environments.
192             elaborator.cm:
193                - The SML/NJ type checker and elaborator.
194                  This maps an Ast.dec (with a given static environment) to
195                  an Absyn.dec (with a new static environment).
196                - This libraries implements certain modules that used to be
197                  structures as functors (to remove dependencies on FLINT).
198             execute.cm:
199                - Everything having to do with executing binary code objects.
200                - Dynamic environments.
201             core.cm:
202                - SML/NJ-specific instantiations of the elaborator and MLRISC.
203                - Top-level modules.
204                - FLINT (this should eventually become its own library)
205    
206    Notes:
207    
208    I am not 100% happy with the way I separated the elaborator (and its
209    data structures) from FLINT.  Two instances of the same problem:
210    
211        1. Data structures contain certain fields that carry FLINT-specific
212           information.  I hacked around this using exn and the property list
213           module from smlnj-lib.  But the fact that there are middle-end
214           specific fields around at all is a bit annoying.
215    
216        2. The elaborator calculates certain FLINT-related information.  I tried
217           to make this as abstract as I could using functorization, but, again,
218           the fact that the elaborator has to perform calculations on behalf
219           of the middle-end at all is not nice.
220    
221        3. Having to used exn and property lists is unfortunate because it
222           weakens type checking.  The other alternative (parameterizing
223           nearly *everything*) is not appealing, though.
224    
225    I removed the "rebinding =" warning hack because due to the new organization
226    it was awkward to maintain it.  As a result, the compiler now issues some of
227    these warnings when compiling init.cmi during bootstrap compilation. On
228    the plus side, you also get a warning when you do, for example:
229       val op = = Int32.+
230    which was not the case up to now.
231    
232    I placed "assign" and "deref" into the _Core structure so that the
233    code that deals with the "lazy" keyword can find them there.  This
234    removes the need for having access to the primitive environment
235    during elaboration.
236    
237    ----------------------------------------------------------------------
238    Name: Matthias Blume
239    Date: 2001/08/13
240    Tag: blume-20010813-closures
241    Description:
242    
243    This fix was sent to us by Zhong Shao.  It is supposed to improve the
244    performance of certain loops by avoiding needless closure allocation.
245    
246    ----------------------------------------------------------------------
247    Name: Lal George
248    Date: 2001/07/31 10:03:23 EDT 2001
249    Tag: george-20010731-x86-fmalloc
250    Description: Fixed bug in x86 calls
251    
252        There was a bug where call instructions would mysteriously
253        vanish. The call instruction had to be one that returned
254        a floating point value.
255    
256    ----------------------------------------------------------------------
257    Name: Lal George
258    Date: 2001/07/19 16:36:29 EDT 2001
259    Tag: george-20010719-simple-cells
260    Description:
261    
262    I have dramatically simplified the interface for CELLS in MLRISC.
263    
264    In summary, the cells interface is broken up into three parts:
265    
266      1. CellsBasis : CELLS_BASIS
267    
268            CellsBasis is a top level structure and common for all
269            architectures.  it contains the definitions of basic datatypes
270            and utility  functions over these types.
271    
272      2. functor Cells() : CELLS
273    
274            Cells generates an interface for CELLS that incorporates the
275            specific resources on the target architecture, such as the
276            presence of special register classes, their number and size,
277            and various useful substructures.
278    
279      3. <ARCH>CELLS
280    
281            e.g. SparcCells: SPARCCELLS
282    
283            <ARCH>CELLS usually contains additional bindings for special
284            registers  on the architecture, such as:
285    
286                    val r0 : cell           (* register zero *)
287                    val y : cell            (* Y register *)
288                    val psr : cell          (* processor status register *)
289                    ...
290    
291            The structure returned by applying the Cells functor is opened
292            in this interface.
293    
294    The main implication of all this is that the datatypes for cells is
295    split between CellsBasis and CELLS -- a fairly simple change for user
296    code.
297    
298    In the old scheme the CELLS interface had a definitional binding of
299    the form:
300    
301            signature CELLS = sig
302    
303               structure CellsBasis = CellsBasis
304    
305               ...
306    
307            end
308    
309    With all the sharing constraints that goes on in MLRISC, this old
310    design  quickly leads to errors such as:
311    
312            "structure definition spec inside of sharing ... "
313    
314    
315    and appears to require an unacceptable amount of sharing and where
316    constraint hackery.
317    
318    I think this error message (the interaction of definitional specs and
319    sharing) requires more explanation on our web page.
320    
321    ----------------------------------------------------------------------
322    Name: Matthias Blume
323    Date: 2001/07/19 15:00:00 EDT
324    Tag: blume-20010719-libreorg
325    Description:
326    
327    This update puts together a fairly extensive but straightforward change
328    to the way the libraries that implement the interactive system are
329    organized:
330    
331       The biggest change is the elimination of structure Compiler.  As a
332       replacement for this structure, there is now a CM library
333       (known as $smlnj/compiler.cm or $smlnj/compiler/current.cm)
334       that exports all the substructures of the original structure Compiler
335       directly.  So instead of saying Compiler.Foo.bar one now simply
336       says Foo.bar.  (The CM libraries actually export a collection of
337       structures that is richer than the collection of substructures of
338       structure Compiler.)
339    
340       To make the transition smooth, there is a separate library called
341       $smlnj/compiler/compiler.cm which puts together and exports the
342       original structure Compiler (or at least something very close to it).
343    
344       There are five members of the original structure Compiler
345       that are not exported directly but which instead became members
346       of a new structure Backend (described by signature BACKEND).  These are:
347       structure Profile (: PROFILE), structure Compile (: COMPILE), structure
348       Interact (: INTERACT), structure Machine (: MACHINE), and val
349       architecture (: string).
350    
351       Structure Compiler.Version has become structure CompilerVersion.
352    
353       Cross-compilers for alpha32, hppa, ppc, sparc, and x86 are provided
354       by $smlnj/compiler/<arch>.cm where <arch> is alpha32, hppa, ppc, sparc,
355       or x86, respectively.
356       Each of these exports the same frontend structures that
357       $smlnj/compiler.cm exports.  But they do not have a structure Backend
358       and instead export some structure <Arch>Backend where <Arch> is Alpha32,
359       Hppa, PPC, Sparc, or X86, respectively.
360    
361       Library $smlnj/compiler/all.cm exports the union of the exports of
362       $smlnj/compiler/<arch>.cm
363    
364       There are no structures <Arch>Compiler anymore, use
365       $smlnj/compiler/<arch>.cm instead.
366    
367       Library host-compiler-0.cm is gone.  Instead, the internal library
368       that instantiates CM is now called cm0.cm.  Selection of the host
369       compiler (backend) is no longer done here but. (Responsibility for it
370       now lies with $smlnj/compiler/current.cm.  This seems to be more
371       logical.)
372    
373       Many individual files have been moved or renamed.  Some files have
374       been split into multiple files, and some "dead" files have been deleted.
375    
376    Aside from these changes to library organization, there are also changes
377    to the way the code itself is organized:
378    
379       Structure Binfile has been re-implemented in such a way that it no
380       longer needs any knowledge of the compiler.  It exclusively deals
381       with the details of binfile layout.  It no longer invokes the
382       compiler (for the purpose of creating new prospective binfile
383       content), and it no longer has any knowledge of how to interpret
384       pickles.
385    
386       Structure Compile (: COMPILE) has been stripped down to the bare
387       essentials of compilation.  It no longer deals with linking/execution.
388       The interface has been cleaned up considerably.
389    
390       Utility routines for dealing with linking and execution have been
391       moved into their own substructures.
392    
393       (The ultimate goal of these changes is to provide a light-weight
394       binfile loader/linker (at least for, e.g., stable libraries) that
395       does not require CM or the compiler to be present.)
396    
397    CM documentation has been updated to reflect the changes to library
398    organization.
399    
400    ----------------------------------------------------------------------
401    Name: Matthias Blume
402    Date: 2001/07/10 17:30:00 EDT
403    Tag: Release_110_34
404    Description:
405    
406    Minor tweak to 110.34 (re-tagged):
407    
408      - README.html file added to CVS repository
409      - runtime compiles properly under FreeBSD 3.X and 4.X
410    
411    ----------------------------------------------------------------------
412    Name: Matthias Blume
413    Date: 2001/07/10 17:30:00 EDT
414    Tag: Release_110_34
415    Description:
416    
417    New version number (110.34). New bootfiles.
418    
419    ----------------------------------------------------------------------
420    Name: Matthias Blume
421    Date: 2001/07/09 16:00:00 EDT
422    Tag: blume-20010709-more-varargs
423    Description:
424    
425    I changed the handling of varargs in ml-nlffigen again:
426    The ellipsis ... will now simply be ignored (with an accompanying warning).
427    
428    The immediate effect is that you can actually call a varargs function
429    from ML -- but you can't actually supply any arguments beyond the ones
430    specified explicitly.  (For example, you can call printf with its format
431    string, but you cannot pass additional arguments.)
432    
433    This behavior is only marginally more useful than the one before, but
434    it has the advantage that a function or, more importantly, a function
435    type never gets dropped on the floor, thus avoiding follow-up problems with
436    other types that refer to the offending one.
437    
438    ----------------------------------------------------------------------
439    Name: Matthias Blume
440    Date: 2001/07/09 11:25:00 EDT
441    Tag: blume-20010709-varargs
442    Description:
443    
444    1. ckit-lib.cm now exports structure Error
445    2. ml-nlffigen reports occurences of "..." (i.e., varargs function types)
446       with a warning accompanied by a source location.  Moreover, it
447       merely skips the offending function or type and proceeds with the
448       rest of its work.u  As a result, one can safely feed C code containing
449       "..." to ml-nlffigen.
450    3. There are some internal improvements to CM, providing slightly
451       more general string substitutions in the tools subsystem.
452    
453    ----------------------------------------------------------------------
454    Name: Matthias Blume
455    Date: 2001/06/27 15:10:00 EDT
456    Tag: blume-20010627-concur
457    Description:
458    
459    Fixed a small bug in CM's handling of parallel compilation.
460    (You could observe the bug by Control-C-interrupting an ordinary
461    CMB.make or CM.stabilize and then attaching some compile servers.
462    The result was that all of a sudden the previously interrupted
463    compilation would continue on its own.  This was because of
464    an over-optimization: CM did not bother to clean out certain queues
465    when no servers were attached "anyway", resulting in the contents
466    of these queues to grab control when new servers did get attached.)
467    
468    There is also another minor update to the CM manual.
469    
470    ----------------------------------------------------------------------
471    Name: Matthias Blume
472    Date: 2001/06/26 16:15:00 EDT
473    Tag: blume-20010626-cmdoc
474    Description:
475    
476    Minor typo fixed in CM manual (syntax diagram for libraries).
477    
478    ----------------------------------------------------------------------
479    Name: Matthias Blume
480    Date: 2001/06/25 22:55:00 EDT
481    Tag: blume-20010625-x86pc
482    Description:
483    
484    Fixed a nasty bug in the X86 assembly code that caused signal
485    handlers to fail (crash) randomly.
486    
487    ----------------------------------------------------------------------
488    Name: Matthias Blume
489    Date: 2001/06/25 12:05:00 EDT
490    Tag: blume-20010625-nlffigen
491    Description:
492    
493    This update fixes a number of minor bugs in ml-nlffigen as reported by
494    Nick Carter <nbc@andrew.cmu.edu>.
495    
496      1. Silly but ok typedefs of the form "typedef void myvoid;" are now accepted.
497      2. Default names for generated files are now derived from the name of
498         the C file *without its directory*.  In particular, this causes generated
499         files to be placed locally even if the C file is in some system directory.
500      3. Default names for generated signatures and structures are also derived
501         from the C file name without its directory.  This avoids silly things
502         like "structure GL/GL".
503         (Other silly names are still possible because ml-nlffigen does not do
504          a thorough check of whether generated names are legal ML identifiers.
505          When in doubt, use command line arguments to force particular names.)
506    
507    ----------------------------------------------------------------------
508    Name: Matthias Blume
509    Date: 2001/06/21 12:25:00 EDT
510    Tag: blume-20010621-eXene
511    Description:
512    
513    eXene now compiles and (sort of) works again.
514    
515    The library name (for version > 110.33) is $/eXene.cm.
516    
517    I also added an new example in src/eXene/examples/nbody.  See the
518    README file there for details.
519    
520    ----------------------------------------------------------------------
521    Name: Matthias Blume
522    Date: 2001/06/20 16:40:00 EDT
523    Tag: blume-20010620-cml
524    Description:
525    
526    CML now compiles and works again.
527    
528    Libraries (for version > 110.33):
529    
530      $cml/cml.cm            Main CML library.
531      $cml/basis.cm          CML's version of $/basis.cm.
532      $cml/cml-internal.cm   Internal helper library.
533      $cml/core-cml.cm       Internal helper library.
534      $cml-lib/trace-cml.cm  Tracing facility.
535      $cml-lib/smlnj-lib.cm  CML's version of $/smlnj-lib.cm
536    
537    The installer (config/install.sh) has been taught how to properly
538    install this stuff.
539    
540    ----------------------------------------------------------------------
541    Name: Matthias Blume
542    Date: 2001/06/19 17:55:00 EDT
543    Tag: blume-20010619-instantiate
544    Description:
545    
546    This un-breaks the fix for bug 1432.
547    (The bug was originally fixed in 110.9 but I broke it again some
548    time after that.)
549    
550    ----------------------------------------------------------------------
551    Name: Matthias Blume
552    Date: 2001/06/19 17:25:00 EDT
553    Tag: blume-20010619-signals
554    Description:
555    
556    This should (hopefully) fix the long-standing signal handling bug.
557    (The runtime system was constructing a continuation record with an
558    incorrect descriptor which would cause the GC to drop data on the floor...)
559    
560    ----------------------------------------------------------------------
561    Name: Matthias Blume
562    Date: 2001/06/15 15:05:00 EDT
563    Tag: blume-20010615-moresparc
564    Description:
565    
566    Here is a short late-hour update related to Sparc c-calls:
567    
568     -- made handling of double-word arguments a bit smarter
569    
570     -- instruction selection phase tries to collapse certain clumsily
571        constructed ML-Trees; typical example:
572    
573            ADD(ty,ADD(_,e,LI d1),LI d2)  ->  ADD(ty,e,LI(d1+d2))
574    
575        This currently has no further impact on SML/NJ since mlriscGen does
576        not seem to generate such patterns in the first place, and c-calls
577        (which did generate them in the beginning) has meanwhile been fixed
578        so as to avoid them as well.
579    
580    ----------------------------------------------------------------------
581    Name: Matthias Blume
582    Date: 2001/06/15 15:05:00 EDT
583    Tag: blume-20010615-sparc
584    Description:
585    
586    The purpose of this update is to provide an implementation of NLFFI
587    on Sparc machines.
588    
589    Here are the changes in detail:
590    
591       * src/MLRISC/sparc/c-calls/sparc-c-calls.sml is a new file containing
592       the Sparc implementation of the c-calls API.
593       * The Sparc backend of SML/NJ has been modified to uniformely use %fp
594       for accessing the ML frame.  Thus, we have a real frame pointer and
595       can freely modify %sp without need for an omit-frame-ptr phase.
596       The vfp logic in src/compiler/CodeGen/* has been changed to accomodate
597       this case.
598       * ml-nlffigen has been taught to produce code for different architectures
599       and calling conventions.
600       * In a way similar to what was done in the x86 case, the Sparc
601       backend uses its own specific extension to mltree.  (For example,
602       it needs to be able to generate UNIMP instructions which are part
603       of the calling convention.)
604       * ml-nlffi-lib was reorganized to make it more modular (in particular,
605       to make it easier to plug in new machine- and os-dependent parts).
606    
607    There are some other fairly unrelated bug fixes and cleanups as well:
608    
609       * I further hacked the .cm files for MLRISC tools (like MDLGen) so
610       that they properly share their libraries with existing SML/NJ libraries.
611       * I fixed a minor cosmetic bug in CM, supressing certain spurious
612       follow-up error messages.
613       * Updates to CM/CMB documentation.
614    
615    TODO items:
616    
617       * MLRISC should use a different register as its asmTemp on the Sparc.
618         (The current %o2 is a really bad choice because it is part of the
619         calling conventions, so things might interfere in unexpected ways.)
620    
621    ----------------------------------------------------------------------
622    Name: Matthias Blume
623    Date: 2001/06/07
624    Tag: blume-20010607-calls
625    Description:
626    
627    A number of internal changes related to C calls and calling conventions:
628    
629    1. ML-Tree CALL statements now carry a "pops" field.  It indicates the
630       number of bytes popped implicitly (by the callee).  In most cases
631       this field is 0 but on x86/win32 it is some non-zero value.  This
632       is information provided for the benefit of the "omit-frameptr" pass.
633    2. The CALL instruction on the x86 carries a similar "pops" field.
634       The instruction selection phase copies its value from the ML-Tree
635       CALL statement.
636    3. On all other architectures, the instruction selection phase checks
637       whether "pops=0" and complains if not.
638    4. The c-calls implementation for x86 now accepts two calling conventions:
639       "ccall" and "stdcall".  When "ccall" is selected, the caller cleans
640       up after the call and pops is set to 0.  For "stdcall", the caller
641       does nothing, leaving the cleanup to the callee; pops is set to
642       the number of bytes that were pushed onto the stack.
643    5. The cproto decoder (compiler/Semant/types/cproto.sml) now can
644       distinguish between "ccall" and "stdcall".
645    6. The UNIMP instruction has been added to the supported Sparc instruction
646       set. (This is needed for implementing the official C calling convention
647       on this architecture.)
648    7. I fixed some of the .cm files under src/MLRISC/Tools to make them
649       work with the latest CM.
650    
651    ----------------------------------------------------------------------
652    Name: Matthias Blume
653    Date: 2001/06/05 15:10:00 EDT
654    Tag: blume-20010605-cm-index
655    Description:
656    
657    0. The "lambdasplit" parameter for class "sml" in CM has been documented.
658    
659    1. CM can now generate "index files".  These are human-readable files
660       that list on a per-.cm-file basis each toplevel symbol defined or
661       imported.  The location of the index file for
662       <p>/<d>.cm is <p>/CM/INDEX/<d>.cm.
663       To enable index-file generation, set CM.Control.generate_index to true
664       or export an environment-symbol: export CM_GENERATE_INDEX=true.
665    
666       The CM manual has been updated accordingly.
667    
668    2. I made some slight modifications to the c-calls API in MLRISC.
669    
670         a) There is now a callback to support saving/restoring of
671            dedicated but caller-save registers around the actual call
672            instruction.
673         b) One can optionally specify a comment-annotation for the
674            call instruction.
675    
676    3. SML/NJ (mlriscGen.sml) uses this new API for the rawccall primop.
677       (For example, the comment annotation shows the C prototype of
678        the function being called.)
679    
680    ----------------------------------------------------------------------
681    Name: Matthias Blume
682    Date: 2001/06/01 13:30:00 EDT
683    Tag: blume-20010601-nlffi-cleanup
684    Description:
685    
686    This is mostly a cleanup of MLFFI stuff:
687    
688       - some signature files have been put into a more exposed place
689       - the ugly 'f type parameter is gone (simplifies types tremendously!)
690       - ml-nlffigen changed accordingly
691       - tutorial updated
692    
693    Other changes:
694    
695       - author's affiliation in CM manual(s) updated
696       - some more recognized keywords added to Allen's sml.sty
697    
698    ----------------------------------------------------------------------
699    Name: Matthias Blume
700    Date: 2001/05/25 15:30:00 EDT
701    Tag: blume-20010525-iptr
702    Description:
703    
704      - put the official 110.33-README (as it appears on the ftp server) under
705        CVS
706      - fixed a small bug related to incomplete pointer types in
707        ml-nlffigen
708      - small cosmetic change to the ml-nlffi-lib's "arr" type constructor
709        (it does not need the 'f type parameter)
710    
711    ----------------------------------------------------------------------
712    Name: Matthias Blume
713    Date: 2001/05/23 14:30:00 EDT
714    Tag: Release_110_33
715    Description:
716    
717    New version number (110.33).  New bootfiles.
718    
719    ----------------------------------------------------------------------
720    Name: Matthias Blume
721    Date: 2001/05/22 18:06:00 EDT
722    Tag: blume-20010522-targets
723    Description:
724    
725    Made install.sh use file config/targets.customized if it exists, falling
726    back to config/targets if it doesn't.  This way one can have a customized
727    version of the targets file without touching the "real thing", thus
728    eliminating the constant fear of accidentally checking something bogus
729    back into the CVS repository...  (File config/targets.customized must
730    not be added to the repository!)
731    
732    ----------------------------------------------------------------------
733    Name: Matthias Blume
734    Date: 2001/05/22 16:30:00 EDT
735    Tag: blume-20010522-minitut
736    Description:
737    
738    1. Bug fix in ml-nlffigen; now (hopefully) correctly handling
739       struct returns.
740    2. Added src/ml-nlffi-lib/Doc/mini-tutorial.txt.  This is some very
741       incomplete, preliminary documentation for NLFFI.
742    
743    ----------------------------------------------------------------------
744    Name: Matthias Blume
745    Date: 2001/05/14 11:30:00 EDT
746    Tag: blume-20010514-script
747    Description:
748    
749    Some bugs in install script fixed.
750    
751    In addition to that I also made a slight change to the NLFFI API:
752    Functors generated by ml-nlffigen now take the dynamic library as a
753    straight functor argument, not as a suspended one.  (The original
754    functor code used to force the suspension right away anyway, so there
755    was nothing gained by this complication of the interface.)
756    
757    ----------------------------------------------------------------------
758    Name: Matthias Blume
759    Date: 2001/05/11 14:35:00 EDT
760    Tag: blume-20010511-ml-nlffi
761    Description:
762    
763    I finally took the plunge and added my new FFI code to the main
764    repository.  For x86-linux it is now ready for prime-time.
765    
766    There are two new subdirectories of "src":
767    
768      - ml-nlffi-lib:
769           The utility library for programs using the FFI interface.
770           Here is the implementation of $/c.cm and its associated low-level
771           partners $/c-int.cm and $/memory.cm.
772      - ml-nlffigen:
773           A stand-alone program for generating ML glue code from C source
774           code.
775    
776    Building ml-nlffigen requires $/ckit-lib.cm.
777    
778    The config/install.sh script has been updates to do the Right Thing
779    (hopefully).
780    
781    Notice that the source tree for the C-Kit will not be put under "src"
782    but directly under the installation root directory.  (This is the
783    structure that currently exists on the CVS server when you check out
784    module "sml".)  Fortunately, config/install.sh knows about this oddity.
785    
786    Bugs: No documentation yet.
787    
788    ----------------------------------------------------------------------
789    Name: Matthias Blume
790    Date: 2001/05/09 16:35:00 EDT
791    Tag: blume-20010509-cpscontract
792    Description:
793    
794    Fixed a bug in the accounting code in cpsopt/contract.sml.  (The
795    wrapper/unwrapper elimination did not decrement usage counts and some
796    dead variables got overlooked by the dead-up logic.)
797    
798    ----------------------------------------------------------------------
799    Name: Lal George
800    Date: 2001/05/08  17:26:09 EDT
801    Tag: george-20010508-omit-frameptr
802    Description:
803    
804    Changes to implement the omit-frame-pointer optimization to support
805    raw C calls. For now, there is only support on the Intel x86, but
806    other architectures will follow as more experience is gained with this.
807    
808    
809    ----------------------------------------------------------------------
810    Name: Matthias Blume
811    Date: 2001/05/07 14:40:00 EDT
812    Tag: blume-20010507-proxies
813    Description:
814    
815    I made into "proxy libraries" all libraries that qualify for such a
816    change.  (A qualifying library is a library that has another library or
817    groups as its sole member and repeats that member's export list
818    verbatim.  A proxy library avoids this repetition by omitting its export
819    list, effectively inheriting the list that its (only) member exports.
820    See the CM manual for more explanation.)
821    The main effect is that explicit export lists for these libraries
822    do not have to be kepts in sync, making maintenance a bit easier.
823    
824    I also added copyright notices to many .cm-files.
825    
826    Last but not least, I made a new set of bootfiles.
827    
828    ----------------------------------------------------------------------
829    Name: Matthias Blume
830    Date: 2001/05/04 17:00:00 EDT
831    Tag: blume-20010504-cm-lsplit
832    Description:
833    
834    0. John merged pending changes to $/smlnj-lib.cm
835    
836    1. Allen's previous change accidentally backed out of one of Lal's
837       earlier changes.  I undid this mistake (re-introducing Lal's change).
838    
839    2. I used the new topOrder' function from graph-scc.sml (from $/smlnj-lib.cm)
840       within the compiler where applicable.  There is some code simplification
841       because of that.
842    
843    3. The "split" phase (in FLINT) is now part of the default list of phases.
844       Compiler.Control.LambdaSplitting.* can be used to globally control the
845       lambda-splitting (cross-module-inlining) engine.  In addition to that,
846       it can now also be controlled on a per-source basis: CM has been taught
847       a new tool parameter applicable to ML source files.
848    
849       - To turn lambda-splitting off completely:
850            local open Compiler.Control.LambdaSplitting in
851                val _ = set Off
852            end
853       - To make "no lambda-splitting" the global default (but allow per-source
854         overriding); this is the initial setting:
855            local open Compiler.Control.LambdaSplitting in
856                val _ = set (Default NONE)
857            end
858       - To make "lambda-splitting with aggressiveness a" the global default
859         (and allow per-source overriding):
860            local open Compiler.Control.LambdaSplitting in
861                val _ = set (Default (SOME a))
862            end
863    
864       - To turn lambda-splitting off for a given ML souce file (say: a.sml)
865         write (in the respective .cm-file):
866            a.sml (lambdasplitting:off)
867       - To turn lambda-splitting for a.sml on with minimal aggressiveness:
868            a.sml (lambdasplitting:on)
869       - To turn lambda-splitting for a.sml on with aggressiveness <a> (where
870         <a> is a decimal non-negative integer):
871            a.sml (lambdasplitting:<a>)
872       - To turn lambda-splitting for a.sml on with maximal aggressiveness:
873            a.sml (lambdasplitting:infinity)
874       - To use the global default for a.sml:
875            a.sml (lambdasplitting:default)
876         or simply
877            a.sml
878    
879    ----------------------------------------------------------------------
880    Name: Allen Leung
881    Date: 2001/05/04 01:57:00 EDT
882    Tag: leunga-20010504-sync
883    Description:
884    
885      MLRISC features.
886    
887      1. Fix to CMPXCHG instructions.
888      2. Changed RA interface to allow annotations in callbacks.
889      3. Added a new method to the stream interface to allow annotations updates.
890    
891    ----------------------------------------------------------------------
892    Name: Matthias Blume
893    Date: 2001/05/01 11:45:00 EDT
894    Tag: blume-20010501-pcedittmp
895    Description:
896    
897    Changed install.sh to use the current working directory instead of
898    /usr/tmp for a temporary file (pcedittmp).  The previous choice
899    of /usr/tmp caused trouble with MacOS X because of file premission
900    problems.
901    
902    ----------------------------------------------------------------------
903    Name: Matthias Blume
904    Date: 2001/04/20 11:10:00 EDT
905    Tag: blume-20010420-inMLflag
906    Description:
907    
908     - added vp_limitPtrMask to vproc-state.h
909       (for use by the raw-C-calls mechanism to implement proper interrupt
910        handling)
911     - made the ML compiler aware of various data-structure offsets so it
912       can generate code for accessing the vp_inML flag and vp_limitPtrMask
913     - tweaked mlriscGen.sml to have it emit interrupt-handling code for
914       raw C-calls
915    
916    ----------------------------------------------------------------------
917    Name: Lal George
918    Date: 2001/04/20 09:15:28 EDT
919    Tag: george-20010420-macosX
920    Description:
921    
922     - Changes to port to Mac OS X; Darwin.
923    
924     - In the process I found that sqrt was broken on the PPC, because the
925       fsqrt instruction is not implemented.
926    
927    ----------------------------------------------------------------------
928    Name: Matthias Blume
929    Date: 2001/04/18 12:45:00 EDT
930    Tag: blume-20010418-ccalls
931    Description:
932    
933     - fixed two off-by-4 errors in the x86-specific c-calls implementation
934       (this bug prevented structure arguments containing pointers from being
935        passed correctly)
936     - changed the raw-C-call code in mlriscGen.sml in such a way that
937       structure arguments are represented as a pointer to the beginning
938       of the structure (instead of having a series of synthesized arguments,
939       one for each structure member)
940    
941     - made makeml script's verbosity level configurable via environment
942       variable (MAKEML_VERBOSITY)
943    
944     - eliminated placeholder implementations for f32l, w16s, i16s, and f32s
945       in rawmem-x86.sml; we are now using the real thing
946    
947    ----------------------------------------------------------------------
948    Name: Matthias Blume
949    Date: 2001/03/22 16:25:00 EST
950    Tag: blume-20010322-bootfiles
951    Description:
952    
953    Created a new set of bootfiles (for your automatic installation convenience).
954    
955    ----------------------------------------------------------------------
956    Name: Matthias Blume
957    Date: 2001/03/22 15:10:00 EST
958    Tag: blume-20010322-rawmem-parcm
959    Description:
960    
961    1. All "raw memory access" primitives for the new FFI are implemented now
962       (at least on the x86).
963    2. Some further cleanup of CM's parallel make mechanism.
964    
965    ----------------------------------------------------------------------
966    Name: Matthias Blume
967    Date: 2001/03/19 17:53:00 EST
968    Tag: blume-20010319-parallel
969    Description:
970    
971    Parallel make (using compile servers) now works again.
972    
973    To this end, CM.stabilize and CMB.make have been modified to work in
974    two passes when compile servers are attached:
975       1. Compile everything, do not perform stabilization; this pass
976          uses compile servers
977       2. Stabilize everything; this pass does not use compile servers
978    If there are no compile servers, the two passes are combined into one
979    (as before).  Splitting the passes increases the inherent parallelism
980    in the dependency graph because the entire graph including all
981    libraries is available at the same time.  This, in turn, improves
982    server utilization.  The downside is that the master process will
983    have to do some extra work after compilation is done (because for
984    technical reasons it must re-read all the binfiles during stabilization).
985    
986    ----------------------------------------------------------------------
987    Name: Matthias Blume
988    Date: 2001/03/16 12:22:00 EST
989    Tag: blume-20010316-bootfiles
990    Description:
991    
992    Created a new set of bootfiles (for your automatic installation convenience).
993    
994    ----------------------------------------------------------------------
995    Name: Matthias Blume
996    Date: 2001/03/16 11:00:00 EST
997    Tag: blume-20010316-MLTREE-fixup
998    Description:
999    
1000    This is a minor fixup for an (untagged) earlier commit by Allen.
1001    (A file was missing).
1002    
1003    ----------------------------------------------------------------------
1004    Name: Allen Leung
1005    Date: Mon Mar  5 18:54:57 EST 2001
1006    Tag: leunga-20010305-cut-support
1007    
1008    1. New support for alternative control-flow in MLTREE.
1009       Currently we support
1010    
1011          FLOW_TO(CALL ...., [k1,...,kn])
1012    
1013       This is needed for 'cuts to' in C-- and try/handle-like constructs
1014       in Moby
1015    
1016       New assembler flag "asm-show-cutsto" to turn on control-flow debugging.
1017    
1018    2. Register Allocator
1019    
1020       Changes in interface [from Fermin, John]
1021    
1022    3. Alpha 8-bit SLL support [Fermin]
1023    
1024    4. All architectures
1025    
1026       A new module (ClusterExpandCopies) for expanding parallel copies.
1027    
1028    ----------------------------------------------------------------------
1029    Name: Allen Leung
1030    Date: 2001/02/27 23:07:00 EST
1031    Tag: leunga-20010227-minor-stuff
1032    
1033    1. Alpha bug fix for CMOVNE
1034    2. Handle mltree COND(..,FCMP ...,...)
1035    3. Bug fix in simplifier
1036    
1037    ----------------------------------------------------------------------
1038    Name: Matthias Blume
1039    Date: 2001/01/30 17:50:00 EST
1040    Tag: blume-20010130-sync
1041    Description:
1042    
1043    This is just a minor update to sync my devel branch with the main brach.
1044    The only visible change is the addition of some README files.
1045    
1046    ----------------------------------------------------------------------
1047    Name: Matthias Blume
1048    Date: 2001/01/12 23:30:00 JST
1049    Tag: blume-20010112-bootfiles
1050    Description:
1051    
1052    Made a new set of bootfiles that goes with the current state of the
1053    repository.
1054    
1055    ----------------------------------------------------------------------
1056    Name: Matthias Blume
1057    Date: 2001/01/12 21:20:00 JST
1058    Tag: blume-20010112-sync
1059    Description:
1060    
1061    I am just flushing out some minor changes that had accumulated in
1062    my private branch in order to sync with the main tree.  (This is
1063    mainly because I had CVS trouble when trying to merge _into_ my
1064    private branch.)
1065    
1066    Most people should be completely unaffected by this.
1067    
1068    ----------------------------------------------------------------------
1069    Name: Allen Leung
1070    Date: Thu Jan 11 21:03:00 EST 2001
1071    Tag: leunga-20010111-labexp=mltree
1072    Description:
1073    
1074    1.  Removed the type LabelExp and replace it by MLTree.
1075    2.  Rewritten mltree-simplify with the pattern matcher tool.
1076    3.  There were some bugs in alpha code generator which would break
1077        64-bit code generation.
1078    4.  Redo the tools to generate code with the
1079    5.  The CM files in MLRISC (and in src/system/smlnj/MLRISC)
1080        are now generated by perl scripts.
1081    
1082    ----------------------------------------------------------------------
1083    Name: Matthias Blume
1084    Date: 2001/01/10 21:55:00 JST
1085    Tag: blume-20010110-rcc
1086    Description:
1087    
1088    The RCC stuff now seems to work (but only on the x86).
1089    This required hacking of the c-calls interface (and -implementation) in
1090    MLRISC.
1091    
1092    Normal compiler users should be unaffected.
1093    
1094    ----------------------------------------------------------------------
1095    Name: Matthias Blume
1096    Date: 2001/01/09 01:20:00 JST
1097    Tag: blume-20010109-rcc
1098    Description:
1099    
1100    This is a fairly big patch, flushing out a large number of pending
1101    changes that I made to my development copy over the last couple of days.
1102    
1103    Of practical relevance at this moment is a workaround for a pickling
1104    bug that Allen ran into the other day.  The cause of the bug itself is
1105    still unknown and it might be hard to fix it properly, but the
1106    workaround has some merits of its own (namely somewhat reducing pickling
1107    overhead for certain libraries).  Therefore, I think this solution should
1108    be satisfactory at this time.
1109    
1110    The rest of the changes (i.e., the vast majority) has to do with my
1111    ongoing efforts of providing direct support for C function calls from
1112    ML.  At the moment there is a new primop "RAW_CCALL", typing magic
1113    in types/cproto.sml (invoked from FLINT/trans/translate.sml), a new
1114    case in the FLINT CPS datatype (RCC), changes to cps/convert.sml to
1115    translate uses of RAW_CCALL into RCC, and changes to mlriscGen.sml to
1116    handle RCC.
1117    
1118    The last part (the changes to mlriscGen.sml) are still known to be
1119    wrong on the x86 and not implemented on all other architectures.  But
1120    the infrastructure is in place. I had to change a few functor
1121    signatures in the backend to be able to route the CCalls interface
1122    from MLRISC there, and I had to specialize the mltree type (on the
1123    x86) to include the necessary extensions. (The extensions themselves
1124    were already there and redy to go in MLRISC/x86).
1125    
1126    Everything should be very happy as soon as someone helps me with
1127    mlriscGen.sml...
1128    
1129    In any case, nothing of this should matter to anyone as long as the
1130    new primop is not being used (which is going to be the case unless you
1131    find it where I hid it :). The rest of the compiler is completely
1132    unaffected.
1133    
1134    ----------------------------------------------------------------------
1135    Name: Matthias Blume
1136    Date: 2001/01/05 00:30:00 JST
1137    Tag: blume-20010105-primops
1138    Description:
1139    
1140    Added some experimental support for work that I am doing right now.
1141    These changes mostly concern added primops, but there is also a new
1142    experimental C library in the runtime system (but currently not enabled
1143    anywhere except on Linux/X86).
1144    
1145    In the course of adding primops (and playing with them), I discovered that
1146    Zhong's INL_PRIM hack (no type info for certain primops) was, in fact, badly
1147    broken.  (Zhong was very right he labeled this stuff as "major gross hack".)
1148    To recover, I made type information in INL_PRIM mandatory and changed
1149    prim.sml as well as built-in.sml accordingly.  The InLine structure now
1150    has complete, correct type information (i.e., no bottom types).
1151    
1152    Since all these changes mean that we need new binfiles, I also bumped the
1153    version number to 110.32.1.
1154    
1155    ----------------------------------------------------------------------
1156    Name: Matthias Blume
1157    Date: 2000/12/30 22:10:00 JST
1158    Tag: blume-20001230-various
1159    Description:
1160    
1161    Added proxy libraries for MLRISC and let MLRISC libraries refer
1162    to each other using path anchors.  (See CM manual for explanation.)
1163    
1164    Updated CM documentation.
1165    
1166    Fixed some bugs in CM.
1167    
1168    Implemented "proxy" libraries (= syntactic sugar for CM).
1169    
1170    Added "-quiet" option to makeml and changed runtime system accordingly.
1171    
1172    Added cleanup handler for exportML to reset timers and compiler stats.
1173    
1174    ----------------------------------------------------------------------
1175    Name: Lal George
1176    Date: 2000/12/22 22:22:58 EST 2000
1177    Tag: Release_110_32
1178    Description:
1179    
1180            Infinite precision used throughout MLRISC.
1181            see MLRISC/mltree/machine-int.sig
1182    
1183    ----------------------------------------------------------------------
1184    Name: Matthias Blume
1185    Date: 2000/12/22 23:16:00 JST
1186    Tag: blume-20001222-warn
1187    Description:
1188    
1189    Corrected wording and formatting of some CM warning message which I
1190    broke in my previous patch.
1191    
1192    ----------------------------------------------------------------------
1193    Name: Matthias Blume
1194    Date: 2000/12/22 21:20:00 JST
1195    Tag: blume-20001222-anchorenv
1196    Description:
1197    
1198    Fixed CM's handling of anchor environments in connection with CMB.make.
1199    
1200    ----------------------------------------------------------------------
1201    Name: Matthias Blume
1202    Date: 2000/12/22 13:15:00 JST
1203    Tag: blume-20001222-cleanup
1204    Description:
1205    
1206    Removed src/cm/ffi which does not (and did not) belong here.
1207    
1208    ----------------------------------------------------------------------
1209    Name: Matthias Blume
1210    Date: 2000/12/21 23:55:00 JST
1211    Tag: blume-20001221-exn
1212    Description:
1213    
1214    Probably most important: CM no longer silently swallows all exceptions
1215    in the compiler.
1216    Plus: some other minor CM changes.  For example, CM now reports some
1217    sizes for generated binfiles (code, data, envpickle, lambdapickle).
1218    
1219    ----------------------------------------------------------------------
1220    Name: Matthias Blume
1221    Date: 2000/12/15 00:01:05 JST
1222    Tag: blume-20001215-dirtool
1223    Description:
1224    
1225    - "dir" tool added.
1226    - improvements and cleanup to Tools structure
1227    - documentation updates
1228    
1229    ----------------------------------------------------------------------
1230    Name: Allen Leung
1231    Date: Thu Dec 14 03:45:24 EST 2000
1232    Description:
1233    Tag:  leunga-20001214-int-inf
1234    Description:
1235    
1236       In IntInf, added these standard functions, which are missing from our
1237    implementation:
1238    
1239        andb : int * int -> int
1240        xorb : int * int -> int
1241        orb  : int * int -> int
1242        notb : int -> int
1243         <<   : int * word -> int
1244        ~>>  : int * word -> int
1245    
1246       Not tested, I hope they are correct.
1247    
1248    ----------------------------------------------------------------------
1249    Name: Allen Leung
1250    Date: Fri Dec  8 19:23:26 EST 2000
1251    Description:
1252    Tag:  leunga-20001208-nowhere
1253    Description:
1254    
1255      Slight improvements to the 'nowhere' tool to handle OR-patterns,
1256    to generate better error messages etc.  Plus a brief manual.
1257    
1258    ----------------------------------------------------------------------
1259    Name: Lal George
1260    Date: 2000/12/08 09:54:02 EST 2000
1261    Tag: Release_110_31
1262    Description:
1263    
1264    - Version 110.31
1265    ----------------------------------------------------------------------
1266    Name: Allen Leung
1267    Date: Thu Dec  7 22:01:04 EST 2000
1268    Tag:  leunga-20001207-cell-monster-hack
1269    Description:
1270    
1271    Major MLRISC internal changes.  Affect all clients.
1272    Summary:
1273    
1274    1.  Type CELLS.cell = int is now replaced by a datatype.
1275        As a result, the old regmap is now gone.  Almost all interfaces
1276        in MLRISC change as a consequence.
1277    
1278    2.  A new brand version of machine description tool (v3.0) that generates
1279        modules expecting the new interface.  The old version is removed.
1280    
1281    3.  The RA interface has been further abstracted into two new functors.
1282        RISC_RA and X86RA.  These functors have much simpler interfaces.
1283        [See also directory MLRISC/demo.]
1284    
1285    4.  Some other new source->source code generation tools are available:
1286    
1287        a. MLRISC/Tools/RewriteGen -- generate rewriters from rules.
1288        b. MLRISC/Tools/WhereGen -- expands conditional pattern matching rules.
1289           I use this tool to generate the peephole optimizers---with the new
1290           cell type changes, peephole rules are becoming difficult to write
1291           without conditional pattern matching.
1292    
1293    5.  More Intmap -> IntHashTable change.  Previous changes by Matthias didn't
1294        cover the entire MLRISC source tree so many things broke.
1295    
1296    6.  CM files have been moved to the subdirectory MLRISC/cm.
1297        They are moved because there are a lot of them and they clutter up the
1298        root dir.
1299    
1300    7.  More detailed documentation to come...
1301    
1302        NOTE: To rebuild from 110.30 (ftp distribution), you'll have to do
1303        a makeml -rebuild first.  This is because of other other
1304        changes that Matthias has made (see below).
1305    
1306    
1307    ----------------------------------------------------------------------
1308    Name: Matthias Blume
1309    Date: 2000/11/30 23:12:00 JST
1310    Tag: blume-20001130-filereorg
1311    Description:
1312    
1313    Some manual updates and some file reorganizations in CM.
1314    
1315    ----------------------------------------------------------------------
1316    Name: Matthias Blume
1317    Date: 2000/11/24 17:45:00 JST
1318    Tag: blume-20001124-link
1319    Description:
1320    
1321    Drastically improved link traversal code for the case that the dynamic
1322    value was already loaded at bootstrap time.  As a result, CM and CMB
1323    now both load blazingly fast -- even on a very slow machine.  Also,
1324    memory consumption has been further reduced by this.
1325    
1326    Warning: The format of the PIDMAP file has changed.  THerefore, to
1327    bootstrap you have to do this:
1328    
1329    1. Run CMB.make
1330    2. Make a symbolic link for the boot directory:
1331         ln -s sml.boot.ARCH-OS xxx
1332    3. "Rebuild" the boot directory:
1333         ./makeml -boot xxx -rebuild sml ; rm xxx
1334    4. Boot normally:
1335          ./makeml
1336    
1337    ----------------------------------------------------------------------
1338    Name: Matthias Blume
1339    Date: 2000/11/21 21:20:00 JST
1340    Tag: blume-20001121-tools
1341    Description:
1342    
1343    Continued hacking on autoloading problem -- with success this time.
1344    Also changed tool-plugin mechanism.  See new CM manual.
1345    
1346    ----------------------------------------------------------------------
1347    Name: Matthias Blume
1348    Date: 2000/11/19 14:30:00 JST
1349    Tag:  blume-20001119-autoload
1350    Description:
1351    
1352    Some hacking to make autoloading faster.  Success for CMB, no success
1353    so far for CM.  There is a reduced structure CM' that autoloads faster.
1354    (This is a temporary, non-documented hack to be eliminated again when
1355    the general problem is solved.)
1356    
1357    ----------------------------------------------------------------------
1358    Name: Matthias Blume
1359    Date: 2000/11/17 14:10:00 JST
1360    Tag: blume-20001117-pickle-lib
1361    Description:
1362    
1363    1. Eliminated comp-lib.cm
1364    2. Made pickle-lib.cm
1365    3. Eliminated all uses of intset.sml (from comp-lib.cm)
1366    4. Replaced all uses of intmap.{sig,sml} (from comp-lib.cm) with
1367       equivalent constructs from smlnj-lib.cm (INtHashTable).
1368    5. Point 4. also goes for those uses of intmap.* in MLRISC.
1369       Duplicated intmap modules thrown out.
1370    6. Hunted down all duplicated SCC code and replaced it with
1371       equivalent stuff (GraphSCCFn from smlnj-lib.cm).
1372    7. Rewrote Feedback module.
1373    8. Moved sortedlist.sml into viscomp-lib.cm.  Eventually it
1374       should be thrown out and equivalent modules from smlnj-lib.cm
1375       should be used (IntRedBlackSet, IntListSet, ...).
1376    
1377    Confirmed that compiler compiles to fixpoint.
1378    
1379    ----------------------------------------------------------------------
1380    Name: Allen Leung
1381    Date: 2000/11/10 18:00:00
1382    Tag: leunga-20001110-new-x86-fp
1383    
1384    A new x86 floating point code generator has been added.
1385    By default this is turned off.  To turn this on, do:
1386    
1387        CM.autoload "$smlnj/compiler.cm";
1388        Compiler.Control.MLRISC.getFlag "x86-fast-fp" := true;
1389    
1390    Changes:
1391    
1392    1.  Changed FTAN to FPTAN so that the assembly output is correct.
1393    2.  Changed the extension callback for FTANGENT to generate:
1394    
1395              fptan
1396              fstp  %st(0)
1397        instead of
1398              fptan
1399              fstpl ftempmem
1400    
1401    3.  Numerous assembly fixes for x86.
1402    
1403    5.  Cleaned up the machine code output module x86/x86MC.sml and added
1404        support for a whole bunch of instructions and addressing modes:
1405    
1406          fadd/fsub/fsubr/fmul/fdiv/fdivr  %st, %st(n)
1407          faddp/fsubp/fsubrp/fmulp/fdivp/fdivrp  %st, %st(n)
1408          fadd/fsub/fsubr/fmul/fdiv/fdivr  %st(n), %st
1409          fiadd/fisub/fisubr/fimul/fidiv/fidivr mem
1410          fxch %st(n)
1411          fld %st(n)
1412          fst %st(n)
1413          fst mem
1414          fstp %st(n)
1415          fucom %st(n)
1416          fucomp %st(n)
1417    
1418        All these are now generated when the fast fp mode is turned on.
1419    
1420    6.  Removed the dedicated registers %st(0), ..., %st(7) from X86CpsRegs
1421    
1422    ----------------------------------------------------------------------
1423    Name: Matthias Blume
1424    Date: 2000/11/09 11:20:00 JST
1425    Tag: blume-20001109-scc
1426    Description:
1427    
1428    Eliminated some code duplication:
1429    
1430    1. Added "where" clause to GraphSCCFn in SML/NJ Library.
1431       (Otherwise the functor is useless.)
1432    2. Used GraphSCCFn where SCCUtilFun was used previously.
1433    3. Got rid of SCCUtilFun (in comp-lib.cm).
1434    
1435    ----------------------------------------------------------------------
1436    Name: Lal George
1437    Date: 2000/11/06 09:02:21 EST 2000
1438    Tag: Release_110_30
1439    Description:
1440    
1441    - Version 110.30
1442    ----------------------------------------------------------------------
1443    Name: Matthias Blume
1444    Date: 2000/11/04 14:45:00
1445    Tag: blume-20001104-mlbuild
1446    Description:
1447    
1448    - Made ml-build faster on startup.
1449    - Documentation fixes.
1450    
1451    ----------------------------------------------------------------------
1452    Name: Matthias Blume
1453    Date: 2000/11/02 17:00:00 JST
1454    Tag: blume-20001102-condcomp
1455    Description:
1456    
1457    - Small tweaks to pickler -- new BOOTFILES!
1458    - Version bumped to 110.29.2.
1459    - Added conditional compilation facility to init.cmi (see comment there).
1460    ----------------------------------------------------------------------
1461    Name: Allen Leung
1462    Date: 2000/10/23 19:31:00
1463    Tag: leunga-20001023-demo-ra
1464    
1465    1. Minor RA changes that improves spilling on x86 (affects Moby and C-- only)
1466    2. Test programs for the graph library updated
1467    3. Some new MLRISC demo programs added
1468    
1469    ----------------------------------------------------------------------
1470    Name: Matthias Blume
1471    Date: 2000/08/31 22:15:00 JST
1472    Tag: blume-20001017-errmsg
1473    Description:
1474    
1475    More error message grief: Where there used to be no messages, there
1476    now were some that had bogus error regions.  Fixed.
1477    
1478    ----------------------------------------------------------------------
1479    Name: Matthias Blume
1480    Date: 2000/08/31 17:30:00 JST
1481    Tag: blume-20001017-v110p29p1
1482    Description:
1483    
1484    I made a version 110.29.1 with new bootfiles.
1485    
1486    Changes:  Modified pickler/unpickler for faster and leaner unpickling.
1487              CM documentation changes and a small bugfix in CM's error reporting.
1488    
1489    ----------------------------------------------------------------------
1490    Name: Lal George
1491    Date: 2000/09/27 14:42:35 EDT
1492    Tag: george-20000927-nodestatus
1493    Description:
1494    
1495    Changed the type of the nodestatus, so that:
1496    
1497            SPILLED(~1)             is now SPILLED
1498            SPILLED(m) where m>=0   is now MEMREG(m)
1499            SPILLED(s) where s<~1   is now SPILL_LOC(~s)
1500    
1501    ----------------------------------------------------------------------
1502    Name: Matthias Blume
1503    Date: 2000/09/07 14:45:00 JST
1504    Tag: blume-20000907-cmerrmsg
1505    Description:
1506    
1507    Small tweak to CM to avoid getting ML syntax error messages twice.
1508    
1509    ----------------------------------------------------------------------
1510    Name: Matthias Blume
1511    Date: 2000/08/31 18:00:00 JST
1512    Tag: blume-20000831-cvsbootfiles
1513    Description:
1514    
1515    New URL for boot files (because the 110.29 files on the BL server do
1516    now work correctly with my updated install scripts for yacc and lex).
1517    
1518    ----------------------------------------------------------------------
1519    Name: Matthias Blume
1520    Date: 2000/08/08 12:33:00 JST
1521    Tag: blume-20000808-manual
1522    Description:
1523    
1524    Tiny update to CM manual.
1525    
1526    ----------------------------------------------------------------------
1527    Name: Allen Leung
1528    Date: 2000/08/7 19:31:00
1529    Tag: leunga-20000807-a-whole-bunch-of-stuff
1530    
1531      Moby, C--, SSA, x86, machine descriptions etc.  Should only affect C--
1532    and Mobdy.
1533    
1534    1.  x86
1535    
1536       a.  Fixes to peephole module by John and Dan.
1537       b.  Assembly fix to SETcc by Allen.
1538       c.  Fix to c-call by John.
1539       d.  Fix to spilling by John.  (This one deals with the missing FSTPT case)
1540       e.  Instruction selection optimization to SETcc as suggested by John.
1541    
1542           For example,
1543    
1544            MV(32, x, COND(32, CMP(32, LT, a, b), LI 1, LI 0))
1545    
1546           should generate:
1547    
1548            MOVL a, x
1549            SUBL b, x
1550            SHRL 31, x
1551    
1552    2.  IR stuff
1553    
1554         A bunch of new DJ-graph related algorithms added.  These
1555         speed up SSA construction.
1556    
1557    3.  SSA + Scheduling
1558    
1559         Added code for SSA and scheduling to the repository
1560    
1561    ----------------------------------------------------------------------
1562    Name: Lal George
1563    Date: 2000/07/27 11:53:14 EDT
1564    
1565    Tag: lal-20000727-linux-ppc
1566    Description:
1567    
1568     Made changes to support Linux PPC.
1569     p.s. I have confirmation that the 110.29 boot files work fine.
1570    
1571    ----------------------------------------------------------------------
1572    Name: Matthias Blume
1573    Date: 2000/07/27 17:40:00 JST
1574    Tag: blume-20000727-scripts
1575    Description:
1576    
1577    !!!! WARNING !!!!
1578    You must recompile the runtime system!
1579    !!!! WARNING !!!!
1580    
1581    This is basically another round of script-enhancements:
1582    
1583    1. sml, ml-build, and ml-makedepend accept options -D and -U to define
1584       and undefine CM preprocessor symbols.
1585    
1586    2. ml-build avoids generating a new heap image if it finds that the
1587       existing one is still ok.  (The condition is that no ML file had to
1588       be recompiled and all ML files are found to be older that the heap
1589       file.)
1590    
1591       To make this work smoothly, I also hacked the runtime system as
1592       well as SMLofNJ.SysInfo to get access to the heap image suffix
1593       (.sparc-solaris, ...) that is currently being used.
1594    
1595       Moreover, the signature of CM.mk_standalone has changed.  See the
1596       CM manual.
1597    
1598    3. ml-makedepend accepts additional options -n, -a, and -o.  (See the
1599       CM manual for details.)
1600    
1601    4. More CM manual updates:
1602        - all of the above has been documented.
1603        - there is now a section describing the (CM-related) command line
1604          arguments that are accepted by the "sml" command
1605    
1606    ----------------------------------------------------------------------
1607    Name: Matthias Blume
1608    Date: 2000/07/25 16:20:00 JST
1609    Tag: blume-20000725-makedepend
1610    Description:
1611    
1612    Added a script called ml-makedepend.  This can be used in makefiles
1613    for Unix' make in a way very similar to the "makedepend" command for
1614    C.
1615    
1616    The script internally uses function CM.sources.
1617    
1618    Synopsis:
1619    
1620        ml-makedepend [-f makefile] cmfile targetname
1621    
1622    The default for the makefile is "makefile" (or "Makefile" should
1623    "makefile" not exist).
1624    
1625    ml-makedepend adds a cmfile/targetname-specific section to this
1626    makefile (after removing the previous version of this section).  The
1627    section contains a single dependency specification with targetname on
1628    the LHS (targetname is an arbitrary name), and a list of files derived
1629    from the cmfile on the RHS.  Some of the files on the RHS are
1630    ARCH/OPSYS-specific.  Therefore, ml-makedepend inserts references to
1631    "make" variables $(ARCH) and $(OPSYS) in place of the corresponding
1632    path names.  The makefile writer is responsible for making sure that
1633    these variables have correct at the time "make" is invoked.
1634    
1635    ----------------------------------------------------------------------
1636    Name: Matthias Blume
1637    Date: 2000/07/22 23:30:00 JST
1638    Tag: blume-20000722-urlupdate
1639    Description:
1640    
1641    Changed BOOT and config/srcarchiveurl to point to BL server:
1642    
1643        ftp://ftp.research.bell-labs.com/dist/smlnj/working/110.29/
1644    
1645    ----------------------------------------------------------------------
1646    Name: Matthias Blume
1647    Date: 2000/07/18 18:00:00 JST
1648    Tag: blume-20000718-Version_110_29
1649    Description:
1650    
1651    1. Updated src/compiler/TopLevel/main/version.sml to version 110.29
1652    
1653    2. Updated config/version to 110.29
1654    
1655    3. Updated config/srcarchiveurl
1656    
1657    3. New boot files!
1658       ftp://ftp.cs.princeton.edu/pub/people/blume/sml/110.29-autofetch
1659    
1660    ----------------------------------------------------------------------
1661    Name: Matthias Blume
1662    Date: 2000/07/11 13:58:00 JST
1663    Tag: blume-20000711-doctypo
1664    Description:
1665    
1666    Fixed a few typos in CM manual.
1667    
1668    ----------------------------------------------------------------------
1669    Name: Allen Leung
1670    Date: 2000/06/15 00:38:00
1671    Tag: leunga-20000704-sparc-x86
1672    
1673    1. x86 peephole improvement sp += k; sp -= k => nop  [from John]
1674    2. fix to x86 RET bug [found by Dan Grossman]
1675    3. sparc assembly bug fix for ticc instructions [found by Fermin]
1676    
1677       Affects c-- and moby only
1678    
1679    ----------------------------------------------------------------------
1680    Name: Matthias Blume
1681    Date: 2000/07/04 15:26:00
1682    Tag: blume-20000704-trigger
1683    Description:
1684    
1685    1. Improvements to CM manual.
1686    2. SMLofNJ.Internals.BTrace.trigger reinstated as an alternative way
1687       of getting a back-trace.  The function, when called, raises an
1688       internal exception which explicitly carries the full back-trace history,
1689       so it is unaffected by any intervening handle-raise pairs ("trivial"
1690       or not).  The interactive loop will print that history once it arrives
1691       at top level.
1692       Short of having all exceptions implicitly carry the full history, the
1693       recommended way of using this facility is:
1694         - compile your program with instrumentation "on"
1695         - run it, when it raises an exception, look at the history
1696         - if the history is "cut off" because of some handler, go and modify
1697           your program so that it explicitly calls BTrace.trigger
1698         - recompile (still instrumented), and rerun; look at the full history
1699    
1700    ----------------------------------------------------------------------
1701    Name: Matthias Blume
1702    Date: 2000/07/03 15:36:00 JST
1703    Tag: blume-20000702-manual
1704    Description:
1705    
1706    Small corrections and updates to CM manual.
1707    
1708    ----------------------------------------------------------------------
1709    Name: Matthias Blume
1710    Date: 2000/06/29 16:04:00 JST
1711    Tag: blume-20000629-yacctool
1712    Description:
1713    
1714    Changes:
1715    
1716    1. Class "mlyacc" now takes separate arguments to pass options to
1717       generated .sml- and .sig-files independently.
1718    2. Corresponding CM manual updates.
1719    3. BTrace module now also reports call sites.  (However, for loop clusters
1720       it only shows from where the cluster was entered.)  There are associated
1721       modifications to core.sml, internals.{sig,sml}, btrace.sml, and btimp.sml.
1722    
1723    ----------------------------------------------------------------------
1724    Name: Matthias Blume
1725    Date: 2000/06/27 16:51:00 JST
1726    Tag: blume-20000627-noweb
1727    Description:
1728    
1729    Changes:
1730    
1731     1. Implemented "subdir" and "witness" options for noweb tool.
1732        This caused some slight internal changes in CM's tool implementation.
1733     2. Fixed bug in "tool plugin" mechanism.  This is essentially cleaning
1734        some remaining issues from earlier path anchor changes.
1735     3. Updated CM manual accordingly.
1736    
1737     4. Changed implementation of back-tracing so that I now consider it
1738        ready for prime-time.
1739    
1740        In particular, you don't have to explicitly trigger the back-trace
1741        anymore.  Instead, if you are running BTrace-instrumented code and
1742        there is an uncaught exception (regardless of whether or not it was
1743        raised in instrumented code), the top-level evalloop will print
1744        the back-trace.
1745    
1746        Features:
1747    
1748          - Instrumented and uninstrumented code work together seemlessly.
1749            (Of course, uninstrumented code is never mentioned in actual
1750             back-traces.)
1751    
1752          - Asymptotic time- and space-complexity of instrumented code is
1753            equal to that of uninstrumented code.  (This means that
1754            tail-recursion is preserved by the instrumentation phase.)
1755    
1756          - Modules whose code has been instrumented in different sessions
1757            work together without problem.
1758    
1759          - There is no penalty whatsoever on uninstrumented code.
1760    
1761          - There is no penalty on "raise" expressions, even in
1762            instrumented code.
1763    
1764        A potential bug (or perhaps it is a feature, too):
1765    
1766          A back-trace reaches no further than the outermost instrumented
1767          non-trivial "raise".  Here, a "trivial" raise is one that is the
1768          sole RHS of a "handle" rule.  Thus, back-traces reach trough
1769    
1770               <exp> handle e => raise e
1771    
1772          and even
1773    
1774               <exp> handle Foo => raise Bar
1775    
1776          and, of course, through
1777    
1778               <exp> handle Foo => ...
1779    
1780         if the exception was not Foo.
1781    
1782         Back-traces always reach right through any un-instrumented code
1783         including any of its "handle" expressions, trivial or not.
1784    
1785       To try this out, do the following:
1786    
1787         - Erase all existing binfiles for your program.
1788           (You may keep binfiles for those modules where you think you
1789            definitely don't need back-tracing.)
1790         - Turn on back-trace instrumentation:
1791              SMLofNJ.Internals.BTrace.mode (SOME true);
1792         - Recompile your program.  (I.e., run "CM.make" or "use".)
1793         - You may now turn instrumentation off again (if you want):
1794              SMLofNJ.Internals.BTrace.mode (SOME false);
1795         - Run your program as usual.  If it raises an exception that
1796           reaches the interactive toplevel, then a back-trace will
1797           automatically be printed.  After that, the toplevel loop
1798           will print the exception history as usual.
1799    
1800    ----------------------------------------------------------------------
1801    Name: Matthias Blume
1802    Date: 2000/06/26 09:56:46 JST
1803    Tag: blume-20000626-setup
1804    Description:
1805    
1806    CM: - setup-parameter to "sml" added; this can be used to run arbitrary
1807          ML code before and after compiling a file (e.g., to set compiler
1808          flags)
1809    
1810    Compiler: - improved btrace API (in core.sml, internals.{sig,sml})
1811              - associated changes to btrace.sml (BTrace instrumentation pass)
1812              - cleaner implementation of btimp.sml (BTrace tracing and report
1813                module)
1814    
1815    CM manual: * new path encoding documented
1816               * description of setup-parameter to "sml" added
1817    
1818    The biggest user-visible change to back-tracing is that it is no
1819    longer necessary to compile all traced modules within the same
1820    session.  (This was a real limitation.)
1821    
1822    ----------------------------------------------------------------------
1823    Name: Matthias Blume
1824    Date: 2000/06/24 12:40:00 JST
1825    Tag: blume-20000624-startup
1826    Description:
1827    
1828    Fixes startup slowdown problem.  (I was calling SrcPath.sync a _tad_
1829    bit too often -- to put it mildly. :)
1830    
1831    ----------------------------------------------------------------------
1832    Name: Matthias Blume
1833    Date: 2000/06/23 18:20:00 JST
1834    Tag: blume-20000623-btrace
1835    Description:
1836    
1837    This updates adds a backtrace facility to aid programmers in debugging
1838    their programs.  This involves the following changes:
1839    
1840    1. Module system/smlnj/init/core.sml (structure _Core) now has hooks for
1841       keeping track of the current call stack.  When programs are compiled
1842       in a special mode, the compiler will insert calls to these hooks
1843       into the user program.
1844       "Hook" means that it is possible for different implementations of
1845       back-tracing to register themselves (at different times).
1846    
1847    2. compiler/MiscUtil/profile/btrace.sml implements the annotation phase
1848       as an Absyn.dec->Absyn.dec rewrite.  Normally this phase is turned off.
1849       It can be turned on using this call:
1850         SMLofNJ.Internals.BTrace.mode (SOME true);
1851       Turning it off again:
1852         SMLofNJ.Internals.BTrace.mode (SOME false);
1853       Querying the current status:
1854         SMLofNJ.Internals.BTrace.mode NONE;
1855       Annotated programs are about twice as big as normal ones, and they
1856       run a factor of 2 to 4 slower with a dummy back-trace plugin (one
1857       where all hooks do nothing).  The slowdown with a plugin that is
1858       actually useful (such as the one supplied by default) is even greater,
1859       but in the case of the default plugin it is still only an constant
1860       factor (amortized).
1861    
1862    3. system/Basis/Implementation/NJ/internals.{sig,sml} have been augmented
1863       with a sub-structure BTrace for controlling back-tracing.  In particular,
1864       the above-mentioned function "mode" controls whether the annotation
1865       phase is invoked by the compiler.  Another important function is
1866       "trigger": when called it aborts the current execution and causes
1867       the top-level loop to print a full back-trace.
1868    
1869    4. compiler/MiscUtil/profile/btimp.sml is the current default plugin
1870       for back-tracing.  It keeps track of the dynamic call stack and in
1871       addition to that it keeps a partial history at each "level" of that
1872       stack.  For example, if a tail-calls b, b tail-calls c, and c tail-calls
1873       d and b (at separate times, dynamically), then the report will show:
1874    
1875       GOTO   d
1876             /c
1877       GOTO  \b
1878       CALL   a
1879    
1880       This shows that there was an initial non-tail call of a, then a
1881       tail-call to b or c, looping behavior in a cluster of functions that
1882       consist of b and c, and then a goto from that cluster (i.e., either from
1883       b or from c) to d.
1884    
1885       Note that (depending on the user program) the amount of information
1886       that the back-trace module has to keep track of at each level is bounded
1887       by a constant.  Thus, the whole implementation has the same asymptotical
1888       complexity as the original program (both in space and in time).
1889    
1890    5. compiler/TopLevel/interact/evalloop.sml has been modified to
1891       handle the special exception SMLofNJ.Internals.BTrace.BTrace
1892       which is raised by the "trigger" function mentioned above.
1893    
1894    Notes on usage:
1895    
1896    - Annotated code works well together with unannotated code:
1897    Unannotated calls simply do not show up at all in the backtrace.
1898    
1899    - It is not a good idea to let modules that were annotated during
1900    different sessions run at the same time.  This is because the compiler
1901    chooses small integers to identify individual functions, and there
1902    will be clashes if different modules were compiled in separate sessions.
1903    (Nothing will crash, and you will even be told about the clashes, but
1904    back-trace information will in general not be useful.)
1905    
1906    - Back-tracing can be confused by callcc and capture.
1907    
1908    - The only way of getting a back-trace right now is to explicitly
1909    invoke the "trigger" function from your user program.  Eventually, we
1910    should make every exception carry back-trace information (if
1911    available).  But since this creates more overhead at "raise"-time
1912    (similar to the current exnHistory overhead), I have not yet
1913    implemented this.  (The implementation will be rather easy.)  With
1914    exceptions carrying back-trace information, this facility will be even
1915    more useful because users don't need to modify their programs...
1916    
1917    - While it is possible to compile the compiler with back-trace
1918    annotations turned on (I did it to get some confidence in
1919    correctness), you must make absolutely sure that core.sml and
1920    btimp.sml are compiled WITHOUT annotation!  (core.sml cannot actually
1921    be compiled with annotation because there is no core access yet, but
1922    if you compile btimp.sml with annotation, then the system will go into
1923    an infinite recursion and crash.)
1924    Since CM currently does not know about BTrace, the only way to turn
1925    annotations on and off for different modules of the compiler is to
1926    interrupt CMB.make, change the settings, and re-invoke it.  Of course,
1927    this is awkward and clumsy.
1928    
1929    Sample sessions:
1930    
1931    Standard ML of New Jersey v110.28.1 [FLINT v1.5], June 5, 2000
1932    - SMLofNJ.Internals.BTrace.mode (SOME true);
1933    [autoloading]
1934    [autoloading done]
1935    val it = false : bool
1936    - structure X = struct
1937    -     fun main n = let
1938    -         fun a (x, 0) = d x
1939    -           | a (x, n) = b (x, n - 1)
1940    -         and b (x, n) = c (x, n)
1941    -         and c (x, n) = a (x, n)
1942    -         and d x = e (x, 3)
1943    -         and e (x, 0) = f x
1944    -           | e (x, n) = e (x, n - 1)
1945    -         and f 0 = SMLofNJ.Internals.BTrace.trigger ()
1946    -           | f n = n * g (n - 1)
1947    -         and g n = a (n, 3)
1948    -     in
1949    -         f n
1950    -     end
1951    - end;
1952    structure X : sig val main : int -> int end
1953    - X.main 3;
1954    *** BACK-TRACE ***
1955    GOTO   stdIn:4.2-13.20: X.main[2].f
1956    GOTO-( stdIn:4.2-13.20: X.main[2].e
1957    GOTO   stdIn:4.2-13.20: X.main[2].d
1958         / stdIn:4.2-13.20: X.main[2].a
1959         | stdIn:4.2-13.20: X.main[2].b
1960    GOTO-\ stdIn:4.2-13.20: X.main[2].c
1961    CALL   stdIn:4.2-13.20: X.main[2].g
1962    GOTO   stdIn:4.2-13.20: X.main[2].f
1963    GOTO-( stdIn:4.2-13.20: X.main[2].e
1964    GOTO   stdIn:4.2-13.20: X.main[2].d
1965         / stdIn:4.2-13.20: X.main[2].a
1966         | stdIn:4.2-13.20: X.main[2].b
1967    GOTO-\ stdIn:4.2-13.20: X.main[2].c
1968    CALL   stdIn:4.2-13.20: X.main[2].g
1969    GOTO   stdIn:4.2-13.20: X.main[2].f
1970    GOTO-( stdIn:4.2-13.20: X.main[2].e
1971    GOTO   stdIn:4.2-13.20: X.main[2].d
1972         / stdIn:4.2-13.20: X.main[2].a
1973         | stdIn:4.2-13.20: X.main[2].b
1974    GOTO-\ stdIn:4.2-13.20: X.main[2].c
1975    CALL   stdIn:4.2-13.20: X.main[2].g
1976    GOTO   stdIn:4.2-13.20: X.main[2].f
1977    CALL   stdIn:2.15-17.4: X.main[2]
1978    -
1979    
1980    (Note that because of a FLINt bug the above code currently does not
1981    compile without BTrace turned on.)
1982    
1983    Here is another example, using my modified Tiger compiler:
1984    
1985    Standard ML of New Jersey v110.28.1 [FLINT v1.5], June 5, 2000
1986    - SMLofNJ.Internals.BTrace.mode (SOME true);
1987    [autoloading]
1988    [autoloading done]
1989    val it = false : bool
1990    - CM.make "sources.cm";
1991    [autoloading]
1992    ...
1993    [autoloading done]
1994    [scanning sources.cm]
1995    [parsing (sources.cm):parse.sml]
1996    [creating directory CM/SKEL ...]
1997    [parsing (sources.cm):tiger.lex.sml]
1998    ...
1999    [wrote CM/sparc-unix/semant.sml]
2000    [compiling (sources.cm):main.sml]
2001    [wrote CM/sparc-unix/main.sml]
2002    [New bindings added.]
2003    val it = true : bool
2004    - Main.compile ("../testcases/merge.tig", "foo.out");
2005    *** BACK-TRACE ***
2006    CALL   lib/semant.sml:99.2-396.21: SemantFun[2].transExp.trvar
2007    CALL   lib/semant.sml:99.2-396.21: SemantFun[2].transExp.trexp
2008    CALL   lib/semant.sml:289.3-295.22: SemantFun[2].transExp.trexp.check[2]
2009    GOTO   lib/semant.sml:289.3-295.22: SemantFun[2].transExp.trexp.check[2]
2010    CALL   lib/semant.sml:99.2-396.21: SemantFun[2].transExp.trexp
2011    CALL   lib/semant.sml:99.2-396.21: SemantFun[2].transExp.trexp
2012    CALL   lib/semant.sml:488.3-505.6: SemantFun[2].transDec.trdec[2].transBody[2]
2013         / lib/semant.sml:411.65-543.8: SemantFun[2].transDec
2014    CALL-\ lib/semant.sml:413.2-540.9: SemantFun[2].transDec.trdec[2]
2015    CALL   lib/semant.sml:99.2-396.21: SemantFun[2].transExp.trexp
2016    CALL   lib/semant.sml:8.52-558.4: SemantFun[2].transProg[2]
2017    CALL   main.sml:1.18-118.4: Main.compile[2]
2018    -
2019    
2020    ----------------------------------------------------------------------
2021    Name: Matthias Blumen
2022    Date: 2000/06/21 18:00:00 JST
2023    Tag: blume-20000621-manual
2024    Description:
2025    
2026    CM manual update: Path environments documented.
2027    
2028    ----------------------------------------------------------------------
2029    Name: Matthias Blume
2030    Date: 2000/06/19 13:40:00
2031    Tag: blume-20000619-manual
2032    Description:
2033    
2034    CM manual and system/README update.  This only covers the fact that
2035    there are no more implicit anchors.  (Path environments and the "bind"
2036    option to "cm" have yet to be documented.)
2037    
2038    ----------------------------------------------------------------------
2039    Name: Matthias Blume
2040    Date: 2000/06/19 11:05:00 JST
2041    Tag: blume-20000619-chdir-bugfix
2042    Description:
2043    
2044    Fixed a bug in new SrcPath module that sometimes led to a bad chDir call.
2045    
2046    ----------------------------------------------------------------------
2047    Name: Matthias Blume
2048    Date: 2000/06/18 22:00:10 JST
2049    Tag: blume-20000618-implicit-anchors-really-gone
2050    Description:
2051    
2052    I updates the previous HISTORY entry where I forgot to mention that
2053    implicit anchors are no longer with us.
2054    
2055    The current update also gets rid of the (now useless) controller
2056    CM.Control.implicit_anchors.
2057    
2058    ----------------------------------------------------------------------
2059    Name: Matthias Blume
2060    Date: 2000/06/16 17:30:00 JST
2061    Tag: blume-20000616-anchorenv
2062    Description:
2063    
2064    This patch implements the long anticipated (just kidding :) "anchor
2065    environment" mechanism.  In the course of doing this, I also
2066    re-implemented CM's internal "SrcPath" module from scratch.  The new
2067    one should be more robust in certain boundary cases.  In any case, it
2068    is a lot cleaner than its predecessor (IMHO).
2069    
2070    This time, although there is yet another boot file format change, I
2071    kept the unpickler backward-compatible.  As a result, no new bootfiles
2072    are necessary and bootstrapping is straightforward.  (You cannot read
2073    new bootfiles into an old system, but the other way around is no
2074    problem.)
2075    
2076    Visible changes:
2077    
2078    ** 0. Implicit path anchors (without the leading $-symbol) are no
2079    longer recognized at all. This means that such path names are not
2080    illegal either.  For example, the name basis.cm simply refers to a
2081    local file called "basis.cm" (i.e, the name is an ordinary path
2082    relative to .cm-files directory).  Or, to put it differently, only
2083    names that start with $ are anchored paths.
2084    
2085    ** 1. The $<singlearc> abbreviation for $/<singlearc> has finally
2086    vanished.
2087    
2088    John (Reppy) had critizised this as soon as I originally proposed and
2089    implemented it, but at that time I did not really deeply believe
2090    him. :) Now I came full-circle because I need the $<singlearc> syntax
2091    in another place where it cannot be seen as an abbreviation for
2092    $/<singlearc>.  To avoid the confusion, $<singlearc> now means what it
2093    seems to mean (i.e., it "expands" into the corresponding anchor
2094    value).
2095    
2096    However, when paths are used as members in CM description files, it
2097    continues to be true that there must be at least another arc after the
2098    anchor.  This is now enforced separately during semantic analysis
2099    (i.e., from a lexical/syntactical point of view, the notation is ok.)
2100    
2101    ** 2. The "cm" class now accepts an option "bind".  The option's value
2102    is a sub-option list of precisely two items -- one labeled "anchor"
2103    and the other one labeled "value".  As you might expect, "anchor" is
2104    used to specify an anchor name to be bound, and "value" specifies what
2105    the anchor is being bound to.
2106    
2107    The value must be a directory name and can be given in either standard
2108    syntax (including the possibility that it is itself an anchored path)
2109    or native syntax.
2110    
2111    Examples:
2112    
2113       foo.cm (bind:(anchor:bar value:$mystuff/bar))
2114       lib.cm (bind:(anchor:a value:"H:\\x\\y\\z"))  (* only works under windows *)
2115    
2116    and so on.
2117    
2118    The meaning of this is that the .cm-file will be processed with an
2119    augmented anchor environment where the given anchor(s) is/are bound to
2120    the given values(s).
2121    
2122    The rationale for having this feature is this: Suppose you are trying
2123    to use two different (already stable) libraries a.cm and b.cm (that
2124    you perhaps didn't write yourself).  Further, suppose each of these
2125    two libraries internally uses its own auxiliary library $aux/lib.cm.
2126    Normally you would now have a problem because the anchor "lib" can not
2127    be bound to more than one value globally.  Therefore, the project that
2128    uses both a.cm and b.cm must locally redirect the anchor to some other
2129    place:
2130    
2131       a.cm (bind:(anchor:lib value:/usr/lib/smlnj/a-stuff))
2132       b.cm (bind:(anchor:lib value:/usr/lib/smlnj/b-stuff))
2133    
2134    This hard-wires $lib/aux.cm to /usr/lib/smlnj/a-stuff/aux.cm or
2135    /usr/lib/smlnj/b-stuff/aux.cm, respectively.
2136    
2137    Hard-wiring path names is a bit inflexible (and CM will verbosely warn
2138    you when you do so at the time of CM.stabilize).  Therefore, you can
2139    also use an anchored path as the value:
2140    
2141      a.cm (bind:(anchor:lib value:$a-lib))
2142      b.cm (bind:(anchor:lib value:$b-lib))
2143    
2144    Now you can globally configure (using the usual CM.Anchor.anchor or
2145    pathconfig machinery) bindings for "a-lib" and "b-lib".  Since "lib"
2146    itself is always locally bound, setting it globally is no longer
2147    meaningful or necessary (but it does not hurt either).  In fact, "lib"
2148    can still be used as a global anchor for separate purposes.  As a
2149    matter of fact, one can locally define "lib" in terms of a global
2150    "lib":
2151    
2152      a.cm (bind:(anchor:lib value:$lib/a))
2153      b.cm (bind:(anchor:lib value:$lib/b))
2154    
2155    ** 3: The encoding of path names has changed.  This affects the way
2156    path names are shown in CM's progress report and also the internal
2157    protocol encoding used for parallel make.
2158    
2159    The encoding now uses one or more ':'-separated segments.  Each
2160    segments corresponds to a file that has been specified relative to the
2161    file given by its preceding segment.  The first segment is either
2162    relative to the CWD, absolute, or anchored.  Each segment itself is
2163    basically a Unix pathname; all segments but the first are relative.
2164    
2165    Example:
2166    
2167       $foo/bar/baz.cm:a/b/c.sml
2168    
2169    This path denotes the file bar/a/b/c.sml relative to the directory
2170    denoted by anchor "foo".  Notice that the encoding also includes
2171    baz.cm which is the .cm-file that listed a/b/c.sml.  As usual, such
2172    paths are resolved relative to the .cm-files directory, so baz.cm must
2173    be ignored to get the "real" pathname.
2174    
2175    To make this fact more obvious, CM puts the names of such "virtual
2176    arcs" into parentheses when they appear in progress reports. (No
2177    parentheses will appear in the internal protocol encoding.)  Thus,
2178    what you really see is:
2179    
2180      $foo/bar/(baz.cm):a/b/c.sml
2181    
2182    I find this notation to be much more informative than before.
2183    
2184    Another new feature of the encoding is that special characters
2185    including parentheses, colons, (back)slashes, and white space are
2186    written as \ddd (where ddd is the decimal encoding of the character).
2187    
2188    *** The CM manual still needs to be updated.
2189    
2190    ----------------------------------------------------------------------
2191    Name: Allen Leung
2192    Date: 2000/06/15 00:38:00
2193    Tag: leunga-20000615-x86-peephole
2194    
2195    x86 Peephole fix by Fermin.  Affects c-- and moby only.
2196    
2197    ----------------------------------------------------------------------
2198    Name: Matthias Blume
2199    Date: 2000/06/12 11:40:00
2200    Tag: blume-20000612-parmakefix
2201    Description:
2202    
2203    More cleanup after changing the file naming scheme: This time I
2204    repaired the parallel make mechanism for CMB.make which I broke earlier.
2205    
2206    ----------------------------------------------------------------------
2207    Name: Allen Leung
2208    Date: 2000/06/09 01:25:00
2209    Tag: leunga-20000609-various
2210    
2211    None of these things should affect normal SML/NJ operations
2212    
2213    1. Peephole improvements provided by Fermin (c--)
2214    2. New annotation DEFUSE for adding extra dependence (moby)
2215    3. New X86 LOCK instructions (moby)
2216    4. New machine description language for reservation tables (scheduling)
2217    5. Fixes to various optimization/analysis modules (branch chaining, dominator
2218       trees etc.)
2219    6. I've changed the CM files so that they can work with versions
2220       110.0.6, 110.25 and 110.28
2221    
2222    ----------------------------------------------------------------------
2223    Name: Matthias Blume
2224    Date: 2000/06/09 12:40:00
2225    Tag: blume-20000609-log
2226    Description:
2227    
2228    - Removed all(?) remaining RCS Log entries from sources.
2229    
2230    - Fixed bug in ml-yacc and ml-lex sources (use explicit anchors for
2231      anchored paths).
2232    
2233    ----------------------------------------------------------------------
2234    Name: Matthias Blume
2235    Date: 2000/06/07 17:00:00 JST
2236    Tag: blume-20000607-no-implicit-anchors
2237    Description:
2238    
2239    1. This update changes the default setting for
2240    CM.Control.implicit_anchors from true to false.  This means that
2241    implicit anchors are no longer permitted by default.  I also tried to
2242    make sure that nothing else still relies on implicit anchors.
2243    (This is the next step on the schedule towards a CM that does not even
2244    have the notion of implicit anchors anymore.)
2245    
2246    2. More CM manual updates.
2247    
2248    3. I managed to track down and fix the pickling bug I mentioned last
2249    time.  Because of the previously existing workaround, this entails no
2250    immediate practical changes.
2251    
2252    ----------------------------------------------------------------------
2253    Name: Matthias Blume
2254    Date: 2000/06/06 11:15:00 JST
2255    Tag: blume-20000606-lazierpickle
2256    Description:
2257    
2258    !!!! NEW BOOT FILES !!!!
2259    
2260    * The main purpose of this update is to make library pickles lazier in
2261    order to reduce the initial space penalty for autoloading a library.
2262    As a result, it is now possible to have $smlnj/compiler.cm
2263    pre-registered.  This should take care of the many complaints or
2264    inquiries about missing structure Compiler.  This required changes to
2265    CM's internal data structures and small tweaks to some algorithms.
2266    
2267    As a neat additional effect, it is no longer necessary (for the sake
2268    of lean heap image files) to distinguish between a "minimal" CM and a
2269    "full" CM.  Now, there is only one CM (i.e., the "full" version:
2270    $smlnj/cm.cm aka $smlnj/cm/full.cm), and it is always available at the
2271    interactive top level. ($smlnj/cm/minimal.cm is gone.)
2272    
2273    To make the life of compiler-hackers easier, "makeml" now also
2274    pre-registers $smlnj/cmb.cm (aka $smlnj/cmb/current.cm).  In other
2275    words, after you bootstrap a new sml for the first time, you will not
2276    have to autoload $smlnj/cmb.cm again afterwards.  (The first time
2277    around you will still have to do it, though.)
2278    
2279    * A second change consists of major updates to the CM manual.  There
2280    are now several appendices with summary information and also a full
2281    specification of the CM description file syntax.
2282    
2283    * In directory src/system I added the script "allcross".  This script
2284    invokes sml and cross-compiles the compiler for all supported
2285    architectures.  (Useful when providing a new set of boot files.)
2286    
2287    * There seems to be a latent bug in my "lazy pickles" mechanism.  I
2288    added a small tweak to pickle-util.sml to work around this problem,
2289    but it is not a proper fix yet.  I will investigate further.  (The
2290    effect of the bug was an inflation of library pickle size.)
2291    
2292    * Version number increased to 110.28.1 (to avoid compatibility problems).
2293    
2294    ----------------------------------------------------------------------
2295    Name: Allen Leung
2296    Date: 2000/05/25 17:28 EDT
2297    Tag: leunga-20000525-ra
2298    Description:
2299    
2300      Fixed a bug in freezing phase of the register allocator.
2301    
2302    ----------------------------------------------------------------------
2303    Name: Allen Leung
2304    Date: 2000/05/15 22:53 EDT
2305    Tag: leunga-20000515-alpha-x86-ra
2306    Description:
2307    
2308      1. Alpha
2309    
2310          Slight cleanup.  Removed the instruction SGNXL
2311    
2312      2. X86
2313    
2314          Added the following instructions to the instruction set:
2315    
2316            ROLx, RORx,
2317            BTx, BTSx, BTLx, BTRx,
2318            XCHGx, and variants with the LOCK prefix
2319    
2320      3. Register Allocation
2321    
2322          The module ra-rewrite-with-renaming has been improved.
2323    
2324      These have no effect on SML/NJ.
2325    
2326    ----------------------------------------------------------------------
2327    Name: Matthias Blume
2328    Date: 2000/05/15 16:20:00 JST
2329    Tag: blume-20000515-lightrebuild
2330    Description:
2331    
2332    1. I added an alternative to "-rebuild" to "makeml".  The difference is
2333       that prior to calling CMB.make' the CM-variable "LIGHT" will be
2334       defined.  In effect, the command will not build any cross-compiler
2335       backends and therefore finish more quickly.
2336    
2337       The "fixpt" script also takes a "-light" switch to be able to use
2338       this new facility while compiling for a fixpoint.
2339    
2340    2. I replaced all mentions of anchored paths in group owner specifications
2341       with simple relative paths (usually starting with "..").
2342       The rationale is that a library's internal workings should not be
2343       compromised by the lack of some anchor.  (An anchor is necessary
2344       for someone who wants to refer to the library by an anchored path,
2345       but it should not be necessary to build the same library in the first
2346       place.)
2347    
2348    3. I changed the way CM's tool mechanism determines the shell command
2349       string used for things like ml-yacc etc. so that it does not break
2350       when CM.Control.implicit_anchors is turned off.
2351    
2352    ----------------------------------------------------------------------
2353    Name: Matthias Blume
2354    Date: 2000/05/12 18:20:00 JST
2355    Tag: blume-20000512-ml-build
2356    Description:
2357    
2358    Fixed a bug in config/_ml-build that prevented ml-yacc and ml-lex from
2359    getting installed properly (by config/install.sh).
2360    
2361    ----------------------------------------------------------------------
2362    Name: Matthias Blume
2363    Date: 2000/05/12 17:30:00 JST
2364    Tag: blume-20000512-anchors
2365    Description:
2366    
2367    !!! NEW BOOT FILES !!!
2368    
2369    This change is in preparation of fading out support for "implicitly
2370    anchored path names".  I went through all sources and used the
2371    explicit (and relatively new) $-notation.  See system/README and the
2372    CM manual for more info on this.
2373    
2374    I also modified the anchoring scheme for some things such as "smlnj",
2375    "MLRISC", "cm", etc. to take advantage of the fact that explicit
2376    anchors are more expressive: anchor name and first arc do not have to
2377    coincide.  This entails the following user-visible change:
2378    
2379    You have to write $smlnj/foo/bar instead of smlnj/foo/bar.  In
2380    particular, when you fire up sml with a command-line argument, say,
2381    e.g.:
2382    
2383       sml '$smlnj/cmb.cm'
2384    
2385    At the ML toplevel prompt:
2386    
2387       CM.autoload "$smlnj/cmb.cm";
2388    
2389    There is also a new controller in CM.Control that can be used to turn
2390    off all remaining support for implicit anchors by saying:
2391    
2392        CM.autoload "$smlnj/
2393        #set CM.Control.implicit_anchors false;
2394    
2395    This causes CM to reject implicitly anchored paths.  This is (for the
2396    time being) less permissive than the "final" version where there will
2397    be no more such implicit anchors and relative paths will be just that:
2398    relative.
2399    
2400    The next step (version after next version?) will be to make the
2401    default for CM.Control.implicit_anchors false.  After the dust has
2402    settled, I can then produce the "final" version of this...
2403    
2404    Note: Since bootstrapping is a bit tricky, I provided new boot files.
2405    
2406    ----------------------------------------------------------------------
2407    Name: Matthias Blume
2408    Date: 2000/05/11 16:30:00 JST
2409    Tag: blume-20000511-sources
2410    Description:
2411    
2412    The main change is that I added function CM.sources as a generalized
2413    version of the earlier CM.makedepend.  This entails the following
2414    additional changes:
2415    
2416      - CM.makedepend has been dropped.
2417    
2418      - CM manual has been updated.
2419    
2420      - TOOLS signature and API have been changed.
2421    
2422    ----------------------------------------------------------------------
2423    Name: Allen Leung
2424    Date: 2000/05/10 21:17 EDT
2425    Tag: leunga-20000510-moby-c--ssa
2426    Description:
2427    
2428      Various bug fixes and new features for C--, Moby and MLRISC optimizations.
2429    None of these affect SML/NJ.
2430    
2431    1. Register Allocation
2432    
2433        a. A new ra spilling module (ra/ra-spill-with-renaming) is implemented.
2434           This module tries to remove local (i.e. basic block level) redundancies
2435           during spilling.
2436    
2437        b. A new framework for performing region based register allocation.
2438           Not yet entirely functional.
2439    
2440    2. X86
2441    
2442       a. DefUse for POP was missing the stack pointer [found by Lal]
2443       b. Reload for CALL was incorrect in X86Spill [found by John]
2444       c. Various fixes in X86Spill so that it can be used correctly for
2445          the new spilling module.
2446    
2447    3. SSA/IR
2448    
2449       a. New module ir/dj-dataflow.sml implements elimination based
2450          data flow analysis.
2451    
2452    4. MLRiscGen
2453    
2454       a. Fix for gc type annotation
2455    
2456    5. MDGen
2457    
2458       Various fixes for machine description -> ml code translation.  For ssa
2459       only.
2460    
2461    ----------------------------------------------------------------------
2462    Name: Allen Leung
2463    Date: 2000/05/08 22:17 EDT
2464    Tag: leunga-20000508-labexp
2465    Description:
2466    
2467      Fermin has found a few assembly problems with constant expressions
2468      generated in LabelExp.  Mostly, the problems involve extra parentheses,
2469      which choke on dumb assemblers.  This is his fix.
2470    
2471    ----------------------------------------------------------------------
2472    Name: Dave MacQueen
2473    Date: 2000/04/09 14:00 EDT
2474    Tag: dbm-20000502-Version_110_28
2475    Description:
2476    
2477    1. Updated src/compiler/TopLevel/main/version.sml to version 110.28
2478    
2479    2. Updated config/version to 110.28
2480    
2481    3. Updated config/srcarchiveurl
2482    
2483    3. New boot files!
2484       ftp://ftp.research.bell-labs.com/dist/smlnj/working/110.28/
2485    
2486    ----------------------------------------------------------------------
2487    Name: Matthias Blume
2488    Date: 2000/05/01 19:05:00 JST
2489    Tag: blume-20000501-noweb
2490    Description:
2491    
2492    A new noweb tool has been added.  The existing system is entirely
2493    unaffected by this, but some CM users have asked for renewed noweb
2494    support.  Everything is documented in the CM manual.
2495    
2496    New (plugin) libraries:
2497    
2498       noweb-tool.cm
2499       nw-ext.cm
2500    
2501    ----------------------------------------------------------------------
2502    Name: Dave MacQueen
2503    Date: 2000/04/30 12:40PM EDT
2504    Tag: dbm-20000430-bug_fixes
2505    Description:
2506    
2507    1. Fix for bug 1498
2508       smlnj/src/system/Basis/Implementation/Unsafe/object.sig
2509       smlnj/src/system/Basis/Implementation/Unsafe/object.sml
2510         added toRealArray function
2511       smlnj/src/compiler/MiscUtil/print/ppobj.sml
2512         added check for tag Obj.RealArray to array printing case in ppObj
2513    
2514    2. Fix for bug 1510
2515       smlnj/src/compiler/Semant/types/typesutil.sml
2516         fixed definition of dummyargs (used by equalTycon) so that
2517         dummy args are distinct types
2518    
2519    ----------------------------------------------------------------------
2520    Name: Matthias Blume
2521    Date: 2000/04/30 01:00:00 JST
2522    Tag: blume-20000430-versions
2523    Description:
2524    
2525    1. CM version numbering added.  This is an implementation of Lal's
2526       proposal for adding version numbers and version checking to .cm
2527       files.  Lal said that his proposal was just that -- a proposal.
2528       For the time being I went ahead and implemented it so that people
2529       can comment on it.  Everything is completely backward-compatible
2530       (except for the stable library format, i.e., new bootfiles!).
2531    
2532       As usual, see the CM manual for details.
2533    
2534    2. An alternative syntax for anchored paths has been implemented.
2535       Dave has recently voiced the same concerns that I had when I did
2536       this, so there should be some support.  My take is that eventually
2537       I will let support for the current syntax (where anchors are
2538       "implicit") fade out in favor of the new, explicit syntax.
2539       In order to be backward-compatible, both old and new syntax are
2540       currently supported.
2541    
2542       Again, see the CM manual for details.
2543    
2544    3. Parallel make is trying to be slightly smarter:  When the master
2545       process finds a "bottleneck", i.e., when there is only one
2546       compilation unit that can be compiled and everybody else is
2547       waiting on it, then it will simply compile it directly instead
2548       of clumsily telling one of the slaves to do it.
2549    
2550    4. Support for "unsharing" added.  This is necessary in order to be
2551       able to have two different versions of the same library running
2552       at the same time (e.g., for trying out a new MLRISC while still
2553       having the old MLRISC linked into the current compiler, etc.)
2554       See the CM manual.
2555    
2556    5. Simple "makedepend" functionality added for generating Makefile
2557       dependency information.  (This is rather crude at the moment.
2558       Expect some changes here in the future.)
2559    
2560    6. ".fun" added as a recognized suffix for ML files. Also documented
2561       explicitly in the manual that the fallback behavior (unknown suffix
2562       -> ML file) is not an official feature!
2563    
2564    7. Small changes to the pickler for stable libraries.
2565    
2566    8. Several internal changes to CM (for cleanup/improvement).
2567    
2568    
2569    !!!! NEW BINFILES !!!!
2570    
2571    ----------------------------------------------------------------------
2572    Name: Matthias Blume
2573    Date: 2000/04/28 17:30:00 JST
2574    Tag: blume-20000428-pathconfig
2575    Description:
2576    
2577    1. I changed config/install.sh to remove duplicate entries from the
2578       lib/pathconfig file at the end.  Moreover, the final version of
2579       lib/pathconfig is sorted alphabetically.  The same (sorting) is done
2580       in src/system/installml.
2581    
2582    2. The config/install.sh script now consistently uses relative
2583       pathnames in lib/pathconfig whenever the anchor is in the lib
2584       directory.  (So far this was true for the libraries that come
2585       pre-compiled and bundled as part of the bootfiles but not for
2586       libraries that are compiled by the script itself.)
2587    
2588    ----------------------------------------------------------------------
2589    Name: Matthias Blume
2590    Date: 2000/04/26 13:10:00 JST
2591    Tag: blume-20000426-fun_suffix
2592    Description:
2593    
2594    Added ".fun" as a recognized file name suffix (for ML code).
2595    
2596    ----------------------------------------------------------------------
2597    Name: Allen Leung
2598    Date: 2000/04/25 17:00:00 EST
2599    Tag: leunga-20000425-alpha-ra
2600    Description:
2601    
2602    1. Alpha
2603    
2604        PSEUDOARITH was missing in AlphaRewrite.  This causes an endless loop
2605    in C--.
2606    
2607    2. RA
2608    
2609       Added a flag "ra-dump-size" to print out the size of the flowgraph
2610       and the interference graph.
2611    
2612    ----------------------------------------------------------------------
2613    Name: Dave MacQueen
2614    Date: 2000/04/25/
2615    Tag: dbm-20000425-mlyacc_doc_examples
2616    Description:
2617      Updated mlyacc.tex sections 5 and 7 for SML '97 and CM.
2618      Updated all three examples in src/ml-yacc/examples to run
2619      under 110.* using CM.make.
2620    
2621    ----------------------------------------------------------------------
2622    Name: Allen Leung
2623    Date: 2000/04/20 23:04:00 EST
2624    Tag: leunga-20000420-ssa-c---stuff
2625    Description:
2626    
2627      This update synchronizes my repository with Yale's.  Most of these
2628    changes, however, do not affect SML/NJ at all (the RA is an exception).
2629    
2630    1. Register Allocator
2631    
2632       a. An improvement in the interference graph construction:
2633          Given a copy
2634    
2635                s <- t
2636    
2637          no interference edge between s and t is added for this definition of s.
2638    
2639       b. I've added two new spill heuristic modules that Fermin and I developed
2640          (in the new library RA.cm). These are unused in SML/NJ but maybe
2641          useful for others (Moby?)
2642    
2643    2. X86
2644    
2645       a. Various fixes in the backend provided by Fermin [C--] and Lal.
2646    
2647    3. Alpha
2648    
2649       a. Added the BSR instruction and code generation that goes with it [C--]
2650       b. Other fixes too numerous to recount provided by Fermin [C--]
2651    
2652    4. Regmaps
2653    
2654       a. The regmaps are not initialized with the identity physical bindings
2655          at creation time.  This is unneeded.
2656    
2657    5. MLRISC Optimizations
2658    
2659       a. The DJ-Graph module can now compute the iterated dominance frontiers
2660          intersects with liveness incrementally in linear time! Woohoo!
2661          This is now used in my new SSA construction algorithm.
2662    
2663       b. THe branch reorganization module is now smarter about linear chains of
2664          basic blocks.
2665    
2666    
2667    ----------------------------------------------------------------------
2668    Name: Matthias Blume
2669    Date: 2000/04/12 13:52:00 JST
2670    Tag: blume_main_v110p27_1
2671    Description:
2672    
2673    Changed install.sh script to handle archive files without version number
2674    and to use "boot.<arch>-<os>" instead of "sml.boot.<arch>-<os>" for the
2675    name of the boot file archive.
2676    
2677    ----------------------------------------------------------------------
2678    Name: Dave MacQueen
2679    Date: 2000/04/09 14:00 EDT
2680    Tag: dbm-20000410-Version_110_27
2681    Description:
2682    
2683    1. Updated src/compiler/TopLevel/main/version.sml to version 110.27
2684    
2685    2. Updated src/config/version to 110.27
2686    
2687    3. New boot files!
2688    
2689    ----------------------------------------------------------------------
2690    Name: Allen Leung
2691    Date: 2000/04/09 19:09:00 EST
2692    Tag: leunga-20000409-misc
2693    Description:
2694    
2695    1.  Yet another fix for x86 assembly for idivl, imull, mull and friends.
2696    
2697    2.  Miscellaneous improvements to MLRISC (unused in sml/nj)
2698    
2699  ----------------------------------------------------------------------  ----------------------------------------------------------------------
2700  Name: Stefan  Name: Stefan
2701  Date: 2000/04/07 10:00:00 EDT  Date: 2000/04/07 10:00:00 EDT
# Line 97  Line 2782 
2782    
2783  3.  Assembly  3.  Assembly
2784    
2785      When generating assemby, resolve the value of client defined constants,      When generating assembly, resolve the value of client defined constants,
2786      instead of generating symbolic values.  This is controlled by the      instead of generating symbolic values.  This is controlled by the
2787      new flag "asm-resolve-constants", which is default to true.      new flag "asm-resolve-constants", which is default to true.
2788    
# Line 120  Line 2805 
2805    
2806  To this end, I arranged that instead of "structure Core" as "structure  To this end, I arranged that instead of "structure Core" as "structure
2807  _Core" is bound in the pervasive environment.  Core access is done via  _Core" is bound in the pervasive environment.  Core access is done via
2808  _Core (which can never be accidentially rebound because _Core is not a  _Core (which can never be accidentally rebound because _Core is not a
2809  legal surface-syntax symbol).  legal surface-syntax symbol).
2810    
2811  The current solution is much cleaner because the core environment is  The current solution is much cleaner because the core environment is
# Line 130  Line 2815 
2815  with dynamic and symbolic parts of the core environment.  with dynamic and symbolic parts of the core environment.
2816    
2817  Remaining hackery (to bind the "magic" symbol _Core) is localized in the  Remaining hackery (to bind the "magic" symbol _Core) is localized in the
2818  compilation mananger's bootstrap compiler (actually: in the "init group"  compilation manager's bootstrap compiler (actually: in the "init group"
2819  handling).  See the comments in src/system/smlnj/init/init.cmi for  handling).  See the comments in src/system/smlnj/init/init.cmi for
2820  more details.  more details.
2821    
# Line 245  Line 2930 
2930     (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
2931     used).     used).
2932    
2933     This was done to accomodate the new "make" and "shell" tools which     This was done to accommodate the new "make" and "shell" tools which
2934     facilitate fairly seemless hookup to portions of code managed using     facilitate fairly seamless hookup to portions of code managed using
2935     Makefiles or Shell scripts.     Makefiles or Shell scripts.
2936    
2937     There are no classes "shared" or "private" anymore.  Instead, the     There are no classes "shared" or "private" anymore.  Instead, the
# Line 258  Line 2943 
2943    
2944     All existing tools are described in the CM manual.     All existing tools are described in the CM manual.
2945    
2946     - Slightly better error handling.  (CM now surpresses many followup     - Slightly better error handling.  (CM now suppresses many followup
2947     error messages that tended to be more annoying than helpful.)     error messages that tended to be more annoying than helpful.)
2948    
2949  2. Major changes to the compiler's static environment data structures.  2. Major changes to the compiler's static environment data structures.
# Line 289  Line 2974 
2974       elaborator). There were a lot of changes during my "linkpath" trials       elaborator). There were a lot of changes during my "linkpath" trials
2975       that could have been reverted to their original state but weren't.       that could have been reverted to their original state but weren't.
2976       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
2977       than what was strictly necessary...  (I _did_ resist the tempation       than what was strictly necessary...  (I _did_ resist the temptation
2978       of doing any "global reformatting" to avoid an untimely death at       of doing any "global reformatting" to avoid an untimely death at
2979       Dave's hands. :)       Dave's hands. :)
2980    
# Line 392  Line 3077 
3077    
3078       I've changed andl to testl in the floating point test sequence       I've changed andl to testl in the floating point test sequence
3079       whenever appropriate.  The Intel optimization guide states that       whenever appropriate.  The Intel optimization guide states that
3080       testl is perferable to andl.       testl is preferable to andl.
3081    
3082  7. RA (x86 only)  7. RA (x86 only)
3083    
# Line 574  Line 3259 
3259    
3260  1. Tools.registerStdShellCmdTool (from smlnj/cm/tool.cm) takes an  1. Tools.registerStdShellCmdTool (from smlnj/cm/tool.cm) takes an
3261  additional argument called "template" which is an optional string that  additional argument called "template" which is an optional string that
3262  specifiel the layout of the tool command line.  See the CM manual for  specifies the layout of the tool command line.  See the CM manual for
3263  explanation.  explanation.
3264    
3265  2. A special-purpose tool can be "regisitered" by simply dropping the  2. A special-purpose tool can be "registered" by simply dropping the
3266  corresponding <...>-tool.cm (and/or <...>-ext.cm) into the same  corresponding <...>-tool.cm (and/or <...>-ext.cm) into the same
3267  directory where the .cm file lives that uses this tool.  (The  directory where the .cm file lives that uses this tool.  (The
3268  behavior/misfeature until now was to look for the tool description  behavior/misfeature until now was to look for the tool description
# Line 621  Line 3306 
3306  rebuild.  Having sets of the form <base><k>.{bin,boot}.<arch>-unix for  rebuild.  Having sets of the form <base><k>.{bin,boot}.<arch>-unix for
3307  <k>=1,2,... is normally not a good idea when invoking fixpt.  However,  <k>=1,2,... is normally not a good idea when invoking fixpt.  However,
3308  they might be the result of an earlier partial run of fixpt (which  they might be the result of an earlier partial run of fixpt (which
3309  perhaps got accidentially killed).  In this case, fixpt will quickly  perhaps got accidentally killed).  In this case, fixpt will quickly
3310  move through what exists before continuing where it left off earlier,  move through what exists before continuing where it left off earlier,
3311  and, thus, saves a lot of time.  and, thus, saves a lot of time.
3312    
# Line 671  Line 3356 
3356    it from that remote directory.    it from that remote directory.
3357    This should simplify installation further:  For machines that have    This should simplify installation further:  For machines that have
3358    access to the internet, just fetch <version>-config.tgz, unpack it,    access to the internet, just fetch <version>-config.tgz, unpack it,
3359    edit config/targets, and go (run config/install.sh).  The scipt will    edit config/targets, and go (run config/install.sh).  The script will
3360    fetch everything else that it might need all by itself.    fetch everything else that it might need all by itself.
3361    
3362    For CVS users, this mechanism is not relevant for source archives, but    For CVS users, this mechanism is not relevant for source archives, but

Legend:
Removed from v.605  
changed lines
  Added in v.928

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