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

Legend:
Removed from v.634  
changed lines
  Added in v.904

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