fix doc example typo
[boost.git] / bootstrap.sh
blobc59d8e56fb2e888e1b4a4e9cccd4640c3e6ed88f
1 #!/bin/sh
2 # Copyright (C) 2005, 2006 Douglas Gregor.
3 # Copyright (C) 2006 The Trustees of Indiana University
5 # Distributed under the Boost Software License, Version 1.0.
6 # (See accompanying file LICENSE_1_0.txt or http://www.boost.org/LICENSE_1_0.txt)
8 # boostinspect:notab - Tabs are required for the Makefile.
10 BJAM=""
11 TOOLSET=""
12 BJAM_CONFIG=""
13 BUILD=""
14 PREFIX=/usr/local
15 EPREFIX=
16 LIBDIR=
17 INCLUDEDIR=
18 LIBS=""
19 PYTHON=python
20 PYTHON_VERSION=
21 PYTHON_ROOT=
22 ICU_ROOT=
24 # Internal flags
25 flag_no_python=
26 flag_icu=
27 flag_show_libraries=
29 for option
31 case $option in
33 -help | --help | -h)
34 want_help=yes ;;
36 -prefix=* | --prefix=*)
37 PREFIX=`expr "x$option" : "x-*prefix=\(.*\)"`
40 -exec-prefix=* | --exec-prefix=*)
41 EPREFIX=`expr "x$option" : "x-*exec-prefix=\(.*\)"`
44 -libdir=* | --libdir=*)
45 LIBDIR=`expr "x$option" : "x-*libdir=\(.*\)"`
48 -includedir=* | --includedir=*)
49 INCLUDEDIR=`expr "x$option" : "x-*includedir=\(.*\)"`
52 -show-libraries | --show-libraries )
53 flag_show_libraries=yes
56 -with-bjam=* | --with-bjam=* )
57 BJAM=`expr "x$option" : "x-*with-bjam=\(.*\)"`
60 -with-icu | --with-icu )
61 flag_icu=yes
64 -with-icu=* | --with-icu=* )
65 flag_icu=yes
66 ICU_ROOT=`expr "x$option" : "x-*with-icu=\(.*\)"`
69 -without-icu | --without-icu )
70 flag_icu=no
73 -with-libraries=* | --with-libraries=* )
74 library_list=`expr "x$option" : "x-*with-libraries=\(.*\)"`
75 if test "$library_list" != "all"; then
76 old_IFS=$IFS
77 IFS=,
78 for library in $library_list
80 LIBS="$LIBS --with-$library"
82 if test $library = python; then
83 requested_python=yes
85 done
86 IFS=$old_IFS
88 if test "x$requested_python" != xyes; then
89 flag_no_python=yes
94 -without-libraries=* | --without-libraries=* )
95 library_list=`expr "x$option" : "x-*without-libraries=\(.*\)"`
96 old_IFS=$IFS
97 IFS=,
98 for library in $library_list
100 LIBS="$LIBS --without-$library"
102 if test $library = python; then
103 flag_no_python=yes
105 done
106 IFS=$old_IFS
109 -with-python=* | --with-python=* )
110 PYTHON=`expr "x$option" : "x-*with-python=\(.*\)"`
113 -with-python-root=* | --with-python-root=* )
114 PYTHON_ROOT=`expr "x$option" : "x-*with-python-root=\(.*\)"`
117 -with-python-version=* | --with-python-version=* )
118 PYTHON_VERSION=`expr "x$option" : "x-*with-python-version=\(.*\)"`
121 -with-toolset=* | --with-toolset=* )
122 TOOLSET=`expr "x$option" : "x-*with-toolset=\(.*\)"`
126 { echo "error: unrecognized option: $option
127 Try \`$0 --help' for more information." >&2
128 { (exit 1); exit 1; }; }
131 esac
132 done
134 if test "x$want_help" = xyes; then
135 cat <<EOF
136 \`./bootstrap.sh' prepares Boost for building on a few kinds of systems.
138 Usage: $0 [OPTION]...
140 Defaults for the options are specified in brackets.
142 Configuration:
143 -h, --help display this help and exit
144 --with-bjam=BJAM use existing Boost.Jam executable (bjam)
145 [automatically built]
146 --with-toolset=TOOLSET use specific Boost.Build toolset
147 [automatically detected]
148 --show-libraries show the set of libraries that require build
149 and installation steps (i.e., those libraries
150 that can be used with --with-libraries or
151 --without-libraries), then exit
152 --with-libraries=list build only a particular set of libraries,
153 describing using either a comma-separated list of
154 library names or "all"
155 [all]
156 --without-libraries=list build all libraries except the ones listed []
157 --with-icu enable Unicode/ICU support in Regex
158 [automatically detected]
159 --without-icu disable Unicode/ICU support in Regex
160 --with-icu=DIR specify the root of the ICU library installation
161 and enable Unicode/ICU support in Regex
162 [automatically detected]
163 --with-python=PYTHON specify the Python executable [python]
164 --with-python-root=DIR specify the root of the Python installation
165 [automatically detected]
166 --with-python-version=X.Y specify the Python version as X.Y
167 [automatically detected]
169 Installation directories:
170 --prefix=PREFIX install Boost into the given PREFIX
171 [/usr/local]
172 --exec-prefix=EPREFIX install Boost binaries into the given EPREFIX
173 [PREFIX]
175 More precise control over installation directories:
176 --libdir=DIR install libraries here [EPREFIX/lib]
177 --includedir=DIR install headers here [PREFIX/include]
181 test -n "$want_help" && exit 0
183 # TBD: Determine where the script is located
184 my_dir="."
186 # Determine the toolset, if not already decided
187 if test "x$TOOLSET" = x; then
188 guessed_toolset=`$my_dir/tools/jam/src/build.sh --guess-toolset`
189 case $guessed_toolset in
190 acc | darwin | gcc | como | mipspro | pathscale | pgi | qcc | vacpp )
191 TOOLSET=$guessed_toolset
194 intel-* )
195 TOOLSET=intel
198 mingw )
199 TOOLSET=gcc
202 sun* )
203 TOOLSET=sun
207 # Not supported by Boost.Build
209 esac
212 rm -f config.log
214 # Build bjam
215 if test "x$BJAM" = x; then
216 echo -n "Building Boost.Jam with toolset $TOOLSET... "
217 pwd=`pwd`
218 cd "$my_dir/tools/jam/src" && ./build.sh "$TOOLSET" > config.log 2>&1
219 cd "$pwd"
220 arch=`cd $my_dir/tools/jam/src && ./bootstrap/jam0 -d0 -f build.jam --toolset=$TOOLSET --toolset-root= --show-locate-target && cd ..`
221 BJAM="$my_dir/tools/jam/src/$arch/bjam"
222 echo "tools/jam/src/$arch/bjam"
223 cp "$BJAM" .
226 # TBD: Turn BJAM into an absolute path
228 # If there is a list of libraries
229 if test "x$flag_show_libraries" = xyes; then
230 libraries=`$BJAM -d0 --show-libraries`
231 cat <<EOF
233 The following Boost libraries have portions that require a separate build
234 and installation step. Any library not listed here can be used by including
235 the headers only.
237 The Boost libraries requiring separate building and installation are:
239 for lib in $libraries
241 echo " $lib"
242 done
243 exit 0
246 # Setup paths
247 if test "x$EPREFIX" = x; then
248 EPREFIX="$PREFIX"
251 if test "x$LIBDIR" = x; then
252 LIBDIR="$EPREFIX/lib"
255 if test "x$INCLUDEDIR" = x; then
256 INCLUDEDIR="$PREFIX/include"
259 # Find Python
260 if test "x$flag_no_python" = x; then
261 result=`$PYTHON -c "exit" > /dev/null 2>&1`
262 if [ "$?" -ne "0" ]; then
263 flag_no_python=yes
267 if test "x$flag_no_python" = x; then
268 if test "x$PYTHON_VERSION" = x; then
269 echo -n "Detecting Python version... "
270 PYTHON_VERSION=`$PYTHON -c "import sys; print (\"%d.%d\" % (sys.version_info[0], sys.version_info[1]))"`
271 echo $PYTHON_VERSION
274 if test "x$PYTHON_ROOT" = x; then
275 echo -n "Detecting Python root... "
276 PYTHON_ROOT=`$PYTHON -c "import sys; print sys.prefix"`
277 echo $PYTHON_ROOT
281 # Configure ICU
282 echo -n "Unicode/ICU support for Boost.Regex?... "
283 if test "x$flag_icu" != xno; then
284 if test "x$ICU_ROOT" = x; then
285 COMMON_ICU_PATHS="/usr /usr/local /sw"
286 for p in $COMMON_ICU_PATHS; do
287 if test -r $p/include/unicode/utypes.h; then
288 ICU_ROOT=$p
290 done
292 if test "x$ICU_ROOT" = x; then
293 echo "not found."
294 else
295 BJAM_CONFIG="$BJAM_CONFIG -sICU_PATH=$ICU_ROOT"
296 echo "$ICU_ROOT"
298 else
299 BJAM_CONFIG="$BJAM_CONFIG -sICU_PATH=$ICU_ROOT"
300 echo "$ICU_ROOT"
302 else
303 echo "disabled."
306 # Backup the user's existing project-config.jam
307 JAM_CONFIG_OUT="project-config.jam"
308 if test -r "project-config.jam"; then
309 counter=1
311 while test -r "project-config.jam.$counter"; do
312 counter=`expr $counter + 1`
313 done
315 echo "Backing up existing Boost.Build configuration in project-config.jam.$counter"
316 mv "project-config.jam" "project-config.jam.$counter"
319 # Generate user-config.jam
320 echo "Generating Boost.Build configuration in project-config.jam..."
321 cat > project-config.jam <<EOF
322 # Boost.Build Configuration
323 # Automatically generated by bootstrap.sh
325 import option ;
326 import feature ;
328 # Compiler configuration. This definition will be used unless
329 # you already have defined some toolsets in your user-config.jam
330 # file.
331 if ! $TOOLSET in [ feature.values <toolset> ]
333 using $TOOLSET ;
336 project : default-build <toolset>$TOOLSET ;
339 # - Python configuration
340 if test "x$flag_no_python" = x; then
341 cat >> project-config.jam <<EOF
343 # Python configuration
344 using python : $PYTHON_VERSION : $PYTHON_ROOT ;
348 if test "x$ICU_ROOT" != x; then
349 cat >> project-config.jam << EOF
351 path-constant ICU_PATH : $ICU_ROOT ;
356 cat >> project-config.jam << EOF
358 # List of --with-<library> and --without-<library>
359 # options. If left empty, all libraries will be built.
360 # Options specified on the command line completely
361 # override this variable.
362 libraries = $LIBS ;
364 # These settings are equivivalent to corresponding command-line
365 # options.
366 option.set prefix : $PREFIX ;
367 option.set exec-prefix : $EPREFIX ;
368 option.set libdir : $LIBDIR ;
369 option.set includedir : $INCLUDEDIR ;
372 cat << EOF
374 Bootstrapping is done. To build, run:
376 ./bjam
378 To adjust configuration, edit 'project-config.jam'.
379 Further information:
381 - Command line help:
382 ./bjam --help
384 - Getting started guide:
385 http://www.boost.org/more/getting_started/unix-variants.html
387 - Boost.Build documentation:
388 http://www.boost.org/boost-build2/doc/html/index.html