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

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