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

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