/[cmucl]/src/BUILDING
ViewVC logotype

Diff of /src/BUILDING

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.2 by rtoy, Tue May 17 16:14:05 2005 UTC revision 1.3 by rtoy, Wed May 25 12:21:18 2005 UTC
# Line 68  Setting up a build environment Line 68  Setting up a build environment
68    
69  That's it, you are now ready to build CMU CL.  That's it, you are now ready to build CMU CL.
70    
71    A quick guide for simple builds
72    -------------------------------
73    
74    We recommend that you read all of this document, but in case you don't
75    want to do that and in case you know, somehow, that the version of
76    CMUCL you are building from will build the sources you have, here is a
77    quick guide.
78    
79    a) Simple builds
80    
81       Use this to build from a version of CMUCL that is very close to the
82       sources you are trying to build now:
83    
84       src/tools/build.sh -C "" -o "<name-of-old-lisp> <options-to-lisp>"
85    
86       This will build CMUCL 3 times, each time with the result of the
87       previous build.  The last time, the additional libraries like CLX,
88       CLM, and Hemlock are built.  The final result will be in the
89       directory build-4.
90    
91       This script basically runs create-target.sh, build-world.sh,
92       load-world.sh three times.  See below for descriptions of these
93       scripts.
94    
95    b) Slightly more complicated builds
96    
97       For slightly more complicated builds, you may need to use some
98       bootstrap files.  See below for more information about these
99       bootstrap files.
100    
101       For these, you can use this:
102    
103       src/tools/build.sh -C "" -o "<old-lisp>" -B boot1.lisp -B boot2.lisp
104    
105       The bootstrap files listed with the -B option (as many as needed)
106       are loaded in order, so be sure to get them right.
107    
108       As in a) above, three builds are done, and the result is in the
109       directory build-4.
110    
111    c) More complicated builds
112    
113       If you have more complicated builds, this script probably will not
114       work, and definitely does not handle cross-compiles.  In this case,
115       you will have to invoke the individual scripts by hand, as
116       described below.
117    
118    How do you know which of the three options above apply?  The easiest
119    way is to look in src/bootfiles/<version>/* for boot files.  If the
120    file date of a boot file is later than the version of CMUCL you are
121    building from, then you need to use b) or c) above.  You may need to
122    read the bootfiles for additional instructions, if any.
123    
124    If there are no bootfiles, then you can use a) above.
125    
126    The build.sh script supports other options, and src/tools/build.sh -?
127    will give a quick summary.  Read src/tools/build.sh for more
128    information.
129    
130  A general outline of the build process  A general outline of the build process
131  --------------------------------------  --------------------------------------

Legend:
Removed from v.1.2  
changed lines
  Added in v.1.3

  ViewVC Help
Powered by ViewVC 1.1.5