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

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