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 875, Tue Jul 10 21:19:41 2001 UTC revision 903, Mon Aug 20 19:34:06 2001 UTC
# Line 14  Line 14 
14    
15  ----------------------------------------------------------------------  ----------------------------------------------------------------------
16  Name: Matthias Blume  Name: Matthias Blume
17    Date: 2001/08/20 15:35:00 EDT
18    Tag: blume-20010820-debugprof
19    Description:
20    
21    !!!! NEW BOOTFILES !!!!
22    
23    This is another round of reorganizing the compiler sources.  This
24    time the main goal was to factor out all the "instrumentation"
25    passes (for profiling and backtracing) into their own library.
26    The difficulty was to do it in such a way that it does not depend
27    on elaborate.cm but only on elabdata.cm.
28    
29    Therefore there have been further changes to both elaborate.cm and
30    elabdata.cm -- more "generic" things have been moved from the former
31    to the latter.  As a result, I was forced to split the assignment
32    of numbers indicating "primtyc"s into two portions: SML-generic and
33    SML/NJ-specific.  Since it would have been awkward to maintain,
34    I bit the bullet and actually _changed_ the mapping between these
35    numbers and primtycs.  The bottom line of this is that you need
36    a new set of bin- and bootfiles.
37    
38    I have built new bootfiles for all architectures, so doing a fresh
39    checkout and config/install.sh should be all you need.
40    
41    The newly created library's name is
42    
43        $smlnj/viscomp/debugprof.cm
44    
45    and its sources live under
46    
47        src/compiler/DebugProf
48    
49    ----------------------------------------------------------------------
50    Name: Matthias Blume
51    Date: 2001/08/15 17:15:00 EDT
52    Tag: blume-20010815-compreorg
53    Description:
54    
55    This is a first cut at reorganizing the CM libraries that make up the
56    core of the compiler.  The idea is to separate out pieces that could
57    be used independently by tools, e.g., the parser, the typechecker, etc.
58    
59    The current status is a step in this direction, but it is not quite
60    satisfactory yet.  Expect more changes in the future.
61    
62    Here is the current (new) organization...
63    
64        What used to be $smlnj/viscomp/core.cm is now divided into
65        six CM libraries:
66    
67             $smlnj/viscomp/basics.cm
68                           /parser.cm
69                           /elabdata.cm
70                           /elaborate.cm
71                           /execute.cm
72                           /core.cm
73    
74        The CM files for these libraries live under src/system/smlnj/viscomp.
75        All these libraries are proxy libraries that contain precisely
76        one CM library component.  Here are the locations of the components
77        (all within the src/compiler tree):
78    
79             Basics/basics.cm
80             Parse/parser.cm
81             ElabData/elabdata.cm
82             Elaborator/elaborate.cm
83             Execution/execute.cm
84             core.cm
85    
86         [This organization is the same that has been used already
87         for a while for the architecture-specific parts of the visible
88         compiler and for the old version of core.cm.]
89    
90         As you will notice, many source files have been moved from their
91         respective original locations to a new home in one of the above
92         subtrees.
93    
94         The division of labor between the new libraries is the following:
95    
96             basics.cm:
97                - Simple, basic definitions that pertain to many (or all) of
98                  the other libraries.
99             parser.cm:
100                - The SML parser, producing output of type Ast.dec.
101                - The type family for Ast is also defined and exported here.
102             elabdata.cm:
103                - The datatypes that describe input and output of the elaborator.
104                  This includes types, absyn, and static environments.
105             elaborator.cm:
106                - The SML/NJ type checker and elaborator.
107                  This maps an Ast.dec (with a given static environment) to
108                  an Absyn.dec (with a new static environment).
109                - This libraries implements certain modules that used to be
110                  structures as functors (to remove dependencies on FLINT).
111             execute.cm:
112                - Everything having to do with executing binary code objects.
113                - Dynamic environments.
114             core.cm:
115                - SML/NJ-specific instantiations of the elaborator and MLRISC.
116                - Top-level modules.
117                - FLINT (this should eventually become its own library)
118    
119    Notes:
120    
121    I am not 100% happy with the way I separated the elaborator (and its
122    data structures) from FLINT.  Two instances of the same problem:
123    
124        1. Data structures contain certain fields that carry FLINT-specific
125           information.  I hacked around this using exn and the property list
126           module from smlnj-lib.  But the fact that there are middle-end
127           specific fields around at all is a bit annoying.
128    
129        2. The elaborator calculates certain FLINT-related information.  I tried
130           to make this as abstract as I could using functorization, but, again,
131           the fact that the elaborator has to perform calculations on behalf
132           of the middle-end at all is not nice.
133    
134        3. Having to used exn and property lists is unfortunate because it
135           weakens type checking.  The other alternative (parameterizing
136           nearly *everything*) is not appealing, though.
137    
138    I removed the "rebinding =" warning hack because due to the new organization
139    it was awkward to maintain it.  As a result, the compiler now issues some of
140    these warnings when compiling init.cmi during bootstrap compilation. On
141    the plus side, you also get a warning when you do, for example:
142       val op = = Int32.+
143    which was not the case up to now.
144    
145    I placed "assign" and "deref" into the _Core structure so that the
146    code that deals with the "lazy" keyword can find them there.  This
147    removes the need for having access to the primitive environment
148    during elaboration.
149    
150    ----------------------------------------------------------------------
151    Name: Matthias Blume
152    Date: 2001/08/13
153    Tag: blume-20010813-closures
154    Description:
155    
156    This fix was sent to us by Zhong Shao.  It is supposed to improve the
157    performance of certain loops by avoiding needless closure allocation.
158    
159    ----------------------------------------------------------------------
160    Name: Lal George
161    Date: 2001/07/31 10:03:23 EDT 2001
162    Tag: george-20010731-x86-fmalloc
163    Description: Fixed bug in x86 calls
164    
165        There was a bug where call instructions would mysteriously
166        vanish. The call instruction had to be one that returned
167        a floating point value.
168    
169    ----------------------------------------------------------------------
170    Name: Lal George
171    Date: 2001/07/19 16:36:29 EDT 2001
172    Tag: george-20010719-simple-cells
173    Description:
174    
175    I have dramatically simplified the interface for CELLS in MLRISC.
176    
177    In summary, the cells interface is broken up into three parts:
178    
179      1. CellsBasis : CELLS_BASIS
180    
181            CellsBasis is a top level structure and common for all
182            architectures.  it contains the definitions of basic datatypes
183            and utility  functions over these types.
184    
185      2. functor Cells() : CELLS
186    
187            Cells generates an interface for CELLS that incorporates the
188            specific resources on the target architecture, such as the
189            presence of special register classes, their number and size,
190            and various useful substructures.
191    
192      3. <ARCH>CELLS
193    
194            e.g. SparcCells: SPARCCELLS
195    
196            <ARCH>CELLS usually contains additional bindings for special
197            registers  on the architecture, such as:
198    
199                    val r0 : cell           (* register zero *)
200                    val y : cell            (* Y register *)
201                    val psr : cell          (* processor status register *)
202                    ...
203    
204            The structure returned by applying the Cells functor is opened
205            in this interface.
206    
207    The main implication of all this is that the datatypes for cells is
208    split between CellsBasis and CELLS -- a fairly simple change for user
209    code.
210    
211    In the old scheme the CELLS interface had a definitional binding of
212    the form:
213    
214            signature CELLS = sig
215    
216               structure CellsBasis = CellsBasis
217    
218               ...
219    
220            end
221    
222    With all the sharing constraints that goes on in MLRISC, this old
223    design  quickly leads to errors such as:
224    
225            "structure definition spec inside of sharing ... "
226    
227    
228    and appears to require an unacceptable amount of sharing and where
229    constraint hackery.
230    
231    I think this error message (the interaction of definitional specs and
232    sharing) requires more explanation on our web page.
233    
234    ----------------------------------------------------------------------
235    Name: Matthias Blume
236    Date: 2001/07/19 15:00:00 EDT
237    Tag: blume-20010719-libreorg
238    Description:
239    
240    This update puts together a fairly extensive but straightforward change
241    to the way the libraries that implement the interactive system are
242    organized:
243    
244       The biggest change is the elimination of structure Compiler.  As a
245       replacement for this structure, there is now a CM library
246       (known as $smlnj/compiler.cm or $smlnj/compiler/current.cm)
247       that exports all the substructures of the original structure Compiler
248       directly.  So instead of saying Compiler.Foo.bar one now simply
249       says Foo.bar.  (The CM libraries actually export a collection of
250       structures that is richer than the collection of substructures of
251       structure Compiler.)
252    
253       To make the transition smooth, there is a separate library called
254       $smlnj/compiler/compiler.cm which puts together and exports the
255       original structure Compiler (or at least something very close to it).
256    
257       There are five members of the original structure Compiler
258       that are not exported directly but which instead became members
259       of a new structure Backend (described by signature BACKEND).  These are:
260       structure Profile (: PROFILE), structure Compile (: COMPILE), structure
261       Interact (: INTERACT), structure Machine (: MACHINE), and val
262       architecture (: string).
263    
264       Structure Compiler.Version has become structure CompilerVersion.
265    
266       Cross-compilers for alpha32, hppa, ppc, sparc, and x86 are provided
267       by $smlnj/compiler/<arch>.cm where <arch> is alpha32, hppa, ppc, sparc,
268       or x86, respectively.
269       Each of these exports the same frontend structures that
270       $smlnj/compiler.cm exports.  But they do not have a structure Backend
271       and instead export some structure <Arch>Backend where <Arch> is Alpha32,
272       Hppa, PPC, Sparc, or X86, respectively.
273    
274       Library $smlnj/compiler/all.cm exports the union of the exports of
275       $smlnj/compiler/<arch>.cm
276    
277       There are no structures <Arch>Compiler anymore, use
278       $smlnj/compiler/<arch>.cm instead.
279    
280       Library host-compiler-0.cm is gone.  Instead, the internal library
281       that instantiates CM is now called cm0.cm.  Selection of the host
282       compiler (backend) is no longer done here but. (Responsibility for it
283       now lies with $smlnj/compiler/current.cm.  This seems to be more
284       logical.)
285    
286       Many individual files have been moved or renamed.  Some files have
287       been split into multiple files, and some "dead" files have been deleted.
288    
289    Aside from these changes to library organization, there are also changes
290    to the way the code itself is organized:
291    
292       Structure Binfile has been re-implemented in such a way that it no
293       longer needs any knowledge of the compiler.  It exclusively deals
294       with the details of binfile layout.  It no longer invokes the
295       compiler (for the purpose of creating new prospective binfile
296       content), and it no longer has any knowledge of how to interpret
297       pickles.
298    
299       Structure Compile (: COMPILE) has been stripped down to the bare
300       essentials of compilation.  It no longer deals with linking/execution.
301       The interface has been cleaned up considerably.
302    
303       Utility routines for dealing with linking and execution have been
304       moved into their own substructures.
305    
306       (The ultimate goal of these changes is to provide a light-weight
307       binfile loader/linker (at least for, e.g., stable libraries) that
308       does not require CM or the compiler to be present.)
309    
310    CM documentation has been updated to reflect the changes to library
311    organization.
312    
313    ----------------------------------------------------------------------
314    Name: Matthias Blume
315    Date: 2001/07/10 17:30:00 EDT
316    Tag: Release_110_34
317    Description:
318    
319    Minor tweak to 110.34 (re-tagged):
320    
321      - README.html file added to CVS repository
322      - runtime compiles properly under FreeBSD 3.X and 4.X
323    
324    ----------------------------------------------------------------------
325    Name: Matthias Blume
326  Date: 2001/07/10 17:30:00 EDT  Date: 2001/07/10 17:30:00 EDT
327  Tag: Release_110_34  Tag: Release_110_34
328  Description:  Description:

Legend:
Removed from v.875  
changed lines
  Added in v.903

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