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

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