diff options
-rw-r--r-- | INSTALL.cli | 75 | ||||
-rw-r--r-- | bootstrap.gmake | 2 |
2 files changed, 72 insertions, 5 deletions
diff --git a/INSTALL.cli b/INSTALL.cli index 5750bc8..84649ba 100644 --- a/INSTALL.cli +++ b/INSTALL.cli @@ -8,8 +8,10 @@ complete \c{build2} toolchain, you should use the \c{build2-toolchain} distribution instead. The instructions outlined below are essentially a summary of the first three -steps of the manual bootstrap process described in \c{build2-toolchain}. Also, -below we only show commands for UNIX-like operating systems. For other +steps of the manual bootstrap process described in \c{build2-toolchain} with a +few extra examples that would primarily be useful for distribution packaging. + +Also, below we only show commands for UNIX-like operating systems. For other operating systems and for more details on each step, refer to the \c{build2-toolchain} documentation. @@ -18,8 +20,12 @@ Update 3 or any later versions of these compilers are known to work. The build system is self-hosted, which means that unless you have obtained a pre-built binary from somewhere else, you will need to bootstrap it. To accomplish this, we use the \c{bootstrap.sh} shell script (or equivalent batch files for -Windows) found in the root directory of the \c{build2} distribution. The -following is the recommended sequence of steps: +Windows) found in the root directory of the \c{build2} distribution. On +UNIX-like operating systems a GNU \c{make} makefile called \c{bootstrap.gmake} +can also be used with the major advanage over the script being support for +parallel bootstrap (see comments inside the makefile for more information). + +The following is the recommended sequence of steps: \dl| @@ -49,6 +55,27 @@ $ ./bootstrap.sh g++ $ build2/b-boot --version \ +Alternatively, we can use the \c{bootstrap.gmake} makefile: + +\ +$ cd build2-X.Y.Z +$ make -f bootstrap.gmake CXX=g++ -j 8 + +$ build2/b-boot --version +\ + +If you would prefer to bootstrap out of source tree, this is supported by the +makefile (but not the script): + +\ +$ mkdir build2-boot +$ cd build2-boot +$ make -f ../build2-X.Y.Z/bootstrap.gmake CXX=g++ -j 8 +$ cd .. + +$ build2-boot/build2/b-boot --version +\ + | \li|\n\b{2. Bootstrap, Phase 2}\n @@ -63,6 +90,15 @@ $ mv build2/b build2/b-boot $ build2/b-boot --version \ +Or, alternatively, for an out of tree build: + +\ +$ build2-boot/build2/b-boot config.cxx=g++ config.bin.lib=static \ + build2-X.Y.Z/@build2-static/ + +$ build2-static/build2/b --version +\ + | \li|\n\b{3. Build and Install}\n @@ -100,5 +136,36 @@ $ b uninstall $ which b \ +Or, alternatively, for an out of tree build: + +\ +$ build2-static/build2/b configure: build2-X.Y.Z/@build2-shared/ \ + config.cxx=g++ \ + config.cc.coptions=-O3 \ + config.bin.rpath=/usr/local/lib \ + config.install.root=/usr/local \ + config.install.sudo=sudo + +$ build2-static/build2/b build2-shared/ + +$ build2-static/build2/b install: build2-shared/ + +$ b uninstall: build2-shared/ +\ + +For distribution packaging it is often required to install \"as if\" into the +system directory (for example, \c{/usr}) but to copy the files somewhere else +(for example, \c{/tmp/install/usr}; aka the \c{DESTDIR} functionality). In +\c{build2} this can be achieved with the \c{config.install.chroot} +configuration variable, for example: + +\ +$ build2-static/build2/b configure: build2-X.Y.Z/@build2-shared/ \ + config.cxx=g++ \ + config.cc.coptions=-O3 \ + config.install.root=/usr \ + config.install.chroot=/tmp/install +\ + || " diff --git a/bootstrap.gmake b/bootstrap.gmake index 8426a98..650607e 100644 --- a/bootstrap.gmake +++ b/bootstrap.gmake @@ -4,7 +4,7 @@ # This makefile requires GNU make 3.81 or later and can be used to bootstrap # the build system similar to the bootstrap.sh script. Its main advantage over -# the script is support for building in parallel. +# the script is support for parallel bootstrap. # # Similar to the script, the makefile expects to find the libbutl/ or # libbutl-*/ directory either in the current directory (build2 root) or one |