Home My Page Projects Code Snippets Project Openings SML/NJ
Summary Activity Forums Tracker Lists Tasks Docs Surveys News SCM Files

SCM Repository

[smlnj] Diff of /sml/trunk/HISTORY
ViewVC logotype

Diff of /sml/trunk/HISTORY

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

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

Legend:
Removed from v.646  
changed lines
  Added in v.1065

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