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 873, Mon Jul 9 15:26:20 2001 UTC revision 904, Mon Aug 20 19:50:05 2001 UTC
# Line 14  Line 14 
14    
15  ----------------------------------------------------------------------  ----------------------------------------------------------------------
16  Name: Matthias Blume  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  Date: 2001/07/09 11:25:00 EDT
362  Tag: blume-20010709-varargs  Tag: blume-20010709-varargs
363  Description:  Description:

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

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