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

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