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

Legend:
Removed from v.660  
changed lines
  Added in v.1030

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