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

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