Improve README.bootstrap

During the bootstrap process it is necessary to clean the build tree between
the initial and complete builds.  This patch describes this and adds
commands to the instructions that clean the build tree.

As compilation can take a long time I've also added a paragraph describing
how to instruct make to run multiple parallel tasks.

README.bootstrap:
    As above.
This commit is contained in:
Paul Bone
2014-03-04 11:40:02 +11:00
parent 35b09651a5
commit a03ba31888

View File

@@ -41,10 +41,13 @@ further need for tarballs when building Mercury from Git.
BOOTSTRAPPING BOOTSTRAPPING
------------- -------------
Once the minimal prerequisite compiler has been built, a reasonably complete Once the minimal prerequisite compiler has been built and installed, a
distribution can be bootstrapped by issuing the following command sequence: reasonably complete distribution can be bootstrapped. However the build
tree must be clean or the build may fail. Clean and then build the complete
distribution by issuing the following command sequence:
---- ----
make realclean
aclocal -I m4 aclocal -I m4
autoconf autoconf
./configure ./configure
@@ -66,6 +69,17 @@ components:
People wanting to simply experiment with Mercury would be best-served with People wanting to simply experiment with Mercury would be best-served with
using only the `asm_fast.gc` grade or `hlc.gc` on OS X. using only the `asm_fast.gc` grade or `hlc.gc` on OS X.
Since building Mercury can take a long time, you may prefer to use multiple
processors during the build process. Adding "PARALLEL=-jN" without the
quotes to make's command line will tell make to run N tasks at once.
Substitute N with the number of processors in your system, or fewer if you
want to use other processors for other tasks. For example:
----
make PARALLEL=-j4
sudo make PARALLEL=-j4 install
----
ALTERNATIVES TO BOOTSTRAPPING ALTERNATIVES TO BOOTSTRAPPING
----------------------------- -----------------------------
Unless you are planning to contribute to the Mercury project, bootstrapping Unless you are planning to contribute to the Mercury project, bootstrapping