added instructions for building a change that affects the C and Scheme sides

original commit: 2dc7cf491655c0b0f373d3303d9cf2b0b0ed0f1a
This commit is contained in:
Bob Burger 2018-07-18 15:54:47 -04:00
parent 52e55172e5
commit d3551a0173

View File

@ -97,6 +97,17 @@ The make file supports several targets:
fails. This should not fail unless the distributed boot files are fails. This should not fail unless the distributed boot files are
out of sync with the sources. out of sync with the sources.
When you make a modification to the system that causes the C side to
get out of sync with the Scheme side so that the build fails, try
the following from $W if you have a recent version of Chez Scheme
installed in your path:
make -C s clean all patchfile=patch Scheme=scheme SCHEMEHEAPDIRS={see below}
make build
Set SCHEMEHEAPDIRS to /usr/lib/csv%v/%m:/usr/local/lib/csv%v/%m on
Unix-like systems and to %x/../../boot/%m on Windows systems.
To run Chez Scheme without installing, you need to tell the executable To run Chez Scheme without installing, you need to tell the executable
where to find the boot files. This can be done via command-line where to find the boot files. This can be done via command-line
arguments, e.g.: arguments, e.g.:
@ -157,7 +168,7 @@ The make file supports several targets:
can take 5 minutes or more. can take 5 minutes or more.
'make bootfiles' builds boot files for each machine type for which 'make bootfiles' builds boot files for each machine type for which
a subdirectory exists in the top-level boot directory. to build a subdirectory exists in the top-level boot directory. To build
for a supported machine type that isn't built by default, simply for a supported machine type that isn't built by default, simply
add the appropriate subdirectory, i.e., 'mkdir boot/$M', where M add the appropriate subdirectory, i.e., 'mkdir boot/$M', where M
is the machine type, before running 'make bootfiles'. You can is the machine type, before running 'make bootfiles'. You can