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 814, Tue May 1 15:44:45 2001 UTC revision 1189, Fri May 10 20:40:33 2002 UTC
# Line 8  Line 8 
8  The form of an entry should be:  The form of an entry should be:
9    
10  Name:  Name:
11  Date:  Date: yyyy/mm/dd
12  Tag: <post-commit CVS tag>  Tag: <post-commit CVS tag>
13  Description:  Description:
14    
15  ----------------------------------------------------------------------  ----------------------------------------------------------------------
16  Name: Matthias Blume  Name: Matthias Blume
17    Date: 2002/05/10 16:40:00 EDT
18    Tag: blume-20020510-erg-textio
19    Description:
20    
21    Applied the following bugfix provided by Emden Gansner:
22    
23        Output is corrupted when outputSubstr is used rather than output.
24    
25        The problem occurs when a substring
26    
27            ss = (s, dataStart, dataLen)
28    
29        where dataStart > 0, fills a stream buffer with avail bytes left.
30        avail bytes of s, starting at index dataStart, are copied into the
31        buffer, the buffer is flushed, and then the remaining dataLen-avail
32        bytes of ss are copied into the beginning of the buffer. Instead of
33        starting this copy at index dataStart+avail in s, the current code
34        starts the copy at index avail.
35    
36        Fix:
37        In text-io-fn.sml, change line 695 from
38             val needsFlush = copyVec(v, avail, dataLen-avail, buf, 0)
39        to
40             val needsFlush = copyVec(v, dataStart+avail, dataLen-avail, buf, 0)
41    
42    ----------------------------------------------------------------------
43    Name: Matthias Blume
44    Date: 2002/04/12 13:55:00 EDT
45    Tag: blume-20020412-assyntax
46    Description:
47    
48    1. Grabbed newer assyntax.h from the XFree86 project.
49    2. Fiddled with how to compile X86.prim.asm without warnings.
50    3. (Very) Minor cleanup in CM.
51    
52    ----------------------------------------------------------------------
53    Name: Matthias Blume
54    Date: 2002/04/01 (no joke!) 17:07:00 EST
55    Tag: blume-20020401-x86div
56    Description:
57    
58    Added full support for div/mod/rem/quot on the x86, using the machine
59    instruction's two results (without clumsily recomputing the remainder)
60    directly where appropriate.
61    
62    Some more extensive power-of-two support was added to the x86 instruction
63    selector (avoiding expensive divs, mods, and muls where they can be
64    replaced with cheaper shifts and masks).  However, this sort of thing
65    ought to be done earlier, e.g., within the CPS optimizer so that
66    all architectures benefit from it.
67    
68    The compiler compiles to a fixed point, but changes might be somewhat
69    fragile nevertheless.  Please, report any strange things that you might
70    see wrt. div/mod/quot/rem...
71    
72    ----------------------------------------------------------------------
73    Name: Matthias Blume
74    Date: 2002/03/29 17:22:00
75    Tag: blume-20020329-div
76    Description:
77    
78    Fixed my broken div/mod logic.  Unfortunately, this means that the
79    inline code for div/mod now has one more comparison than before.
80    Fast paths (quotient > 0 or remainder = 0) are not affected, though.
81    The problem was with quotient = 0, because that alone does not tell
82    us which way the rounding went.  One then has to look at whether
83    remainder and divisor have the same sign...  :(
84    
85    Anyway, I replaced the bootfiles with fresh ones...
86    
87    ----------------------------------------------------------------------
88    Name: Matthias Blume
89    Date: 2002/03/29 14:10:00 EST
90    Tag: blume-20020329-inlprims
91    Description:
92    
93    NEW BOOTFILES!!!    Version number bumped to 110.39.3.
94    
95    Primops have changed. This means that the bin/boot-file formats have
96    changed as well.
97    
98    To make sure that there is no confusion, I made a new version.
99    
100    
101    CHANGES:
102    
103    * removed REMT from mltree (remainder should never overflow).
104    
105    * added primops to deal with divisions of all flavors to the frontend
106    
107    * handled these primops all the way through so they map to their respective
108      MLRISC support
109    
110    * used these primops in the implementation of Int, Int32, Word, Word32
111    
112    * removed INLDIV, INLMOD, and INLREM as they are no longer necessary
113    
114    * parameterized INLMIN, INLMAX, and INLABS by a numkind
115    
116    * translate.sml now deals with all flavors of INL{MIN,MAX,ABS}, including
117      floating point
118    
119    * used INL{MIN,MAX,ABS} in the implementation of Int, Int32, Word, Word32,
120      and Real (but Real.abs maps to a separate floating-point-only primop)
121    
122    
123    TODO items:
124    
125    * Hacked Alpha32 instruction selection, disabling the selection of REMx
126      instructions because the machine instruction encoder cannot handle
127      them.  (Hppa, PPC, and Sparc instruction selection did not handle
128      REM in the first place, and REM is supported by the x86 machine coder.)
129    
130    * Handle DIV and MOD with DIV_TO_NEGINF directly in the x86 instruction
131      selection phase.  (The two can be streamlined because the hardware
132      delivers both quotient and remainder at the same time anyway.)
133    
134    * Think about what to do with "valOf(Int32.minInt) div ~1" and friends.
135      (Currently the behavior is inconsistent both across architectures and
136      wrt. the draft Basis spec.)
137    
138    * Word8 should eventually be handled natively, too.
139    
140    * There seems to be one serious bug in mltree-gen.sml.  It appears, though,
141      as if there currently is no execution path that could trigger it in
142      SML/NJ.  (The assumptions underlying functions arith and promotable do not
143      hold for things like multiplication and division.)
144    
145    ----------------------------------------------------------------------
146    Name: Matthias Blume
147    Date: 2002/03/27 16:27:00 EST
148    Tag: blume-20020327-mlrisc-divisions
149    Description:
150    
151    Added support for all four division operations (ML's div, mod, quot,
152    and rem) to MLRISC.  In the course of doing so, I also rationalized
153    the naming (no more annoying switch-around of DIV and QUOT), by
154    parameterizing the operation by div_rounding_mode (which can be either
155    DIV_TO_ZERO or DIV_TO_NEGINF).
156    
157    The generic MLTreeGen functor takes care of compiling all four
158    operations down to only round-to-zero div.
159    
160    Missing pieces:
161    
162      * Doing something smarter than relying on MLTreeGen on architectures
163        like, e.g., the x86 where hardware division delivers both quotient and
164        remainder at the same time.  With this, the implementation of the
165        round-to-neginf operations could be further streamlined.
166    
167      * Remove inlining support for div/mod/rem from the frontend and replace it
168        with primops that get carried through to the backend.  Do this for all
169        int and word types.
170    
171    ----------------------------------------------------------------------
172    Name: Matthias Blume
173    Date: 2002/03/25 17:25:00 EST
174    Tag: blume-20020325-divmod
175    Description:
176    
177    I improved (hopefully without breaking them) the implementation of Int.div,
178    Int.mod, and Int.rem.   For this, the code in translate.sml now takes
179    advantage of the following observations:
180    
181      Let  q = x quot y      r = x rem y
182           d = x div  y      m = x mod y
183    
184    where "quot" is the round-to-zero version of integer division that
185    hardware usually provides.  Then we have:
186    
187         r = x - q * y        where neither the * nor the - will overflow
188         d = if q >= 0 orelse x = q * y then q else q - 1
189                              where neither the * nor the - will overflow
190         m = if q >= 0 orelse r = 0 then r else r + y
191                              where the + will not overflow
192    
193    This results in substantial simplification of the generated code.
194    The following table shows the number of CFG nodes and edges generated
195    for
196            fun f (x, y) = x OPER y
197            (* with OPER \in div, mod, quot, rem *)
198    
199    
200        OPER | nodes(old) | edges(old) | nodes(new) | edges(new)
201        --------------------------------------------------------
202         div |         24 |         39 |         12 |         16
203         mod |         41 |         71 |         12 |         16
204        quot |          8 |         10 |          8 |         10
205         rem |         10 |         14 |          8 |         10
206    
207    
208    ----------------------------------------------------------------------
209    Name: Matthias Blume
210    Date: 2002/03/25 22:06:00 EST
211    Tag: blume-20020325-cprotobug
212    Description:
213    
214    Fixed a bug in cproto (c prototype decoder).
215    
216    ----------------------------------------------------------------------
217    Name: Matthias Blume
218    Date: 2002/03/25 16:00:00 EST
219    Tag: blume-20020325-raw-primops
220    Description:
221    
222    I did some cleanup to Allen's new primop code and
223    replaced yesterday's bootfiles with new ones.
224    (But they are stored in the same place.)
225    
226    ----------------------------------------------------------------------
227    Name: Matthias Blume
228    Date: 2002/03/24 22:40:00 EST
229    Tag: blume-20020324-bootfiles
230    Description:
231    
232    Made the bootfiles that Allen asked for.
233    
234    ----------------------------------------------------------------------
235    Name: Allen Leung
236    Date: 2002/03/23 15:50:00 EST
237    Tag: leunga-20020323-flint-cps-rcc-primops
238    Description:
239    
240      1. Changes to FLINT primops:
241    
242        (* make a call to a C-function;
243         * The primop carries C function prototype information and specifies
244         * which of its (ML-) arguments are floating point. C prototype
245         * information is for use by the backend, ML information is for
246         * use by the CPS converter. *)
247      | RAW_CCALL of { c_proto: CTypes.c_proto,
248                       ml_args: ccall_type list,
249                       ml_res_opt: ccall_type option,
250                       reentrant : bool
251                     } option
252       (* Allocate uninitialized storage on the heap.
253        * The record is meant to hold short-lived C objects, i.e., they
254        * are not ML pointers.  With the tag, the representation is
255        * the same as RECORD with tag tag_raw32 (sz=4), or tag_fblock (sz=8)
256        *)
257      | RAW_RECORD of {tag:bool,sz:int}
258      and ccall_type = CCALL_INT32 | CCALL_REAL64 | CCALL_ML_PTR
259    
260      2.  These CPS primops are now overloaded:
261    
262           rawload of {kind:numkind}
263           rawstore of {kind:numkind}
264    
265          The one argument form is:
266    
267             rawload {kind} address
268    
269          The two argument form is:
270    
271             rawload {kind} [ml object, byte-offset]
272    
273      3. RAW_CCALL/RCC now takes two extra arguments:
274    
275         a. The first is whether the C call is reentrant, i.e., whether
276            ML state should be saved and restored.
277         b. The second argument is a string argument specifying the name of
278            library and the C function.
279    
280         These things are currently not handled in the code generator, yet.
281    
282      4. In CProto,
283    
284         An encoding type of "bool" means "ml object" and is mapped into
285         C prototype of PTR.  Note that "bool" is different than "string",
286         even though "string" is also mapped into PTR, because "bool"
287         is assigned an CPS type of BOGt, while "string" is assigned INT32t.
288    
289      5. Pickler/unpicker
290    
291         Changed to handle RAW_RECORD and newest RAW_CCALL
292    
293      6. MLRiscGen,
294    
295         1. Changed to handle the new rawload/rawstore/rawrecord operators.
296         2. Code for handling C Calls has been moved to a new module CPSCCalls,
297            in the file CodeGen/cpscompile/cps-c-calls.sml
298    
299      7. Added the conditional move operator
300    
301             condmove of branch
302    
303         to cps.  Generation of this is still buggy so it is currently
304         disabled.
305    
306    ----------------------------------------------------------------------
307    Name: Lal George
308    Date: 2002/03/22 14:18:25 EST
309    Tag: george-20020322-cps-branch-prob
310    Description:
311    
312    Implemented the Ball-Larus branch prediction-heuristics, and
313    incorporated graphical viewers for control flow graphs.
314    
315    Ball-Larus Heuristics:
316    ---------------------
317    See the file compiler/CodeGen/cpscompile/cpsBranchProb.sml.
318    
319    By design it uses the Dempster-Shafer theory for combining
320    probabilities.  For example, in the function:
321    
322        fun f(n,acc) = if n = 0 then acc else f(n-1, n*acc)
323    
324    the ball-larus heuristics predicts that the n=0 is unlikely
325    (OH-heuristic), and the 'then' branch is unlikely because of the
326    RH-heuristic -- giving the 'then' branch an even lower combined
327    probability using the Dempster-Shafer theory.
328    
329    Finally, John Reppy's loop analysis in MLRISC, further lowers the
330    probability of the 'then' branch because of the loop in the else
331    branch.
332    
333    
334    Graphical Viewing:
335    ------------------
336    I merely plugged in Allen's graphical viewers into the compiler. The
337    additional code is not much. At the top level, saying:
338    
339            Control.MLRISC.getFlag "cfg-graphical-view" := true;
340    
341    will display the graphical view of the control flow graph just before
342    back-patching.  daVinci must be in your path for this to work. If
343    daVinci is not available, then the default viewer can be changed
344    using:
345    
346            Control.MLRISC.getString "viewer"
347    
348    which can be set to "dot" or "vcg" for the corresponding viewers. Of
349    course, these viewers must be in your path.
350    
351    The above will display the compilation unit at the level of clusters,
352    many of which are small, boring, and un-interesting. Also setting:
353    
354            Control.MLRISC.getInt "cfg-graphical-view_size"
355    
356    will display clusters that are larger than the value set by the above.
357    
358    
359    ----------------------------------------------------------------------
360    Name: Matthias Blume
361    Date: 2002/03/21 22:20:00 EST
362    Tag: blume-20020321-kmp-bugfix
363    Description:
364    
365    Changed the interface to the KMP routine in PreString and fixed
366    a minor bug in one place where it was used.
367    
368    ----------------------------------------------------------------------
369    Name: Allen Leung
370    Date: 2002/03/21 20:30:00 EST
371    Tag: leunga-20020321-cfg
372    Description:
373    
374      Fixed a potential problem in cfg edge splitting.
375    
376    ----------------------------------------------------------------------
377    Name: Allen Leung
378    Date: 2002/03/21 17:15:00 EST
379    Tag: leunga-20020321-x86-fp-cfg
380    Description:
381    
382      1. Recoded the buggy parts of x86-fp.
383    
384         a. All the block reordering code has been removed.
385            We now depend on the block placement phases to do this work.
386    
387         b. Critical edge splitting code has been simplified and moved into the
388            CFG modules, as where they belong.
389    
390         Both of these were quite buggy and complex.  The code is now much, much
391         simpler.
392    
393      2. X86 backend.
394    
395         a. Added instructions for 64-bit support.  Instruction selection for
396            64-bit has not been committed, however, since that
397            requires changes to MLTREE which haven't been approved by
398            Lal and John.
399    
400         b. Added support for FUCOMI and FUCOMIP when generating code for
401            PentiumPro and above.  We only generate these instructions in
402            the fast-fp mode.
403    
404         c. Added cases for JP and JNP in X86FreqProps.
405    
406      3. CFG
407    
408         CFG now has a bunch of methods for edge splitting and merging.
409    
410      4. Machine description.
411    
412         John's simplification of MLTREE_BASIS.fcond broke a few machine
413         description things:
414    
415         rtl-build.{sig,sml} and hppa.mdl fixed.
416    
417         NOTE: the machine description stuff in the repository is still broken.
418               Again, I can't put my fixes in because that involves
419               changes to MLTREE.
420    
421    ----------------------------------------------------------------------
422    Name: Matthias Blume
423    Date: 2002/03/20 15:55:00 EST
424    Tag: blume-20020320-kmp
425    Description:
426    
427    Implemented Knuth-Morris-Pratt string matching in PreString and used
428    it for String.isSubstring, Substring.isSubstring, and
429    Substring.position.
430    
431    (Might need some stress-testing.  Simple examples worked fine.)
432    
433    ----------------------------------------------------------------------
434    Name: Matthias Blume
435    Date: 2002/03/19 16:37:00 EST
436    Tag: blume-20020319-witnesses
437    Description:
438    
439    Added a structure C.W and functions convert/Ptr.convert to ml-nlffi-lib.
440    
441    This implements a generic mechanism for changing constness qualifiers
442    anywhere within big C types without resorting to outright "casts".
443    (So far, functions such as C.rw/C.ro or C.Ptr.rw/C.Ptr.ro only let you
444    modify the constness at the outermost level.)
445    The implementation of "convert" is based on the idea of "witness"
446    values -- values that are not used by the operation but whose types
447    "testify" to their applicability.  On the implementation side, "convert"
448    is simply a projection (returning its second curried argument).  With
449    cross-module inlining, it should not result in any machine code being
450    generated.
451    
452    ----------------------------------------------------------------------
453    Name: Matthias Blume
454    Date: 2002/03/15 16:40:00 EST
455    Tag: blume-20020315-basis
456    Description:
457    
458    Provided (preliminary?) implementations for
459    
460      {String,Substring}.{concatWith,isSuffix,isSubstring}
461    
462    and
463    
464      Substring.full
465    
466    Those are in the Basis spec but they were missing in SML/NJ.
467    
468    ----------------------------------------------------------------------
469    Name: Matthias Blume
470    Date: 2002/03/14 21:30:00 EST
471    Tag: blume-20020314-controls
472    Description:
473    
474    Controls:
475    ---------
476    
477    1. Factored out the recently-added Controls : CONTROLS stuff and put
478       it into its own library $/controls-lib.cm.  The source tree for
479       this is under src/smlnj-lib/Controls.
480    
481    2. Changed the names of types and functions in this interface, so they
482       make a bit more "sense":
483    
484          module -> registry
485          'a registry -> 'a group
486    
487    3. The interface now deals in ref cells only.  The getter/setter interface
488       is (mostly) gone.
489    
490    4. Added a function that lets one register an already-existing ref cell.
491    
492    5. Made the corresponding modifications to the rest of the code so that
493       everything compiles again.
494    
495    6. Changed the implementation of Controls.MLRISC back to something closer
496       to the original.  In particular, this module (and therefore MLRISC)
497       does not depend on Controls.  There now is some link-time code in
498       int-sys.sml that registers the MLRISC controls with the Controls
499       module.
500    
501    CM:
502    ---
503    
504      * One can now specify the lambda-split aggressiveness in init.cmi.
505    
506    ----------------------------------------------------------------------
507    Name: Allen Leung
508    Date: 2002/03/13 17:30:00 EST
509    Tag: leunga-20020313-x86-fp-unary
510    Description:
511    
512    Bug fix for:
513    
514    > leunga@weaselbane:~/Yale/tmp/sml-dist{21} bin/sml
515    > Standard ML of New Jersey v110.39.1 [FLINT v1.5], March 08, 2002
516    > - fun f(x,(y,z)) = Real.~ y;
517    > [autoloading]
518    > [autoloading done]
519    >       fchsl   (%eax), 184(%esp)
520    > Error: MLRisc bug: X86MCEmitter.emitInstr
521    >
522    > uncaught exception Error
523    >   raised at: ../MLRISC/control/mlriscErrormsg.sml:16.14-16.19
524    
525    The problem was that the code generator did not generate any fp registers
526    in this case, and the ra didn't know that it needed to run the X86FP phase to
527    translate the pseudo fp instruction.   This only happened with unary fp
528    operators in certain situations.
529    
530    ----------------------------------------------------------------------
531    Name: Matthias Blume
532    Date: 2002/03/13 14:00:00 EST
533    Tag: blume-20020313-overload-etc
534    Description:
535    
536    1. Added _overload as a synonym for overload for backward compatibility.
537       (Control.overloadKW must be true for either version to be accepted.)
538    
539    2. Fixed bug in install script that caused more things to be installed
540       than what was requested in config/targets.
541    
542    3. Made CM aware of the (_)overload construct so that autoloading
543       works.
544    
545    ----------------------------------------------------------------------
546    Name: Matthias Blume
547    Date: 2002/03/12 22:03:00 EST
548    Tag: blume-20020312-url
549    Description:
550    
551    Forgot to update BOOT and srcarchiveurl.
552    
553    ----------------------------------------------------------------------
554    Name: Matthias Blume
555    Date: 2002/03/12 17:30:00 EST
556    Tag: blume-20020312-version110392
557    Description:
558    
559    Yet another version number bump (because of small changes to the
560    binfile format).  Version number is now 110.39.2.  NEW BOOTFILES!
561    
562    Changes:
563    
564      The new pid generation scheme described a few weeks ago was overly
565      complicated.  I implemented a new mechanism that is simpler and
566      provides a bit more "stability":  Once CM has seen a compilation
567      unit, it keeps its identity constant (as long as you do not delete
568      those crucial CM/GUID/* files).  This means that when you change
569      an interface, compile, then go back to the old interface, and
570      compile again, you arrive at the original pid.
571    
572      There now also is a mechanism that instructs CM to use the plain
573      environment hash as a module's pid (effectively making its GUID
574      the empty string).  For this, "noguid" must be specified as an
575      option to the .sml file in question within its .cm file.
576      This is most useful for code that is being generated by tools such
577      as ml-nlffigen (because during development programmers tend to
578      erase the tool's entire output directory tree including CM's cached
579      GUIDs).  "noguid" is somewhat dangerous (since it can be used to locally
580      revert to the old, broken behavior of SML/NJ, but in specific cases
581      where there is no danger of interface confusion, its use is ok
582      (I think).
583    
584      ml-nlffigen by default generates "noguid" annotations.  They can be
585      turned off by specifying -guid in its command line.
586    
587    ----------------------------------------------------------------------
588    Name: Lal George
589    Date: 2002/03/12 12 14:42:36 EST
590    Tag: george-20020312-frequency-computation
591    Description:
592    
593    Integrated jump chaining and static block frequency into the
594    compiler. More details and numbers later.
595    
596    ----------------------------------------------------------------------
597    Name: Lal George
598    Date: 2002/03/11 11 22:38:53 EST
599    Tag: george-20020311-jump-chain-elim
600    Description:
601    
602    Tested the jump chain elimination on all architectures (except the
603    hppa).  This is on by default right now and is profitable for the
604    alpha and x86, however, it may not be profitable for the sparc and ppc
605    when compiling the compiler.
606    
607    The gc test will typically jump to a label at the end of the cluster,
608    where there is another jump to an external cluster containing the actual
609    code to invoke gc. This is to allow factoring of common gc invocation
610    sequences. That is to say, we generate:
611    
612            f:
613               testgc
614               ja   L1      % jump if above to L1
615    
616            L1:
617               jmp L2
618    
619    
620    After jump chain elimination the 'ja L1' instructions is converted to
621    'ja L2'. On the sparc and ppc, many of the 'ja L2' instructions may end
622    up being implemented in their long form (if L2 is far away) using:
623    
624            jbe     L3      % jump if below or equal to L3
625            jmp     L2
626         L3:
627            ...
628    
629    
630    For large compilation units L2  may be far away.
631    
632    
633    ----------------------------------------------------------------------
634    Name: Matthias Blume
635    Date: 2002/03/11 13:30:00 EST
636    Tag: blume-20020311-mltreeeval
637    Description:
638    
639    A functor parameter was missing.
640    
641    ----------------------------------------------------------------------
642    Name: Allen Leung
643    Date: 2002/03/11 10:30:00 EST
644    Tag: leunga-20020311-runtime-string0
645    Description:
646    
647       The representation of the empty string now points to a
648    legal null terminated C string instead of unit.  It is now possible
649    to convert an ML string into C string with InlineT.CharVector.getData.
650    This compiles into one single machine instruction.
651    
652    ----------------------------------------------------------------------
653    Name: Allen Leung
654    Date: 2002/03/10 23:55:00 EST
655    Tag: leunga-20020310-x86-call
656    Description:
657    
658       Added machine generation for CALL instruction (relative displacement mode)
659    
660    ----------------------------------------------------------------------
661    Name: Matthias Blume
662    Date: 2002/03/08 16:05:00
663    Tag: blume-20020308-entrypoints
664    Description:
665    
666    Version number bumped to 110.39.1.  NEW BOOTFILES!
667    
668    Entrypoints: non-zero offset into a code object where execution should begin.
669    
670    - Added the notion of an entrypoint to CodeObj.
671    - Added reading/writing of entrypoint info to Binfile.
672    - Made runtime system bootloader aware of entrypoints.
673    - Use the address of the label of the first function given to mlriscGen
674      as the entrypoint.  This address is currently always 0, but it will
675      not be 0 once we turn on block placement.
676    - Removed the linkage cluster code (which was The Other Way(tm) of dealing
677      with entry points) from mlriscGen.
678    
679    ----------------------------------------------------------------------
680    Name: Allen Leung
681    Date: 2002/03/07 20:45:00 EST
682    Tag: leunga-20020307-x86-cmov
683    Description:
684    
685       Bug fixes for CMOVcc on x86.
686    
687       1. Added machine code generation for CMOVcc
688       2. CMOVcc is now generated in preference over SETcc on PentiumPro or above.
689       3. CMOVcc cannot have an immediate operand as argument.
690    
691    ----------------------------------------------------------------------
692    Name: Matthias Blume
693    Date: 2002/03/07 16:15:00 EST
694    Tag: blume-20020307-controls
695    Description:
696    
697    This is a very large but mostly boring patch which makes (almost)
698    every tuneable compiler knob (i.e., pretty much everything under
699    Control.* plus a few other things) configurable via both the command
700    line and environment variables in the style CM did its configuration
701    until now.
702    
703    Try starting sml with '-h' (or, if you are brave, '-H')
704    
705    To this end, I added a structure Controls : CONTROLS to smlnj-lib.cm which
706    implements the underlying generic mechanism.
707    
708    The interface to some of the existing such facilities has changed somewhat.
709    For example, the MLRiscControl module now provides mkFoo instead of getFoo.
710    (The getFoo interface is still there for backward-compatibility, but its
711    use is deprecated.)
712    
713    The ml-build script passes -Cxxx=yyy command-line arguments through so
714    that one can now twiddle the compiler settings when using this "batch"
715    compiler.
716    
717    TODO items:
718    
719    We should go through and throw out all controls that are no longer
720    connected to anything.  Moreover, we should go through and provide
721    meaningful (and correct!) documentation strings for those controls
722    that still are connected.
723    
724    Currently, multiple calls to Controls.new are accepted (only the first
725    has any effect).  Eventually we should make sure that every control
726    is being made (via Controls.new) exactly once.  Future access can then
727    be done using Controls.acc.
728    
729    Finally, it would probably be a good idea to use the getter-setter
730    interface to controls rather than ref cells.  For the time being, both
731    styles are provided by the Controls module, but getter-setter pairs are
732    better if thread-safety is of any concern because they can be wrapped.
733    
734    *****************************************
735    
736    One bug fix: The function blockPlacement in three of the MLRISC
737    backpatch files used to be hard-wired to one of two possibilities at
738    link time (according to the value of the placementFlag).  But (I
739    think) it should rather sense the flag every time.
740    
741    *****************************************
742    
743    Other assorted changes (by other people who did not supply a HISTORY entry):
744    
745    1. the cross-module inliner now works much better (Monnier)
746    2. representation of weights, frequencies, and probabilities in MLRISC
747       changed in preparation of using those for weighted block placement
748       (Reppy, George)
749    
750    ----------------------------------------------------------------------
751    Name: Lal George
752    Date: 2002/03/07 14:44:24 EST 2002
753    Tag: george-20020307-weighted-block-placement
754    
755    Tested the weighted block placement optimization on all architectures
756    (except the hppa) using AMPL to generate the block and edge frequencies.
757    Changes were required in the machine properties to correctly
758    categorize trap instructions. There is an MLRISC flag
759    "weighted-block-placement" that can be used to enable weighted block
760    placement, but this will be ineffective without block/edge
761    frequencies (coming soon).
762    
763    
764    ----------------------------------------------------------------------
765    Name: Lal George
766    Date: 2002/03/05 17:24:48 EST
767    Tag: george-20020305-linkage-cluster
768    
769    In order to support the block placement optimization, a new cluster
770    is generated as the very first cluster (called the linkage cluster).
771    It contains a single jump to the 'real' entry point for the compilation
772    unit. Block placement has no effect on the linkage cluster itself, but
773    all the other clusters  have full freedom in the manner in which they
774    reorder blocks or functions.
775    
776    On the x86 the typical linkage code that is generated is:
777       ----------------------
778            .align 2
779       L0:
780            addl    $L1-L0, 72(%esp)
781            jmp     L1
782    
783    
784            .align  2
785       L1:
786       ----------------------
787    
788    72(%esp) is the memory location for the stdlink register. This
789    must contain the address of the CPS function being called. In the
790    above example, it contains the address of  L0; before
791    calling L1 (the real entry point for the compilation unit), it
792    must contain the address for L1, and hence
793    
794            addl $L1-L0, 72(%esp)
795    
796    I have tested this on all architectures except the hppa.The increase
797    in code size is of course negligible
798    
799    ----------------------------------------------------------------------
800    Name: Allen Leung
801    Date: 2002/03/03 13:20:00 EST
802    Tag: leunga-20020303-mlrisc-tools
803    
804      Added #[ ... ] expressions to mlrisc tools
805    
806    ----------------------------------------------------------------------
807    Name: Matthias Blume
808    Date: 2002/02/27 12:29:00 EST
809    Tag: blume-20020227-cdebug
810    Description:
811    
812    - made types in structure C and C_Debug to be equal
813    - got rid of code duplication (c-int.sml vs. c-int-debug.sml)
814    - there no longer is a C_Int_Debug (C_Debug is directly derived from C)
815    
816    ----------------------------------------------------------------------
817    Name: Matthias Blume
818    Date: 2002/02/26 12:00:00 EST
819    Tag: blume-20020226-ffi
820    Description:
821    
822    1. Fixed a minor bug in CM's "noweb" tool:
823       If numbering is turned off, then truly don't number (i.e., do not
824       supply the -L option to noweb).  The previous behavior was to supply
825       -L'' -- which caused noweb to use the "default" line numbering scheme.
826       Thanks to Chris Richards for pointing this out (and supplying the fix).
827    
828    2. Once again, I reworked some aspects of the FFI:
829    
830       A. The incomplete/complete type business:
831    
832       - Signatures POINTER_TO_INCOMPLETE_TYPE and accompanying functors are
833         gone!
834       - ML types representing an incomplete type are now *equal* to
835         ML types representing their corresponding complete types (just like
836         in C).  This is still safe because ml-nlffigen will not generate
837         RTTI for incomplete types, nor will it generate functions that
838         require access to such RTTI.   But when ML code generated from both
839         incomplete and complete versions of the C type meet, the ML types
840         are trivially interoperable.
841    
842         NOTE:  These changes restore the full generality of the translation
843         (which was previously lost when I eliminated functorization)!
844    
845       B. Enum types:
846    
847       - Structure C now has a type constructor "enum" that is similar to
848         how the "su" constructor works.  However, "enum" is not a phantom
849         type because each "T enum" has values (and is isomorphic to
850         MLRep.Signed.int).
851       - There are generic access operations for enum objects (using
852         MLRep.Signed.int).
853       - ml-nlffigen will generate a structure E_foo for each "enum foo".
854         * The structure contains the definition of type "mlrep" (the ML-side
855         representation type of the enum).  Normally, mlrep is the same
856         as "MLRep.Signed.int", but if ml-nlffigen was invoked with "-ec",
857         then mlrep will be defined as a datatype -- thus facilitating
858         pattern matching on mlrep values.
859         ("-ec" will be suppressed if there are duplicate values in an
860          enumeration.)
861         * Constructors ("-ec") or values (no "-ec") e_xxx of type mlrep
862         will be generated for each C enum constant xxx.
863         * Conversion functions m2i and i2m convert between mlrep and
864         MLRep.Signed.int.  (Without "-ec", these functions are identities.)
865         * Coversion functions c and ml convert between mlrep and "tag enum".
866         * Access functions (get/set) fetch and store mlrep values.
867       - By default (unless ml-nlffigen was invoked with "-nocollect"), unnamed
868         enumerations are merged into one single enumeration represented by
869         structure E_'.
870    
871    ----------------------------------------------------------------------
872    Name: Allen Leung
873    Date: 2002/02/25 04:45:00 EST
874    Tag: leunga-20020225-cps-spill
875    
876    This is a new implementation of the CPS spill phase.
877    The new phase is in the new file compiler/CodeGen/cpscompile/spill-new.sml
878    In case of problems, replace it with the old file spill.sml
879    
880    The current compiler runs into some serious performance problems when
881    constructing a large record.  This can happen when we try to compile a
882    structure with many items.  Even a very simple structure like the following
883    makes the compiler slow down.
884    
885        structure Foo = struct
886           val x_1 = 0w1 : Word32.int
887           val x_2 = 0w2 : Word32.int
888           val x_3 = 0w3 : Word32.int
889           ...
890           val x_N = 0wN : Word32.int
891        end
892    
893    The following table shows the compile time, from N=1000 to N=4000,
894    with the old compiler:
895    
896    N
897    1000   CPS 100 spill                           0.04u  0.00s  0.00g
898           MLRISC ra                               0.06u  0.00s  0.05g
899              (spills = 0 reloads = 0)
900           TOTAL                                   0.63u  0.07s  0.21g
901    
902    1100   CPS 100 spill                           8.25u  0.32s  0.64g
903           MLRISC ra                               5.68u  0.59s  3.93g
904              (spills = 0 reloads = 0)
905           TOTAL                                   14.71u  0.99s  4.81g
906    
907    1500   CPS 100 spill                           58.55u  2.34s  1.74g
908           MLRISC ra                               5.54u  0.65s  3.91g
909              (spills = 543 reloads = 1082)
910           TOTAL                                   65.40u  3.13s  6.00g
911    
912    2000   CPS 100 spill                           126.69u  4.84s  3.08g
913           MLRISC ra                               0.80u  0.10s  0.55g
914              (spills = 42 reloads = 84)
915           TOTAL                                   129.42u  5.10s  4.13g
916    
917    3000   CPS 100 spill                           675.59u  19.03s  11.64g
918           MLRISC ra                               2.69u  0.27s  1.38g
919              (spills = 62 reloads = 124)
920           TOTAL                                   682.48u  19.61s  13.99g
921    
922    4000   CPS 100 spill                           2362.82u  56.28s  43.60g
923           MLRISC ra                               4.96u  0.27s  2.72g
924              (spills = 85 reloads = 170)
925           TOTAL                                   2375.26u  57.21s  48.00g
926    
927    As you can see the old cps spill module suffers from some serious
928    performance problem.  But since I cannot decipher the old code fully,
929    instead of patching the problems up, I'm reimplementing it
930    with a different algorithm.  The new code is more modular,
931    smaller when compiled, and substantially faster
932    (O(n log n) time and O(n) space).  Timing of the new spill module:
933    
934    4000  CPS 100 spill                           0.02u  0.00s  0.00g
935          MLRISC ra                               0.25u  0.02s  0.15g
936             (spills=1 reloads=3)
937          TOTAL                                   7.74u  0.34s  1.62g
938    
939    Implementation details:
940    
941    As far as I can tell, the purpose of the CPS spill module is to make sure the
942    number of live variables at any program point (the bandwidth)
943    does not exceed a certain limit, which is determined by the
944    size of the spill area.
945    
946    When the bandwidth is too large, we decrease the register pressure by
947    packing live variables into spill records.  How we achieve this is
948    completely different than what we did in the old code.
949    
950    First, there is something about the MLRiscGen code generator
951    that we should be aware of:
952    
953    o MLRiscGen performs code motion!
954    
955       In particular, it will move floating point computations and
956       address computations involving only the heap pointer to
957       their use sites (if there is only a single use).
958       What this means is that if we have a CPS record construction
959       statement
960    
961           RECORD(k,vl,w,e)
962    
963       we should never count the new record address w as live if w
964       has only one use (which is often the case).
965    
966       We should do something similar to floating point, but the transformation
967       there is much more complex, so I won't deal with that.
968    
969    Secondly, there are now two new cps primops at our disposal:
970    
971     1. rawrecord of record_kind option
972        This pure operator allocates some uninitialized storage from the heap.
973        There are two forms:
974    
975         rawrecord NONE [INT n]  allocates a tagless record of length n
976         rawrecord (SOME rk) [INT n] allocates a tagged record of length n
977                                     and initializes the tag.
978    
979     2. rawupdate of cty
980          rawupdate cty (v,i,x)
981          Assigns to x to the ith component of record v.
982          The storelist is not updated.
983    
984    We use these new primops for both spilling and increment record construction.
985    
986     1. Spilling.
987    
988        This is implemented with a linear scan algorithm (but generalized
989        to trees).  The algorithm will create a single spill record at the
990        beginning of the cps function and use rawupdate to spill to it,
991        and SELECT or SELp to reload from it.  So both spills and reloads
992        are fine-grain operations.  In contrast, in the old algorithm
993        "spills" have to be bundled together in records.
994    
995        Ideally, we should sink the spill record construction to where
996        it is needed.  We can even split the spill record into multiple ones
997        at the places where they are needed.  But CPS is not a good
998        representation for global code motion, so I'll keep it simple and
999        am not attempting this.
1000    
1001     2. Incremental record construction (aka record splitting).
1002    
1003        Long records with many component values which are simulatenously live
1004        (recall that single use record addresses are not considered to
1005         be live) are constructed with rawrecord and rawupdate.
1006        We allocate space on the heap with rawrecord first, then gradually
1007        fill it in with rawupdate.  This is the technique suggested to me
1008        by Matthias.
1009    
1010        Some restrictions on when this is applicable:
1011        1. It is not a VECTOR record.  The code generator currently does not handle
1012           this case. VECTOR record uses double indirection like arrays.
1013        2. All the record component values are defined in the same "basic block"
1014           as the record constructor.  This is to prevent speculative
1015           record construction.
1016    
1017    ----------------------------------------------------------------------
1018    Name: Allen Leung
1019    Date: 2002/02/22 01:02:00 EST
1020    Tag: leunga-20020222-mlrisc-tools
1021    
1022    Minor bug fixes in the parser and rewriter
1023    
1024    ----------------------------------------------------------------------
1025    Name: Allen Leung
1026    Date: 2002/02/21 20:20:00 EST
1027    Tag: leunga-20020221-peephole
1028    
1029    Regenerated the peephole files.  Some contained typos in the specification
1030    and some didn't compile because of pretty printing bugs in the old version
1031    of 'nowhere'.
1032    
1033    ----------------------------------------------------------------------
1034    Name: Allen Leung
1035    Date: 2002/02/19 20:20:00 EST
1036    Tag: leunga-20020219-mlrisc-tools
1037    Description:
1038    
1039       Minor bug fixes to the mlrisc-tools library:
1040    
1041       1.  Fixed up parsing colon suffixed keywords
1042       2.  Added the ability to shut the error messages up
1043       3.  Reimplemented the pretty printer and fixed up/improved
1044           the pretty printing of handle and -> types.
1045       4.  Fixed up generation of literal symbols in the nowhere tool.
1046       5.  Added some SML keywords to to sml.sty
1047    
1048    ----------------------------------------------------------------------
1049    Name: Matthias Blume
1050    Date: 2002/02/19 16:20:00 EST
1051    Tag: blume-20020219-cmffi
1052    Description:
1053    
1054    A wild mix of changes, some minor, some major:
1055    
1056    * All C FFI-related libraries are now anchored under $c:
1057        $/c.cm      --> $c/c.cm
1058        $/c-int.cm  --> $c/internals/c-int.cm
1059        $/memory.cm --> $c/memory/memory.cm
1060    
1061    * "make" tool (in CM) now treats its argument pathname slightly
1062      differently:
1063        1. If the native expansion is an absolute name, then before invoking
1064           the "make" command on it, CM will apply OS.Path.mkRelative
1065           (with relativeTo = OS.FileSys.getDir()) to it.
1066        2. The argument will be passed through to subsequent phases of CM
1067           processing without "going native".  In particular, if the argument
1068           was an anchored path, then "make" will not lose track of that anchor.
1069    
1070    * Compiler backends now "know" their respective C calling conventions
1071      instead of having to be told about it by ml-nlffigen.  This relieves
1072      ml-nlffigen from one of its burdens.
1073    
1074    * The X86Backend has been split into X86CCallBackend and X86StdCallBackend.
1075    
1076    * Export C_DEBUG and C_Debug from $c/c.cm.
1077    
1078    * C type encoding in ml-nlffi-lib has been improved to model the conceptual
1079      subtyping relationship between incomplete pointers and their complete
1080      counterparts.  For this, ('t, 'c) ptr has been changed to 'o ptr --
1081      with the convention of instantiating 'o with ('t, 'c) obj whenever
1082      the pointer target type is complete.  In the incomplete case, 'o
1083      will be instantiated with some "'c iobj" -- a type obtained by
1084      using one of the functors PointerToIncompleteType or PointerToCompleteType.
1085    
1086      Operations that work on both incomplete and complete pointer types are
1087      typed as taking an 'o ptr while operations that require the target to
1088      be known are typed as taking some ('t, 'c) obj ptr.
1089    
1090      voidptr is now a bit "more concrete", namely "type voidptr = void ptr'"
1091      where void is an eqtype without any values.  This makes it possible
1092      to work on voidptr values using functions meant to operate on light
1093      incomplete pointers.
1094    
1095    * As a result of the above, signature POINTER_TO_INCOMPLETE_TYPE has
1096      been vastly simplified.
1097    
1098    ----------------------------------------------------------------------
1099    Name: Matthias Blume
1100    Date: 2002/02/19 10:48:00 EST
1101    Tag: blume-20020219-pqfix
1102    Description:
1103    
1104    Applied Chris Okasaki's bug fix for priority queues.
1105    
1106    ----------------------------------------------------------------------
1107    Name: Matthias Blume
1108    Date: 2002/02/15 17:05:00
1109    Tag: Release_110_39
1110    Description:
1111    
1112    Last-minute retagging is becoming a tradition... :-(
1113    
1114    This is the working release 110.39.
1115    
1116    ----------------------------------------------------------------------
1117    Name: Matthias Blume
1118    Date: 2002/02/15 16:00:00 EST
1119    Tag: Release_110_39-orig
1120    Description:
1121    
1122    Working release 110.39.  New bootfiles.
1123    
1124    (Update: There was a small bug in the installer so it wouldn't work
1125    with all shells.  So I retagged. -Matthias)
1126    
1127    ----------------------------------------------------------------------
1128    Name: Matthias Blume
1129    Date: 2002/02/15 14:17:00 EST
1130    Tag: blume-20020215-showbindings
1131    Description:
1132    
1133    Added EnvRef.listBoundSymbols and CM.State.showBindings.  Especially
1134    the latter can be useful for exploring what bindings are available at
1135    the interactive prompt.  (The first function returns only the list
1136    of symbols that are really bound, the second prints those but also the
1137    ones that CM's autoloading mechanism knows about.)
1138    
1139    ----------------------------------------------------------------------
1140    Name: Matthias Blume
1141    Date: 2002/02/15 12:08:00 EST
1142    Tag: blume-20020215-iptrs
1143    Description:
1144    
1145    Two improvements to ml-nlffigen:
1146    
1147      1. Write files only if they do not exist or if their current contents
1148         do not coincide with what's being written.  (That is, avoid messing
1149         with the time stamps unless absolutely necessary.)
1150    
1151      2. Implement a "repository" mechanism for generated files related
1152         to "incomplete pointer types".   See the README file for details.
1153    
1154    ----------------------------------------------------------------------
1155    Name: Matthias Blume
1156    Date: 2002/02/14 11:50:00 EST
1157    Tag: blume-20020214-quote
1158    Description:
1159    
1160    Added a type 't t_' to tag.sml (in ml-nlffi-lib.cm).  This is required
1161    because of the new and improved tag generation scheme.  (Thanks to Allen
1162    Leung for pointing it out.)
1163    
1164    ----------------------------------------------------------------------
1165    Name: Lal George
1166    Date: 2002/02/14 09:55:27 EST 2002
1167    Tag: george-20020214-isabelle-bug
1168    Description:
1169    
1170    Fixed the MLRISC bug sent by Markus Wenzel regarding the compilation
1171    of Isabelle on the x86.
1172    
1173    From Allen:
1174    -----------
1175     I've found the problem:
1176    
1177         in ra-core.sml, I use the counter "blocked" to keep track of the
1178         true number of elements in the freeze queue.  When the counter goes
1179         to zero, I skip examining the queue.  But I've messed up the
1180         bookkeeping in combine():
1181    
1182             else ();
1183             case !ucol of
1184               PSEUDO => (if !cntv > 0 then
1185                     (if !cntu > 0 then blocked := !blocked - 1 else ();
1186                                        ^^^^^^^^^^^^^^^^^^^^^^^
1187                      moveu := mergeMoveList(!movev, !moveu)
1188                     )
1189                  else ();
1190    
1191         combine() is called to coalesce two nodes u and v.
1192         I think I was thinking that if the move counts of u and v are both
1193         greater than zero then after they are coalesced then one node is
1194         removed from the freeze queue.  Apparently I was thinking that
1195         both u and v are of low degree, but that's clearly not necessarily true.
1196    
1197    
1198    02/12/2002:
1199        Here's the patch.  HOL now compiles.
1200    
1201        I don't know how this impact on performance (compile
1202        time or runtime).  This bug caused the RA (especially on the x86)
1203        to go thru the potential spill phase when there are still nodes on the
1204        freeze queue.
1205    
1206    
1207    
1208    
1209    ----------------------------------------------------------------------
1210    Name: Matthias Blume
1211    Date: 2002/02/13 22:40:00 EST
1212    Tag: blume-20020213-fptr-rtti
1213    Description:
1214    
1215    Fixed a bug in ml-nlffigen that was introduced with one of the previous
1216    updates.
1217    
1218    ----------------------------------------------------------------------
1219    Name: Matthias Blume
1220    Date: 2002/02/13 16:41:00 EST
1221    Tag: blume-20020213-cmlpq
1222    Description:
1223    
1224    Added new priority queue export symbols (which have just been added to
1225    smlnj-lib.cm) to CML's version of smlnj-lib.cm.  (Otherwise CML would
1226    not compile and the installer would choke.)
1227    
1228    ----------------------------------------------------------------------
1229    Name: Matthias Blume
1230    Date: 2002/02/13 16:15:00 EST
1231    Tag: blume-20020213-various
1232    Description:
1233    
1234    1. More tweaks to ml-nlffigen:
1235    
1236       - better internal datastructures (resulting in slight speedup)
1237       - "-match" option requires exact match
1238       - "localized" gensym counters (untagged structs/unions nested within
1239         other structs/unions or within typedefs get a fresh counter; their
1240         tag will be prefixed by a concatenation of their parents' tags)
1241       - bug fixes (related to calculation of transitive closure of types
1242         to be included in the output)
1243    
1244    2. Minor Basis updates:
1245    
1246       - added implementations for List.collate and Option.app
1247    
1248    ----------------------------------------------------------------------
1249    Name: Matthias Blume
1250    Date: 2002/02/11 15:55:00 EST
1251    Tag: blume-20020211-gensym
1252    Description:
1253    
1254    Added a "-gensym" option to command line of ml-nlffigen.  This can be
1255    used to specify a "stem" -- a string that is inserted in all "gensym'd"
1256    names (ML structure names that correspond to unnamed C structs, unions,
1257    and enums), so that separate runs of ml-nlffigen do not clash.
1258    
1259    ----------------------------------------------------------------------
1260    Name: Matthias Blume
1261    Date: 2002/02/11 12:05:00 EST
1262    Tag: blume-20020211-gensml
1263    Description:
1264    
1265    A quick fix for a problem with GenSML (in the pgraph-util library):
1266    Make generation of toplevel "local" optional.  (Strictly speaking,
1267    signature definitions within "local" are not legal SML.)
1268    
1269    Other than that: updates to INSTALL and cm/TODO.
1270    
1271    ----------------------------------------------------------------------
1272    Name: Matthias Blume
1273    Date: 2002/02/08 15:00:00 EST
1274    Tag: blume-20020208-uniquepid
1275    Description:
1276    
1277    0. Version number has been bumped to 110.38.1.  NEW BOOTFILES!!!
1278    
1279    1. The installer (config/install.sh) has gotten smarter:
1280    
1281         - Configuration options are a bit easier to specify now
1282           (in config/targets).
1283         - Bug in recognizing .tar.bz2 files fixed.
1284         - Installer automatically resolves dependencies between
1285           configuration options (e.g., if you ask for eXene, you will
1286           also get cml -- regardless whether you asked for it or not).
1287         - Installer can run in "quieter mode" by setting the environment
1288           variable INSTALL_QUIETLY to "true".  "Quieter" does not mean
1289           "completely silent", though.
1290         - Build HashCons library as part of smlnj-lib.
1291    
1292    2. A new scheme for assigning persistent identifiers to compilation
1293       units (and, by extension, to types etc.) has been put into place.
1294       This fixes a long-standing bug where types and even dynamic values
1295       can get internally confused, thereby compromising type safety
1296       (abstraction) and dynamic correctness.  See
1297    
1298         http://cm.bell-labs.com/cm/cs/who/blume/pid-confusion.tgz
1299    
1300       for an example of how things could go wrong until now.
1301    
1302       The downside of the new scheme is that pids are not quite as
1303       persistent as they used to be: CM will generate a fresh pid
1304       for every compilation unit that it thinks it sees for the first
1305       time.  That means that if you compile starting from a clean, fresh
1306       source tree at two different times, you end up with different
1307       binaries.
1308    
1309       Cutoff recompilation, however, has not been compromised because
1310       CM keeps pid information in special caches between runs.
1311    
1312    ----------------------------------------------------------------------
1313    Name: Lal George
1314    Date: 2002/02/07 15:34:13 EST 2002
1315    Tag: <none>
1316    Description:
1317    
1318    Compilers that generate assembly code may produce  global labels
1319    whose value is resolved at link time. The various peephole optimization
1320    modules did not take this in account.
1321    
1322    TODO. The Labels.addrOf function should really return an option
1323    type so that clients are forced to deal with this issue, rather
1324    than an exception being raised.
1325    
1326    ----------------------------------------------------------------------
1327    Name: Lal George
1328    Date: 2002/02/06 13:55:02 EST
1329    Tag: george-20020206-ra-breakup
1330    Description:
1331    
1332    1. A bug fix from Allen.
1333    
1334        A typo causes extra fstp %st(0)'s to be generated at compensation
1335        edges, which might cause stack underflow traps at runtime.  This
1336        occurs in fft where there are extraneous fstps right before the 'into'
1337        trap instruction (in this case they are harmless since none of the
1338        integers overflow.)
1339    
1340    2. Pulled out various utility modules that were embedded in the modules
1341       of the register allocator. I need these modules for other purposes, but
1342       they are not complete enough to put into a library (just yet).
1343    ----------------------------------------------------------------------
1344    Name: Matthias Blume
1345    Date: 2002/01/31 16:05:00 EST
1346    Tag: blume-20020131-sparc-ccalls
1347    Description:
1348    
1349    1. C-calls on Sparc needlessly allocated a huge chunk (96 bytes)
1350       of extra stack space by mistake.  Fixed.
1351    
1352    2. Bug in logic of handling of command-line options in ml-nlffigen fixed.
1353    
1354    ----------------------------------------------------------------------
1355    Name: Allen Leung
1356    Date: 2002/01/30
1357    Tag: leunga-20020130-nowhere-bug-fix
1358    Description:
1359    
1360       MLRISC bug fixes:
1361       1. Fixed a bindings computation bug in the 'nowhere' program generator tool.
1362       2. MachineInt.fromString was negating its value.
1363    
1364    ----------------------------------------------------------------------
1365    Name: Matthias Blume
1366    Date: 2002/01/29
1367    Tag: blume-20020129-INSTALL
1368    Description:
1369    
1370    - Added somewhat detailed installation instructions (file INSTALL).
1371    - Fixed curl-detection bug in config/install.sh.
1372    - It is now possible to select the URL getter using the URLGETTER
1373      environment variable:
1374    
1375          not set / "unknown"      --> automatic detection (script tries wget,
1376                                       curl, and lynx)
1377          "wget" / "curl" / "lynx" --> use the specified program (script "knows"
1378                                       how to properly invoke them)
1379          other                    --> use $URLGETTER directly, it must take
1380                                       precisely two command-line arguments
1381                                       (source URL and destination file name)
1382    
1383    ----------------------------------------------------------------------
1384    Name: Matthias Blume
1385    Date: 2002/01/28
1386    Tag: blume-20020128-sparc-ccalls
1387    Description:
1388    
1389    - Fixed problem with calculation of "used" registers in sparc-c-calls.
1390    - Make use of the allocParam argument in sparc-c-calls.
1391    
1392    ----------------------------------------------------------------------
1393    Name: Matthias Blume
1394    Date: 2002/01/28
1395    Tag: blume-20020128-allocParam
1396    Description:
1397    
1398    John Reppy:  Changes c-calls API to accept client-callback for
1399    allocating extra stack space.
1400    me: Corresponding changes to mlriscGen (using a dummy argument that
1401        does not change the current behavior).
1402    
1403    ----------------------------------------------------------------------
1404    Name: Matthias Blume
1405    Date: 2002/01/28 12:00:00
1406    Tag: Release_110_38
1407    Description:
1408    
1409    This time for real!!!
1410    
1411    ----------------------------------------------------------------------
1412    Name: Matthias Blume
1413    Date: 2002/01/28 10:56:00 EST
1414    Tag: blume-20020128-retraction
1415    Description:
1416    
1417    0. Retracted earlier 110.38.  (The Release_110_38 tag has been replaced
1418       with blume-Release_110_38-retracted.)
1419    
1420    1. Fixed a problem with incorrect rounding modes in real64.sml.
1421       (Thanks to Andrew Mccreight <andrew.mccreight@yale.edu>.)
1422    
1423    2. A bug in ml-nlffigen related to the handling of unnamed structs, unions,
1424       and enums fixed.  The naming of corresponding ML identifiers should
1425       now be consistent again.
1426    
1427    ----------------------------------------------------------------------
1428    Name: Allen Leung
1429    Date: 2002/01/27
1430    Tag: leunga-20020127-nowhere
1431    Description:
1432    
1433       Added a target called nowhere in the configuration scripts.
1434       Enabling this will build the MLRISC 'nowhere' tool (for translating
1435       programs with where-clauses into legal SML code) during installation.
1436    
1437    ----------------------------------------------------------------------
1438    Name: Matthias Blume
1439    Date: 2002/01/25 21:27:00 EST
1440    Tag: blume-Release_110_38-retracted
1441    Description:
1442    
1443    Call it a (working) release!  Version is 110.38. Bootfiles are ready.
1444    
1445    README will be added later.
1446    
1447    !!! NOTE:  Re-tagged as blume-Release_110_38-retracted. Original tag
1448    (Release_110_38) removed.  Reason: Last-minute bug fixes.
1449    
1450    ----------------------------------------------------------------------
1451    Name: Matthias Blume
1452    Date: 2002/01/25
1453    Tag: blume-20020125-ffi
1454    Description:
1455    
1456    A large number of tweaks and improvements to ml-nlffi-lib and
1457    ml-nlffigen:
1458    
1459       - ML represenation types have been streamlined
1460       - getter and setter functions work with concrete values, not abstract
1461         ones where possible
1462       - ml-nlffigen command line more flexible (see README file there)
1463       - some bugs have been fixed (hopefully)
1464    
1465    ----------------------------------------------------------------------
1466    Name: Lal George
1467    Date: 2002/01/24
1468    Tag: george-20020124-risc-ra-interface
1469    Description:
1470    
1471       There is a dramatic simplification in the interface to the
1472       register allocator for RISC architectures as a result of making
1473       parallel copy instructions explicit.
1474    
1475    ----------------------------------------------------------------------
1476    Name: Matthias Blume
1477    Date: 2002/01/22
1478    Tag: blume-20020122-x86-ccalls
1479    Description:
1480    
1481    Bug fix for c-calls on x86 (having to do with how char- and
1482    short-arguments are being handled).
1483    
1484    ----------------------------------------------------------------------
1485    Name: Matthias Blume
1486    Date: 2002/01/21
1487    Tag: blume-20020121-ff
1488    Description:
1489    
1490    Another day of fiddling with the FFI...
1491    
1492    1. Bug fix/workaround:  CKIT does not complain about negative array
1493       dimensions, so ml-nlffigen has to guard itself against this possibility.
1494       (Otherwise a negative dimension would send it into an infinite loop.)
1495    
1496    2. Some of the abstract types (light objects, light pointers, most "base"
1497       types) in structure C are now eqtypes.
1498    
1499    3. Added constructors and test functions for NULL function pointers.
1500    
1501    ----------------------------------------------------------------------
1502    Name: Matthias Blume
1503    Date: 2002/01/18
1504    Tag: blume-20020118-ready-for-new-release
1505    Description:
1506    
1507    Made config/srcarchiveurl point to a new place.  (Will provide boot
1508    files shortly.)
1509    
1510    Maybe we christen this to be 110.38?
1511    
1512    ----------------------------------------------------------------------
1513    Name: Matthias Blume
1514    Date: 2002/01/18
1515    Tag: blume-20020118-more-ffifiddle
1516    Description:
1517    
1518    Today's FFI fiddling:
1519    
1520      - Provided a structure CGetSet with "convenient" versions of C.Get.* and
1521        C.Set.* that use concrete (MLRep.*) arguments and results instead
1522        of abstract ones.
1523    
1524      - Provided word-style bit operations etc. for "int" representation
1525        types in MLRep.S<Foo>Bitops where <Foo> ranges over Char, Int, Short,
1526        and Long.
1527    
1528    ----------------------------------------------------------------------
1529    Name: Matthias Blume
1530    Date: 2002/01/18
1531    Tag: blume-20020118-use-x86-fp
1532    Description:
1533    
1534    Now that x86-fast-fp seems to be working, I turned it back on again
1535    by default.  (Seems to work fine now, even with the FFI.)
1536    
1537    Other than that, I added some documentation about the FFI to
1538    src/ml-nlffigen/README and updated the FFI test examples in
1539    src/ml-nlffi-lib/Tests/*.
1540    
1541    ----------------------------------------------------------------------
1542    Name: Allen Leung
1543    Date: 2002/01/17
1544    Tag: leunga-20020117-x86-fast-fp-call
1545    Description:
1546    
1547       1. Fixed a problem with handling return fp values when x86's fast fp
1548          mode is turned on.
1549    
1550       2. Minor pretty printing fix for cellset.  Print %st(0) as %st(0) instead
1551          of %f32.
1552    
1553       3. Added a constructor INT32lit to the ast of MLRISC tools.
1554    
1555    ----------------------------------------------------------------------
1556    Name: Matthias Blume
1557    Date: 2002/01/16
1558    Tag: blume-20020116-ffifiddle
1559    Description:
1560    
1561    More fiddling with the FFI interface:
1562    
1563     - Make constness 'c instead of rw wherever possible.  This eliminates
1564       the need for certain explicit coercions.  (However, due to ML's
1565       value polymorphism, there will still be many cases where explicit
1566       coercions are necessary.  Phantom types are not the whole answer
1567       to modeling a subtyping relationship in ML.)
1568    
1569     - ro/rw coersions for pointers added.  (Avoids the detour through */&.)
1570    
1571     - "printf" test example added to src/ml-nlffi-lib/Tests.  (Demonstrates
1572       clumsy workaround for varargs problem.)
1573    
1574    ----------------------------------------------------------------------
1575    Name: Lal George
1576    Date: 2002/01/15
1577    Tag: <none>
1578    Description:
1579    
1580    1. Since COPY instructions are no longer native to the architecture,
1581       a generic functor can be used to implement the expandCopies function.
1582    
1583    2. Allowed EXPORT and IMPORT pseudo-op declarations to appear inside a
1584       TEXT segment.
1585    
1586    ----------------------------------------------------------------------
1587    Name: Matthias Blume
1588    Date: 2002/01/15
1589    Tag: blume-20020115-ffiupdates
1590    Description:
1591    
1592    1. Fix for bug resulting in single-precision float values being returned
1593       incorrectly from FFI calls.
1594    
1595    2. Small modifications to C FFI API:
1596    
1597        - memory-allocation routines return straight objects (no options)
1598          and raise an exception in out-of-memory situations
1599        - unsafe extensions to cast between function pointers and pointers
1600          from/to ints
1601        - added structure C_Debug as an alternative to structure C where
1602          pointer-dereferencing (|*| and |*!) always check for null-pointers
1603        - added open_lib' to DynLinkage;  open_lib' works like open_lib
1604          but also takes a (possibly empty) list of existing library handles
1605          that the current library depends on
1606    
1607    ----------------------------------------------------------------------
1608    Name: Matthias Blume
1609    Date: 2002/01/10
1610    Tag: blume-20020110-newffigen
1611    Description:
1612    
1613    1. Updates to portable graph code.
1614    
1615    2. Major update to ml-nlffigen and ml-nlffi-lib.  Things are much
1616       more scalable now so that even huge interfaces such as the one
1617       for GTK compile in finite time and space. :-)
1618       See src/ml-nlffigen/README for details on what's new.
1619    
1620    ----------------------------------------------------------------------
1621    Name: Lal George
1622    Date: 2001/01/09 14:31:35 EST 2002
1623    Tag: george-20011206-rm-native-copy
1624    Description:
1625    
1626            Removed the native COPY and FCOPY instructions
1627            from all the architectures and replaced it with the
1628            explicit COPY instruction from the previous commit.
1629    
1630            It is now possible to simplify many of the optimizations
1631            modules that manipulate copies. This has not been
1632            done in this change.
1633    
1634    ----------------------------------------------------------------------
1635    Name: Lal George
1636    Date: 2001/12/06 16:50:13 EST 2001
1637    Tag: george-20011206-mlrisc-instruction
1638    Description:
1639    
1640    Changed the representation of instructions from being fully abstract
1641    to being partially concrete. That is to say:
1642    
1643      from
1644            type instruction
1645    
1646      to
1647            type instr                              (* machine instruction *)
1648    
1649            datatype instruction =
1650                LIVE of {regs: C.cellset, spilled: C.cellset}
1651              | KILL of {regs: C.cellset, spilled: C.cellset}
1652              | COPYXXX of {k: CB.cellkind, dst: CB.cell list, src: CB.cell list}
1653              | ANNOTATION of {i: instruction, a: Annotations.annotation}
1654              | INSTR of instr
1655    
1656    This makes the handling of certain special instructions that appear on
1657    all architectures easier and uniform.
1658    
1659    LIVE and KILL say that a list of registers are live or killed at the
1660    program point where they appear. No spill code is generated when an
1661    element of the 'regs' field is spilled, but the register is moved to
1662    the 'spilled' (which is present, more for debugging than anything else).
1663    
1664    LIVE replaces the (now deprecated) DEFFREG instruction on the alpha.
1665    We used to generate:
1666    
1667            DEFFREG f1
1668            f1 := f2 + f3
1669            trapb
1670    
1671    but now generate:
1672    
1673            f1 := f2 + f3
1674            trapb
1675            LIVE {regs=[f1,f2,f3], spilled=[]}
1676    
1677    Furthermore, the DEFFREG (hack) required that all floating point instruction
1678    use all registers mentioned in the instruction. Therefore f1 := f2 + f3,
1679    defines f1 and uses [f1,f2,f3]! This hack is no longer required resulting
1680    in a cleaner alpha implementation. (Hopefully, intel will not get rid of
1681    this architecture).
1682    
1683    COPYXXX is intended to replace the parallel COPY and FCOPY  available on
1684    all the architectures. This will result in further simplification of the
1685    register allocator that must be aware of them for coalescing purposes, and
1686    will also simplify certain aspects of the machine description that provides
1687    callbacks related to parallel copies.
1688    
1689    ANNOTATION should be obvious, and now INSTR represents the honest to God
1690    machine instruction set!
1691    
1692    The <arch>/instructions/<arch>Instr.sml files define certain utility
1693    functions for making porting easier -- essentially converting upper case
1694    to lower case. All machine instructions (of type instr) are in upper case,
1695    and the lower case form generates an MLRISC instruction. For example on
1696    the alpha we have:
1697    
1698      datatype instr =
1699         LDA of {r:cell, b:cell, d:operand}
1700       | ...
1701    
1702      val lda : {r:cell, b:cell, d:operand} -> instruction
1703        ...
1704    
1705    where lda is just (INSTR o LDA), etc.
1706    
1707    ----------------------------------------------------------------------
1708    Name: Matthias Blume
1709    Date: 2001/11/22 21:40:00 EST
1710    Tag: Release_110_37
1711    Description:
1712    
1713    Release 110.37.  This time for real.
1714    
1715    ----------------------------------------------------------------------
1716    Name: Matthias Blume
1717    Date: 2001/11/21 16:35:00 EST
1718    Tag: blume-20011121-foot-in-mouth
1719    Description:
1720    
1721    Removed the "Release_110_37" tag because of a serious bug.
1722    This will be re-tagged once the bug is fixed.
1723    
1724    ----------------------------------------------------------------------
1725    Name: Matthias Blume
1726    Date: 2001/11/21 16:14:00 EST
1727    Tag: blume-20011121-forgottenfile
1728    Description:
1729    
1730    Forgot to add a file.  (Just a .tex-file -- part of
1731    the CM manual source.)
1732    
1733    ----------------------------------------------------------------------
1734    Name: Matthias Blume
1735    Date: 2001/11/21 16:10:00 EST
1736    Tag: blume-20011121-invalid_110_37
1737    Description:
1738    
1739    Note: I removed the original tag "Release_110_37" from this commit
1740          because we found a serious bug in all non-x86 backends.
1741          - Matthias
1742    
1743    1. Modifications to the SML/NJ code generator and to the runtime system
1744       so that code object name strings are directly inserted into code
1745       objects at code generation time.  The only business the runtime system
1746       has with this is now to read the name strings on occasions.
1747       (The encoding of the name string has also changed somewhat.)
1748    
1749    2. CM now implements a simple "set calculus" for specifying export lists.
1750       In particular, it is now possible to refer to the export lists of
1751       other libraries/groups/sources and form unions as well as differences.
1752       See the latest CM manual for details.
1753    
1754    3. An separate notion of "proxy" libraries has again be eliminated from
1755       CM's model.  (Proxy libraries are now simply a special case of using
1756       the export list calculus.)
1757    
1758    4. Some of the existing libraries now take advantage of the new set
1759       calculus.
1760       (Notice that not all libraries have been converted because some
1761       of the existing .cm-files are supposed to be backward compatible
1762       with 110.0.x.)
1763    
1764    5. Some cleanup in stand-alone programs.  (Don't use "exnMessage" -- use
1765       "General.exnMessage"!  The former relies on a certain hook to be
1766       initialized, and that often does not happen in the stand-alone case.)
1767    
1768    ----------------------------------------------------------------------
1769    Name: Lal George
1770    Date: 2001/11/21  13:56:18 EST
1771    Tag: george-2001121-pseudo-ops
1772    Description:
1773    
1774      Implemented a complete redesign of MLRISC pseudo-ops. Now there
1775      ought to never be any question of incompatabilities with
1776      pseudo-op syntax expected by host assemblers.
1777    
1778      For now, only modules supporting GAS syntax are implemented
1779      but more should follow, such as MASM, and vendor assembler
1780      syntax, e.g. IBM as, Sun as, etc.
1781    
1782    ----------------------------------------------------------------------
1783    Name: Matthias Blume
1784    Date: 2001/11/14 11:52:00 EST
1785    Tag: blume-20011114-srcname
1786    Description:
1787    
1788    1. Routed the name of the current source file to mlriscgen where it
1789       should be directly emitted into the code object.  (This last part
1790       is yet to be done.)
1791    
1792    2. Some cleanup of the pgraph code to make it match the proposal that
1793       I put out the other day.  (The proposal notwithstanding, things are
1794       still in flux here.)
1795    
1796    ----------------------------------------------------------------------
1797    Name: Lal George
1798    Date: 2001/11/14 09:44:04 EST
1799    Tag:
1800    Description:
1801    
1802      Fix for a backpatching bug reported by Allen.
1803    
1804      Because the boundary between short and long span-dependent
1805      instructions is +/- 128, there are an astounding number of
1806      span-dependent instructions whose size is over estimated.
1807    
1808      Allen came up with the idea of letting the size of span
1809      dependent instructions be non-monotonic, for a maxIter
1810      number of times, after which the size must be monotonically
1811      increasing.
1812    
1813      This table shows the number of span-dependent instructions
1814      whose size was over-estimated as a function of maxIter, for the
1815      file Parse/parse/ml.grm.sml:
1816    
1817         maxIter            # of instructions:
1818            10                      687
1819            20                      438
1820            30                      198
1821            40                        0
1822    
1823      In compiling the compiler, there is no significant difference in
1824      compilation speed between maxIter=10 and maxIter=40. Actually,
1825      my measurements showed that maxIter=40 was a tad faster than
1826      maxIter=10! Also 96% of the  files in the compiler reach a fix
1827      point within 13 iterations, so fixing maxIter at 40, while high,
1828      is okay.
1829    
1830    ----------------------------------------------------------------------
1831    Name: Matthias Blume
1832    Date: 2001/10/31 15:25:00 EST
1833    Tag: blume-20011031-pgraph
1834    Description:
1835    
1836    CKIT:
1837    * Changed the "Function" constructor of type Ast.ctype to carry optional
1838      argument identifiers.
1839    * Changed the return type of TypeUtil.getFunction accordingly.
1840    * Type equality ignores the argument names.
1841    * TypeUtil.composite tries to preserve argument names but gives up quickly
1842      if there is a mismatch.
1843    
1844    installation script:
1845    * attempts to use "curl" if available (unless "wget" is available as well)
1846    
1847    CM:
1848    * has an experimental implementation of "portable graphs" which I will
1849      soon propose as an implementation-independent library format
1850    * there are also new libraries $/pgraph.cm and $/pgraph-util.cm
1851    
1852    NLFFI-LIB:
1853    * some cleanup (all cosmetic)
1854    
1855    NLFFIGEN:
1856    * temporarily disabled the mechanism that suppresses ML output for
1857      C definitions whose identifiers start with an underscore character
1858    * generate val bindings for enum constants
1859    * user can request that only one style (light or heavy) is being used;
1860      default is to use both (command-line arguments: -heavy and -light)
1861    * fixed bug in handling of function types involving incomplete pointers
1862    * generate ML entry points that take record arguments (i.e., using
1863      named arguments) for C functions that have a prototype with named
1864      arguments
1865      (see changes to CKIT)
1866    
1867    ----------------------------------------------------------------------
1868    Name: Allen Leung
1869    Date: 2001/10/27 20:34:00 EDT
1870    Tag: leunga-20011027-x86-fast-fp-call
1871    Description:
1872    
1873       Fixed the bug described in blume-20010920-slowfp.
1874    
1875       The fix involves
1876          1. generating FCOPYs in FSTP in ia32-svid
1877          2. marking a CALL with the appropriate annotation
1878    
1879    ----------------------------------------------------------------------
1880    Name: Matthias Blume
1881    Date: 2001/10/16 11:32:00 EDT
1882    Tag: blume-20011016-netbsd
1883    Description:
1884    
1885    Underscore patch from Chris Richards (fixing problem with compiling
1886    runtime system under recent NetBSD).
1887    
1888    ----------------------------------------------------------------------
1889    Name: Allen Leung
1890    Date: 2001/10/12 17:18:32 EDT 2001
1891    Tag: leung-20011012-x86-printflowgraph
1892    Description:
1893    
1894    X86RA now uses a valid (instead of dummy) PrintFlowgraph module.
1895    
1896    ----------------------------------------------------------------------
1897    Name: Lal George
1898    Date: 2001/10/11 23:51:34 EDT
1899    Tag: george-20011011-too-many-instrs
1900    Description:
1901    
1902    The representation of a program point never expected to see more
1903    than 65536 instructions in a basic block!
1904    
1905    ----------------------------------------------------------------------
1906    Name: Lal George
1907    Date: 2001/10/09 09:41:37 EDT
1908    Tag: george-20011008-mlrisc-labels
1909    Description:
1910    
1911    Changed the machine description files to support printing of
1912    local and global labels in assembly code, based on host assembler
1913    conventions.
1914    
1915    ----------------------------------------------------------------------
1916    Name: Matthias Blume
1917    Date: 2001/09/25 15:25:00 EDT
1918    Tag: blume-20010925-exninfo
1919    Description:
1920    
1921    I provided a non-hook implementation of exnName (at the toplevel) and
1922    made the "dummy" implementation of exnMessage (at the toplevel) more
1923    useful: if nothing gets "hooked in", then at least you are going to
1924    see the exception name and a message indicating why you don't see more.
1925    
1926    [For the time being, programs that need exnMessage and want to use
1927    ml-build should either use General.exnMessage (strongly recommended) or
1928    refer to structure General at some other point so that CM sees a
1929    static dependency.]
1930    
1931    [Similar remarks go for "print" and "use":  If you want to use their
1932    functionality in stand-alone programs generated by ml-build, then use
1933    TextIO.output and Backend.Interact.useFile (from $smlnj/compiler.cm).]
1934    
1935    ----------------------------------------------------------------------
1936    Name: Matthias Blume
1937    Date: 2001/09/20 17:28:00 EDT
1938    Tag: blume-20010920-slowfp
1939    Description:
1940    
1941    Allen says that x86-fast-fp is not safe yet, so I turned it off again...
1942    
1943    ----------------------------------------------------------------------
1944    Name: Matthias Blume
1945    Date: 2001/09/20 17:20:00 EDT
1946    Tag: blume-20010920-canonicalpaths
1947    Description:
1948    
1949    0. Updated the BOOT file (something that I forgot to do earlier).
1950    
1951    1. Small internal change to CM so that it avoids "/../" in filenames
1952       as much as possible (but only where it is safe).
1953    
1954    2. Changed config/_run-sml (resulting in a changed bin/.run-sml) so
1955       that arguments that contain delimiters are passed through correctly.
1956       This change also means that all "special" arguments of the form
1957       @SMLxxx... must come first.
1958    
1959    3. Changed install script to put relative anchor names for tool commands
1960       into pathconfig.
1961    
1962    ----------------------------------------------------------------------
1963    Name: Matthias Blume
1964    Date: 2001/09/18 15:35:00 EDT
1965    Tag: blume-20010918-readme11036
1966    Description:
1967    
1968    Added README files.
1969    
1970    ----------------------------------------------------------------------
1971    Name: Matthias Blume
1972    Date: 2001/09/18 11:45:00 EDT
1973    Tag: Release_110_36 (retag)
1974    Description:
1975    
1976    Fixed mistake in config/preloads. Retagged as 110.36.
1977    
1978    ----------------------------------------------------------------------
1979    Name: Matthias Blume
1980    Date: 2001/09/18 09:40:00 EDT
1981    Tag: Release_110_36_orig (tag changed)
1982    Description:
1983    
1984    New version (110.36).  New bootfiles.
1985    
1986    ----------------------------------------------------------------------
1987    Name: Matthias Blume
1988    Date: 2001/09/14 16:15:00 EDT
1989    Tag: blume-20010914-x86fastfp
1990    Description:
1991    
1992    John committed some changes that Allen made, in particular a (hopefully)
1993    correctly working version of the x86-fp module.
1994    
1995    I changed the default setting of the Control.MLRISC.getFlag "x86-fast-fp"
1996    flag to "true".  Everything seems to compile to a fixpoint ok, and
1997    "mandelbrot" speeds up by about 15%.
1998    
1999    ----------------------------------------------------------------------
2000    Name: Matthias Blume
2001    Date: 2001/09/13 11:20:00 EDT
2002    Tag: blume-20010913-minimal
2003    Description:
2004    
2005    1. Stefan Monnier's patch to fix a miscompilation problem that
2006       was brought to light by John Reppy's work on Moby.
2007    
2008    2. Implemented a minimal "structure Compiler" that contains just
2009       "version" and "architecture".  The minimal version will be
2010       available when the full version is not.  This is for backward-
2011       compatibility with code that wants to test Compiler.version.
2012    
2013    ----------------------------------------------------------------------
2014    Name: Matthias Blume
2015    Date: 2001/08/28 14:03:00 EDT
2016    Tag: blume-20010828-ml-lex
2017    Description:
2018    
2019    Fix for bug 1581, received from Neophytos Michael.
2020    
2021    ----------------------------------------------------------------------
2022    Name: Matthias Blume
2023    Date: 2001/08/27 11:20:00 EDT
2024    Tag: blume-20010827-readme11035
2025    Description:
2026    
2027    Fleshed out the README file for 110.35.
2028    
2029    ----------------------------------------------------------------------
2030    Name: Matthias Blume
2031    Date: 2001/08/24 17:10:00 EDT
2032    Tag: Release_110_35
2033    Description:
2034    
2035    New version number (110.35).  New bootfiles.
2036    
2037    ----------------------------------------------------------------------
2038    Name: Lal George
2039    Date: 2001/08/24 13:47:18 EDT 2001
2040    Tag: george-20010824-MLRISC-graphs
2041    Description:
2042    
2043     removed clusters from MLRISC completely and replaced with graphs.
2044    
2045    ----------------------------------------------------------------------
2046    Name: Matthias Blume
2047    Date: 2001/08/23 17:50:00 EDT
2048    Tag: blume-20010823-toplevel
2049    Description:
2050    
2051    - some reorganization of the code that implements various kinds of
2052      environments in the compiler (static, dynamic, symbolic, combined)
2053    - re-implemented the EnvRef module so that evalStream works properly
2054      (if the stream contains references to "use", "CM.make", etc.)
2055    - cleaned up evalloop.sml and interact.sml (but they need more cleaning)
2056    
2057    ----------------------------------------------------------------------
2058    Name: Matthias Blume
2059    Date: 2001/08/20 15:50 EDT
2060    Tag: blume20010820-slipup
2061    Description:
2062    
2063    I forgot to commit a few files.  Here they are...
2064    
2065    ----------------------------------------------------------------------
2066    Name: Matthias Blume
2067    Date: 2001/08/20 15:35:00 EDT
2068    Tag: blume-20010820-debugprof
2069    Description:
2070    
2071    !!!! NEW BOOTFILES !!!!
2072    
2073    This is another round of reorganizing the compiler sources.  This
2074    time the main goal was to factor out all the "instrumentation"
2075    passes (for profiling and backtracing) into their own library.
2076    The difficulty was to do it in such a way that it does not depend
2077    on elaborate.cm but only on elabdata.cm.
2078    
2079    Therefore there have been further changes to both elaborate.cm and
2080    elabdata.cm -- more "generic" things have been moved from the former
2081    to the latter.  As a result, I was forced to split the assignment
2082    of numbers indicating "primtyc"s into two portions: SML-generic and
2083    SML/NJ-specific.  Since it would have been awkward to maintain,
2084    I bit the bullet and actually _changed_ the mapping between these
2085    numbers and primtycs.  The bottom line of this is that you need
2086    a new set of bin- and bootfiles.
2087    
2088    I have built new bootfiles for all architectures, so doing a fresh
2089    checkout and config/install.sh should be all you need.
2090    
2091    The newly created library's name is
2092    
2093        $smlnj/viscomp/debugprof.cm
2094    
2095    and its sources live under
2096    
2097        src/compiler/DebugProf
2098    
2099    ----------------------------------------------------------------------
2100    Name: Matthias Blume
2101    Date: 2001/08/15 17:15:00 EDT
2102    Tag: blume-20010815-compreorg
2103    Description:
2104    
2105    This is a first cut at reorganizing the CM libraries that make up the
2106    core of the compiler.  The idea is to separate out pieces that could
2107    be used independently by tools, e.g., the parser, the typechecker, etc.
2108    
2109    The current status is a step in this direction, but it is not quite
2110    satisfactory yet.  Expect more changes in the future.
2111    
2112    Here is the current (new) organization...
2113    
2114        What used to be $smlnj/viscomp/core.cm is now divided into
2115        six CM libraries:
2116    
2117             $smlnj/viscomp/basics.cm
2118                           /parser.cm
2119                           /elabdata.cm
2120                           /elaborate.cm
2121                           /execute.cm
2122                           /core.cm
2123    
2124        The CM files for these libraries live under src/system/smlnj/viscomp.
2125        All these libraries are proxy libraries that contain precisely
2126        one CM library component.  Here are the locations of the components
2127        (all within the src/compiler tree):
2128    
2129             Basics/basics.cm
2130             Parse/parser.cm
2131             ElabData/elabdata.cm
2132             Elaborator/elaborate.cm
2133             Execution/execute.cm
2134             core.cm
2135    
2136         [This organization is the same that has been used already
2137         for a while for the architecture-specific parts of the visible
2138         compiler and for the old version of core.cm.]
2139    
2140         As you will notice, many source files have been moved from their
2141         respective original locations to a new home in one of the above
2142         subtrees.
2143    
2144         The division of labor between the new libraries is the following:
2145    
2146             basics.cm:
2147                - Simple, basic definitions that pertain to many (or all) of
2148                  the other libraries.
2149             parser.cm:
2150                - The SML parser, producing output of type Ast.dec.
2151                - The type family for Ast is also defined and exported here.
2152             elabdata.cm:
2153                - The datatypes that describe input and output of the elaborator.
2154                  This includes types, absyn, and static environments.
2155             elaborator.cm:
2156                - The SML/NJ type checker and elaborator.
2157                  This maps an Ast.dec (with a given static environment) to
2158                  an Absyn.dec (with a new static environment).
2159                - This libraries implements certain modules that used to be
2160                  structures as functors (to remove dependencies on FLINT).
2161             execute.cm:
2162                - Everything having to do with executing binary code objects.
2163                - Dynamic environments.
2164             core.cm:
2165                - SML/NJ-specific instantiations of the elaborator and MLRISC.
2166                - Top-level modules.
2167                - FLINT (this should eventually become its own library)
2168    
2169    Notes:
2170    
2171    I am not 100% happy with the way I separated the elaborator (and its
2172    data structures) from FLINT.  Two instances of the same problem:
2173    
2174        1. Data structures contain certain fields that carry FLINT-specific
2175           information.  I hacked around this using exn and the property list
2176           module from smlnj-lib.  But the fact that there are middle-end
2177           specific fields around at all is a bit annoying.
2178    
2179        2. The elaborator calculates certain FLINT-related information.  I tried
2180           to make this as abstract as I could using functorization, but, again,
2181           the fact that the elaborator has to perform calculations on behalf
2182           of the middle-end at all is not nice.
2183    
2184        3. Having to used exn and property lists is unfortunate because it
2185           weakens type checking.  The other alternative (parameterizing
2186           nearly *everything*) is not appealing, though.
2187    
2188    I removed the "rebinding =" warning hack because due to the new organization
2189    it was awkward to maintain it.  As a result, the compiler now issues some of
2190    these warnings when compiling init.cmi during bootstrap compilation. On
2191    the plus side, you also get a warning when you do, for example:
2192       val op = = Int32.+
2193    which was not the case up to now.
2194    
2195    I placed "assign" and "deref" into the _Core structure so that the
2196    code that deals with the "lazy" keyword can find them there.  This
2197    removes the need for having access to the primitive environment
2198    during elaboration.
2199    
2200    ----------------------------------------------------------------------
2201    Name: Matthias Blume
2202    Date: 2001/08/13
2203    Tag: blume-20010813-closures
2204    Description:
2205    
2206    This fix was sent to us by Zhong Shao.  It is supposed to improve the
2207    performance of certain loops by avoiding needless closure allocation.
2208    
2209    ----------------------------------------------------------------------
2210    Name: Lal George
2211    Date: 2001/07/31 10:03:23 EDT 2001
2212    Tag: george-20010731-x86-fmalloc
2213    Description: Fixed bug in x86 calls
2214    
2215        There was a bug where call instructions would mysteriously
2216        vanish. The call instruction had to be one that returned
2217        a floating point value.
2218    
2219    ----------------------------------------------------------------------
2220    Name: Lal George
2221    Date: 2001/07/19 16:36:29 EDT 2001
2222    Tag: george-20010719-simple-cells
2223    Description:
2224    
2225    I have dramatically simplified the interface for CELLS in MLRISC.
2226    
2227    In summary, the cells interface is broken up into three parts:
2228    
2229      1. CellsBasis : CELLS_BASIS
2230    
2231            CellsBasis is a top level structure and common for all
2232            architectures.  it contains the definitions of basic datatypes
2233            and utility  functions over these types.
2234    
2235      2. functor Cells() : CELLS
2236    
2237            Cells generates an interface for CELLS that incorporates the
2238            specific resources on the target architecture, such as the
2239            presence of special register classes, their number and size,
2240            and various useful substructures.
2241    
2242      3. <ARCH>CELLS
2243    
2244            e.g. SparcCells: SPARCCELLS
2245    
2246            <ARCH>CELLS usually contains additional bindings for special
2247            registers  on the architecture, such as:
2248    
2249                    val r0 : cell           (* register zero *)
2250                    val y : cell            (* Y register *)
2251                    val psr : cell          (* processor status register *)
2252                    ...
2253    
2254            The structure returned by applying the Cells functor is opened
2255            in this interface.
2256    
2257    The main implication of all this is that the datatypes for cells is
2258    split between CellsBasis and CELLS -- a fairly simple change for user
2259    code.
2260    
2261    In the old scheme the CELLS interface had a definitional binding of
2262    the form:
2263    
2264            signature CELLS = sig
2265    
2266               structure CellsBasis = CellsBasis
2267    
2268               ...
2269    
2270            end
2271    
2272    With all the sharing constraints that goes on in MLRISC, this old
2273    design  quickly leads to errors such as:
2274    
2275            "structure definition spec inside of sharing ... "
2276    
2277    
2278    and appears to require an unacceptable amount of sharing and where
2279    constraint hackery.
2280    
2281    I think this error message (the interaction of definitional specs and
2282    sharing) requires more explanation on our web page.
2283    
2284    ----------------------------------------------------------------------
2285    Name: Matthias Blume
2286    Date: 2001/07/19 15:00:00 EDT
2287    Tag: blume-20010719-libreorg
2288    Description:
2289    
2290    This update puts together a fairly extensive but straightforward change
2291    to the way the libraries that implement the interactive system are
2292    organized:
2293    
2294       The biggest change is the elimination of structure Compiler.  As a
2295       replacement for this structure, there is now a CM library
2296       (known as $smlnj/compiler.cm or $smlnj/compiler/current.cm)
2297       that exports all the substructures of the original structure Compiler
2298       directly.  So instead of saying Compiler.Foo.bar one now simply
2299       says Foo.bar.  (The CM libraries actually export a collection of
2300       structures that is richer than the collection of substructures of
2301       structure Compiler.)
2302    
2303       To make the transition smooth, there is a separate library called
2304       $smlnj/compiler/compiler.cm which puts together and exports the
2305       original structure Compiler (or at least something very close to it).
2306    
2307       There are five members of the original structure Compiler
2308       that are not exported directly but which instead became members
2309       of a new structure Backend (described by signature BACKEND).  These are:
2310       structure Profile (: PROFILE), structure Compile (: COMPILE), structure
2311       Interact (: INTERACT), structure Machine (: MACHINE), and val
2312       architecture (: string).
2313    
2314       Structure Compiler.Version has become structure CompilerVersion.
2315    
2316       Cross-compilers for alpha32, hppa, ppc, sparc, and x86 are provided
2317       by $smlnj/compiler/<arch>.cm where <arch> is alpha32, hppa, ppc, sparc,
2318       or x86, respectively.
2319       Each of these exports the same frontend structures that
2320       $smlnj/compiler.cm exports.  But they do not have a structure Backend
2321       and instead export some structure <Arch>Backend where <Arch> is Alpha32,
2322       Hppa, PPC, Sparc, or X86, respectively.
2323    
2324       Library $smlnj/compiler/all.cm exports the union of the exports of
2325       $smlnj/compiler/<arch>.cm
2326    
2327       There are no structures <Arch>Compiler anymore, use
2328       $smlnj/compiler/<arch>.cm instead.
2329    
2330       Library host-compiler-0.cm is gone.  Instead, the internal library
2331       that instantiates CM is now called cm0.cm.  Selection of the host
2332       compiler (backend) is no longer done here but. (Responsibility for it
2333       now lies with $smlnj/compiler/current.cm.  This seems to be more
2334       logical.)
2335    
2336       Many individual files have been moved or renamed.  Some files have
2337       been split into multiple files, and some "dead" files have been deleted.
2338    
2339    Aside from these changes to library organization, there are also changes
2340    to the way the code itself is organized:
2341    
2342       Structure Binfile has been re-implemented in such a way that it no
2343       longer needs any knowledge of the compiler.  It exclusively deals
2344       with the details of binfile layout.  It no longer invokes the
2345       compiler (for the purpose of creating new prospective binfile
2346       content), and it no longer has any knowledge of how to interpret
2347       pickles.
2348    
2349       Structure Compile (: COMPILE) has been stripped down to the bare
2350       essentials of compilation.  It no longer deals with linking/execution.
2351       The interface has been cleaned up considerably.
2352    
2353       Utility routines for dealing with linking and execution have been
2354       moved into their own substructures.
2355    
2356       (The ultimate goal of these changes is to provide a light-weight
2357       binfile loader/linker (at least for, e.g., stable libraries) that
2358       does not require CM or the compiler to be present.)
2359    
2360    CM documentation has been updated to reflect the changes to library
2361    organization.
2362    
2363    ----------------------------------------------------------------------
2364    Name: Matthias Blume
2365    Date: 2001/07/10 17:30:00 EDT
2366    Tag: Release_110_34
2367    Description:
2368    
2369    Minor tweak to 110.34 (re-tagged):
2370    
2371      - README.html file added to CVS repository
2372      - runtime compiles properly under FreeBSD 3.X and 4.X
2373    
2374    ----------------------------------------------------------------------
2375    Name: Matthias Blume
2376    Date: 2001/07/10 17:30:00 EDT
2377    Tag: Release_110_34
2378    Description:
2379    
2380    New version number (110.34). New bootfiles.
2381    
2382    ----------------------------------------------------------------------
2383    Name: Matthias Blume
2384    Date: 2001/07/09 16:00:00 EDT
2385    Tag: blume-20010709-more-varargs
2386    Description:
2387    
2388    I changed the handling of varargs in ml-nlffigen again:
2389    The ellipsis ... will now simply be ignored (with an accompanying warning).
2390    
2391    The immediate effect is that you can actually call a varargs function
2392    from ML -- but you can't actually supply any arguments beyond the ones
2393    specified explicitly.  (For example, you can call printf with its format
2394    string, but you cannot pass additional arguments.)
2395    
2396    This behavior is only marginally more useful than the one before, but
2397    it has the advantage that a function or, more importantly, a function
2398    type never gets dropped on the floor, thus avoiding follow-up problems with
2399    other types that refer to the offending one.
2400    
2401    ----------------------------------------------------------------------
2402    Name: Matthias Blume
2403    Date: 2001/07/09 11:25:00 EDT
2404    Tag: blume-20010709-varargs
2405    Description:
2406    
2407    1. ckit-lib.cm now exports structure Error
2408    2. ml-nlffigen reports occurences of "..." (i.e., varargs function types)
2409       with a warning accompanied by a source location.  Moreover, it
2410       merely skips the offending function or type and proceeds with the
2411       rest of its work.u  As a result, one can safely feed C code containing
2412       "..." to ml-nlffigen.
2413    3. There are some internal improvements to CM, providing slightly
2414       more general string substitutions in the tools subsystem.
2415    
2416    ----------------------------------------------------------------------
2417    Name: Matthias Blume
2418    Date: 2001/06/27 15:10:00 EDT
2419    Tag: blume-20010627-concur
2420    Description:
2421    
2422    Fixed a small bug in CM's handling of parallel compilation.
2423    (You could observe the bug by Control-C-interrupting an ordinary
2424    CMB.make or CM.stabilize and then attaching some compile servers.
2425    The result was that all of a sudden the previously interrupted
2426    compilation would continue on its own.  This was because of
2427    an over-optimization: CM did not bother to clean out certain queues
2428    when no servers were attached "anyway", resulting in the contents
2429    of these queues to grab control when new servers did get attached.)
2430    
2431    There is also another minor update to the CM manual.
2432    
2433    ----------------------------------------------------------------------
2434    Name: Matthias Blume
2435    Date: 2001/06/26 16:15:00 EDT
2436    Tag: blume-20010626-cmdoc
2437    Description:
2438    
2439    Minor typo fixed in CM manual (syntax diagram for libraries).
2440    
2441    ----------------------------------------------------------------------
2442    Name: Matthias Blume
2443    Date: 2001/06/25 22:55:00 EDT
2444    Tag: blume-20010625-x86pc
2445    Description:
2446    
2447    Fixed a nasty bug in the X86 assembly code that caused signal
2448    handlers to fail (crash) randomly.
2449    
2450    ----------------------------------------------------------------------
2451    Name: Matthias Blume
2452    Date: 2001/06/25 12:05:00 EDT
2453    Tag: blume-20010625-nlffigen
2454    Description:
2455    
2456    This update fixes a number of minor bugs in ml-nlffigen as reported by
2457    Nick Carter <nbc@andrew.cmu.edu>.
2458    
2459      1. Silly but ok typedefs of the form "typedef void myvoid;" are now accepted.
2460      2. Default names for generated files are now derived from the name of
2461         the C file *without its directory*.  In particular, this causes generated
2462         files to be placed locally even if the C file is in some system directory.
2463      3. Default names for generated signatures and structures are also derived
2464         from the C file name without its directory.  This avoids silly things
2465         like "structure GL/GL".
2466         (Other silly names are still possible because ml-nlffigen does not do
2467          a thorough check of whether generated names are legal ML identifiers.
2468          When in doubt, use command line arguments to force particular names.)
2469    
2470    ----------------------------------------------------------------------
2471    Name: Matthias Blume
2472    Date: 2001/06/21 12:25:00 EDT
2473    Tag: blume-20010621-eXene
2474    Description:
2475    
2476    eXene now compiles and (sort of) works again.
2477    
2478    The library name (for version > 110.33) is $/eXene.cm.
2479    
2480    I also added an new example in src/eXene/examples/nbody.  See the
2481    README file there for details.
2482    
2483    ----------------------------------------------------------------------
2484    Name: Matthias Blume
2485    Date: 2001/06/20 16:40:00 EDT
2486    Tag: blume-20010620-cml
2487    Description:
2488    
2489    CML now compiles and works again.
2490    
2491    Libraries (for version > 110.33):
2492    
2493      $cml/cml.cm            Main CML library.
2494      $cml/basis.cm          CML's version of $/basis.cm.
2495      $cml/cml-internal.cm   Internal helper library.
2496      $cml/core-cml.cm       Internal helper library.
2497      $cml-lib/trace-cml.cm  Tracing facility.
2498      $cml-lib/smlnj-lib.cm  CML's version of $/smlnj-lib.cm
2499    
2500    The installer (config/install.sh) has been taught how to properly
2501    install this stuff.
2502    
2503    ----------------------------------------------------------------------
2504    Name: Matthias Blume
2505    Date: 2001/06/19 17:55:00 EDT
2506    Tag: blume-20010619-instantiate
2507    Description:
2508    
2509    This un-breaks the fix for bug 1432.
2510    (The bug was originally fixed in 110.9 but I broke it again some
2511    time after that.)
2512    
2513    ----------------------------------------------------------------------
2514    Name: Matthias Blume
2515    Date: 2001/06/19 17:25:00 EDT
2516    Tag: blume-20010619-signals
2517    Description:
2518    
2519    This should (hopefully) fix the long-standing signal handling bug.
2520    (The runtime system was constructing a continuation record with an
2521    incorrect descriptor which would cause the GC to drop data on the floor...)
2522    
2523    ----------------------------------------------------------------------
2524    Name: Matthias Blume
2525    Date: 2001/06/15 15:05:00 EDT
2526    Tag: blume-20010615-moresparc
2527    Description:
2528    
2529    Here is a short late-hour update related to Sparc c-calls:
2530    
2531     -- made handling of double-word arguments a bit smarter
2532    
2533     -- instruction selection phase tries to collapse certain clumsily
2534        constructed ML-Trees; typical example:
2535    
2536            ADD(ty,ADD(_,e,LI d1),LI d2)  ->  ADD(ty,e,LI(d1+d2))
2537    
2538        This currently has no further impact on SML/NJ since mlriscGen does
2539        not seem to generate such patterns in the first place, and c-calls
2540        (which did generate them in the beginning) has meanwhile been fixed
2541        so as to avoid them as well.
2542    
2543    ----------------------------------------------------------------------
2544    Name: Matthias Blume
2545    Date: 2001/06/15 15:05:00 EDT
2546    Tag: blume-20010615-sparc
2547    Description:
2548    
2549    The purpose of this update is to provide an implementation of NLFFI
2550    on Sparc machines.
2551    
2552    Here are the changes in detail:
2553    
2554       * src/MLRISC/sparc/c-calls/sparc-c-calls.sml is a new file containing
2555       the Sparc implementation of the c-calls API.
2556       * The Sparc backend of SML/NJ has been modified to uniformely use %fp
2557       for accessing the ML frame.  Thus, we have a real frame pointer and
2558       can freely modify %sp without need for an omit-frame-ptr phase.
2559       The vfp logic in src/compiler/CodeGen/* has been changed to accomodate
2560       this case.
2561       * ml-nlffigen has been taught to produce code for different architectures
2562       and calling conventions.
2563       * In a way similar to what was done in the x86 case, the Sparc
2564       backend uses its own specific extension to mltree.  (For example,
2565       it needs to be able to generate UNIMP instructions which are part
2566       of the calling convention.)
2567       * ml-nlffi-lib was reorganized to make it more modular (in particular,
2568       to make it easier to plug in new machine- and os-dependent parts).
2569    
2570    There are some other fairly unrelated bug fixes and cleanups as well:
2571    
2572       * I further hacked the .cm files for MLRISC tools (like MDLGen) so
2573       that they properly share their libraries with existing SML/NJ libraries.
2574       * I fixed a minor cosmetic bug in CM, supressing certain spurious
2575       follow-up error messages.
2576       * Updates to CM/CMB documentation.
2577    
2578    TODO items:
2579    
2580       * MLRISC should use a different register as its asmTemp on the Sparc.
2581         (The current %o2 is a really bad choice because it is part of the
2582         calling conventions, so things might interfere in unexpected ways.)
2583    
2584    ----------------------------------------------------------------------
2585    Name: Matthias Blume
2586    Date: 2001/06/07
2587    Tag: blume-20010607-calls
2588    Description:
2589    
2590    A number of internal changes related to C calls and calling conventions:
2591    
2592    1. ML-Tree CALL statements now carry a "pops" field.  It indicates the
2593       number of bytes popped implicitly (by the callee).  In most cases
2594       this field is 0 but on x86/win32 it is some non-zero value.  This
2595       is information provided for the benefit of the "omit-frameptr" pass.
2596    2. The CALL instruction on the x86 carries a similar "pops" field.
2597       The instruction selection phase copies its value from the ML-Tree
2598       CALL statement.
2599    3. On all other architectures, the instruction selection phase checks
2600       whether "pops=0" and complains if not.
2601    4. The c-calls implementation for x86 now accepts two calling conventions:
2602       "ccall" and "stdcall".  When "ccall" is selected, the caller cleans
2603       up after the call and pops is set to 0.  For "stdcall", the caller
2604       does nothing, leaving the cleanup to the callee; pops is set to
2605       the number of bytes that were pushed onto the stack.
2606    5. The cproto decoder (compiler/Semant/types/cproto.sml) now can
2607       distinguish between "ccall" and "stdcall".
2608    6. The UNIMP instruction has been added to the supported Sparc instruction
2609       set. (This is needed for implementing the official C calling convention
2610       on this architecture.)
2611    7. I fixed some of the .cm files under src/MLRISC/Tools to make them
2612       work with the latest CM.
2613    
2614    ----------------------------------------------------------------------
2615    Name: Matthias Blume
2616    Date: 2001/06/05 15:10:00 EDT
2617    Tag: blume-20010605-cm-index
2618    Description:
2619    
2620    0. The "lambdasplit" parameter for class "sml" in CM has been documented.
2621    
2622    1. CM can now generate "index files".  These are human-readable files
2623       that list on a per-.cm-file basis each toplevel symbol defined or
2624       imported.  The location of the index file for
2625       <p>/<d>.cm is <p>/CM/INDEX/<d>.cm.
2626       To enable index-file generation, set CM.Control.generate_index to true
2627       or export an environment-symbol: export CM_GENERATE_INDEX=true.
2628    
2629       The CM manual has been updated accordingly.
2630    
2631    2. I made some slight modifications to the c-calls API in MLRISC.
2632    
2633         a) There is now a callback to support saving/restoring of
2634            dedicated but caller-save registers around the actual call
2635            instruction.
2636         b) One can optionally specify a comment-annotation for the
2637            call instruction.
2638    
2639    3. SML/NJ (mlriscGen.sml) uses this new API for the rawccall primop.
2640       (For example, the comment annotation shows the C prototype of
2641        the function being called.)
2642    
2643    ----------------------------------------------------------------------
2644    Name: Matthias Blume
2645    Date: 2001/06/01 13:30:00 EDT
2646    Tag: blume-20010601-nlffi-cleanup
2647    Description:
2648    
2649    This is mostly a cleanup of MLFFI stuff:
2650    
2651       - some signature files have been put into a more exposed place
2652       - the ugly 'f type parameter is gone (simplifies types tremendously!)
2653       - ml-nlffigen changed accordingly
2654       - tutorial updated
2655    
2656    Other changes:
2657    
2658       - author's affiliation in CM manual(s) updated
2659       - some more recognized keywords added to Allen's sml.sty
2660    
2661    ----------------------------------------------------------------------
2662    Name: Matthias Blume
2663    Date: 2001/05/25 15:30:00 EDT
2664    Tag: blume-20010525-iptr
2665    Description:
2666    
2667      - put the official 110.33-README (as it appears on the ftp server) under
2668        CVS
2669      - fixed a small bug related to incomplete pointer types in
2670        ml-nlffigen
2671      - small cosmetic change to the ml-nlffi-lib's "arr" type constructor
2672        (it does not need the 'f type parameter)
2673    
2674    ----------------------------------------------------------------------
2675    Name: Matthias Blume
2676    Date: 2001/05/23 14:30:00 EDT
2677    Tag: Release_110_33
2678    Description:
2679    
2680    New version number (110.33).  New bootfiles.
2681    
2682    ----------------------------------------------------------------------
2683    Name: Matthias Blume
2684    Date: 2001/05/22 18:06:00 EDT
2685    Tag: blume-20010522-targets
2686    Description:
2687    
2688    Made install.sh use file config/targets.customized if it exists, falling
2689    back to config/targets if it doesn't.  This way one can have a customized
2690    version of the targets file without touching the "real thing", thus
2691    eliminating the constant fear of accidentally checking something bogus
2692    back into the CVS repository...  (File config/targets.customized must
2693    not be added to the repository!)
2694    
2695    ----------------------------------------------------------------------
2696    Name: Matthias Blume
2697    Date: 2001/05/22 16:30:00 EDT
2698    Tag: blume-20010522-minitut
2699    Description:
2700    
2701    1. Bug fix in ml-nlffigen; now (hopefully) correctly handling
2702       struct returns.
2703    2. Added src/ml-nlffi-lib/Doc/mini-tutorial.txt.  This is some very
2704       incomplete, preliminary documentation for NLFFI.
2705    
2706    ----------------------------------------------------------------------
2707    Name: Matthias Blume
2708    Date: 2001/05/14 11:30:00 EDT
2709    Tag: blume-20010514-script
2710    Description:
2711    
2712    Some bugs in install script fixed.
2713    
2714    In addition to that I also made a slight change to the NLFFI API:
2715    Functors generated by ml-nlffigen now take the dynamic library as a
2716    straight functor argument, not as a suspended one.  (The original
2717    functor code used to force the suspension right away anyway, so there
2718    was nothing gained by this complication of the interface.)
2719    
2720    ----------------------------------------------------------------------
2721    Name: Matthias Blume
2722    Date: 2001/05/11 14:35:00 EDT
2723    Tag: blume-20010511-ml-nlffi
2724    Description:
2725    
2726    I finally took the plunge and added my new FFI code to the main
2727    repository.  For x86-linux it is now ready for prime-time.
2728    
2729    There are two new subdirectories of "src":
2730    
2731      - ml-nlffi-lib:
2732           The utility library for programs using the FFI interface.
2733           Here is the implementation of $/c.cm and its associated low-level
2734           partners $/c-int.cm and $/memory.cm.
2735      - ml-nlffigen:
2736           A stand-alone program for generating ML glue code from C source
2737           code.
2738    
2739    Building ml-nlffigen requires $/ckit-lib.cm.
2740    
2741    The config/install.sh script has been updates to do the Right Thing
2742    (hopefully).
2743    
2744    Notice that the source tree for the C-Kit will not be put under "src"
2745    but directly under the installation root directory.  (This is the
2746    structure that currently exists on the CVS server when you check out
2747    module "sml".)  Fortunately, config/install.sh knows about this oddity.
2748    
2749    Bugs: No documentation yet.
2750    
2751    ----------------------------------------------------------------------
2752    Name: Matthias Blume
2753    Date: 2001/05/09 16:35:00 EDT
2754    Tag: blume-20010509-cpscontract
2755    Description:
2756    
2757    Fixed a bug in the accounting code in cpsopt/contract.sml.  (The
2758    wrapper/unwrapper elimination did not decrement usage counts and some
2759    dead variables got overlooked by the dead-up logic.)
2760    
2761    ----------------------------------------------------------------------
2762    Name: Lal George
2763    Date: 2001/05/08  17:26:09 EDT
2764    Tag: george-20010508-omit-frameptr
2765    Description:
2766    
2767    Changes to implement the omit-frame-pointer optimization to support
2768    raw C calls. For now, there is only support on the Intel x86, but
2769    other architectures will follow as more experience is gained with this.
2770    
2771    
2772    ----------------------------------------------------------------------
2773    Name: Matthias Blume
2774    Date: 2001/05/07 14:40:00 EDT
2775    Tag: blume-20010507-proxies
2776    Description:
2777    
2778    I made into "proxy libraries" all libraries that qualify for such a
2779    change.  (A qualifying library is a library that has another library or
2780    groups as its sole member and repeats that member's export list
2781    verbatim.  A proxy library avoids this repetition by omitting its export
2782    list, effectively inheriting the list that its (only) member exports.
2783    See the CM manual for more explanation.)
2784    The main effect is that explicit export lists for these libraries
2785    do not have to be kepts in sync, making maintenance a bit easier.
2786    
2787    I also added copyright notices to many .cm-files.
2788    
2789    Last but not least, I made a new set of bootfiles.
2790    
2791    ----------------------------------------------------------------------
2792    Name: Matthias Blume
2793    Date: 2001/05/04 17:00:00 EDT
2794    Tag: blume-20010504-cm-lsplit
2795    Description:
2796    
2797    0. John merged pending changes to $/smlnj-lib.cm
2798    
2799    1. Allen's previous change accidentally backed out of one of Lal's
2800       earlier changes.  I undid this mistake (re-introducing Lal's change).
2801    
2802    2. I used the new topOrder' function from graph-scc.sml (from $/smlnj-lib.cm)
2803       within the compiler where applicable.  There is some code simplification
2804       because of that.
2805    
2806    3. The "split" phase (in FLINT) is now part of the default list of phases.
2807       Compiler.Control.LambdaSplitting.* can be used to globally control the
2808       lambda-splitting (cross-module-inlining) engine.  In addition to that,
2809       it can now also be controlled on a per-source basis: CM has been taught
2810       a new tool parameter applicable to ML source files.
2811    
2812       - To turn lambda-splitting off completely:
2813            local open Compiler.Control.LambdaSplitting in
2814                val _ = set Off
2815            end
2816       - To make "no lambda-splitting" the global default (but allow per-source
2817         overriding); this is the initial setting:
2818            local open Compiler.Control.LambdaSplitting in
2819                val _ = set (Default NONE)
2820            end
2821       - To make "lambda-splitting with aggressiveness a" the global default
2822         (and allow per-source overriding):
2823            local open Compiler.Control.LambdaSplitting in
2824                val _ = set (Default (SOME a))
2825            end
2826    
2827       - To turn lambda-splitting off for a given ML souce file (say: a.sml)
2828         write (in the respective .cm-file):
2829            a.sml (lambdasplitting:off)
2830       - To turn lambda-splitting for a.sml on with minimal aggressiveness:
2831            a.sml (lambdasplitting:on)
2832       - To turn lambda-splitting for a.sml on with aggressiveness <a> (where
2833         <a> is a decimal non-negative integer):
2834            a.sml (lambdasplitting:<a>)
2835       - To turn lambda-splitting for a.sml on with maximal aggressiveness:
2836            a.sml (lambdasplitting:infinity)
2837       - To use the global default for a.sml:
2838            a.sml (lambdasplitting:default)
2839         or simply
2840            a.sml
2841    
2842    ----------------------------------------------------------------------
2843    Name: Allen Leung
2844    Date: 2001/05/04 01:57:00 EDT
2845    Tag: leunga-20010504-sync
2846    Description:
2847    
2848      MLRISC features.
2849    
2850      1. Fix to CMPXCHG instructions.
2851      2. Changed RA interface to allow annotations in callbacks.
2852      3. Added a new method to the stream interface to allow annotations updates.
2853    
2854    ----------------------------------------------------------------------
2855    Name: Matthias Blume
2856  Date: 2001/05/01 11:45:00 EDT  Date: 2001/05/01 11:45:00 EDT
2857  Tag: blume-20010501-pcedittmp  Tag: blume-20010501-pcedittmp
2858  Description:  Description:
# Line 2098  Line 4937 
4937       elaborator). There were a lot of changes during my "linkpath" trials       elaborator). There were a lot of changes during my "linkpath" trials
4938       that could have been reverted to their original state but weren't.       that could have been reverted to their original state but weren't.
4939       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
4940       than what was strictly necessary...  (I _did_ resist the tempation       than what was strictly necessary...  (I _did_ resist the temptation
4941       of doing any "global reformatting" to avoid an untimely death at       of doing any "global reformatting" to avoid an untimely death at
4942       Dave's hands. :)       Dave's hands. :)
4943    

Legend:
Removed from v.814  
changed lines
  Added in v.1189

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