aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBoris Kolpackov <boris@codesynthesis.com>2022-02-24 10:54:10 +0200
committerBoris Kolpackov <boris@codesynthesis.com>2022-02-24 10:54:10 +0200
commit676ae90876b65da544f617ab835b958ab958b158 (patch)
treeeef45c25d58cf2e7ff31f9f9629db13c396f60f3
parentab9c848ef7cfc9c585cfcf90c9268c94142b490a (diff)
Add notes on how to use system-installed versions for dependencies
-rw-r--r--BOOTSTRAP-UNIX.cli27
1 files changed, 27 insertions, 0 deletions
diff --git a/BOOTSTRAP-UNIX.cli b/BOOTSTRAP-UNIX.cli
index ef85857..ee9f12d 100644
--- a/BOOTSTRAP-UNIX.cli
+++ b/BOOTSTRAP-UNIX.cli
@@ -177,6 +177,20 @@ $ build2/build2/b-boot configure \
$ build2/build2/b-boot install: build2/ bpkg/
\
+\N|The above command will build all the dependencies of \c{build2} and
+\c{bpkg} from sources bundled with \c{build2-toolchain}. If instead you would
+like to use system-installed versions for some of them, then you can specify
+empty \c{config.import.*} values to disable the use of the bundled versions.
+For example, to use the system-installed SQLite:
+
+\
+$ build2/build2/b-boot configure \
+ ... \
+ config.import.libsqlite3=
+\
+
+|
+
The strange-looking \c{config.install.data_root=root/stage} means install
data files (as opposed to executable files) into the \c{stage/} subdirectory
of wherever \c{config.install.root} points to (so in our case it will be
@@ -318,6 +332,19 @@ $ bpkg-stage build --for install build2 bpkg bdep
$ bpkg-stage install --all
\
+\N|The above command will build all the dependencies of \c{build2}, \c{bpkg},
+and \c{bdep} from source packages. If instead you would like to use
+system-installed versions for some of them, then you can list them with the
+\c{sys} scheme to make \c{bpkg-stage} treat them as available from the system
+rather than building them from source. For example, to use the
+system-installed SQLite:
+
+\
+$ bpkg-stage build --for install build2 bpkg bdep ?sys:libsqlite3
+\
+
+|
+
\N|By default \c{bpkg} will build the latest available version of each
package. You can, however, specify the desired versions explicitly, for
example: