Boost.Build V2 User Manual XML to PDF by RenderX XEP XSL-FO Formatter, visit us at http://www.renderx.com/ Boost.Build V2 User Manual Copyright © 2006-2009 Vladimir Prus Distributed under the Boost Software License, Version 1.0. (See accompanying ®le LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) XML to PDF by RenderX XEP XSL-FO Formatter, visit us at http://www.renderx.com/ Table of Contents How to use this document ........................................................................................................................................ 1 Installation ............................................................................................................................................................ 2 Tutorial ................................................................................................................................................................ 3 Hello, world .................................................................................................................................................. 4 Properties ..................................................................................................................................................... 5 Project Hierarchies ......................................................................................................................................... 7 Dependent Targets .......................................................................................................................................... 8 Static and shared libaries ................................................................................................................................ 10 Conditions and alternatives ............................................................................................................................. 12 Prebuilt targets ............................................................................................................................................. 13 Overview ............................................................................................................................................................ 14 Concepts ..................................................................................................................................................... 15 Boost.Jam Language ..................................................................................................................................... 16 Con®guration .............................................................................................................................................. 19 Invocation ................................................................................................................................................... 21 Declaring Targets ......................................................................................................................................... 25 Projects ...................................................................................................................................................... 29 The Build Process ........................................................................................................................................ 31 Common tasks ..................................................................................................................................................... 33 Programs .................................................................................................................................................... 34 Libraries ..................................................................................................................................................... 35 Alias .......................................................................................................................................................... 37 Installing .................................................................................................................................................... 38 Testing ....................................................................................................................................................... 40 Custom commands ....................................................................................................................................... 42 Precompiled Headers .................................................................................................................................... 43 Generated headers ........................................................................................................................................ 44 Cross-compilation ........................................................................................................................................ 45 Reference ........................................................................................................................................................... 46 General information ...................................................................................................................................... 47 Builtin rules ................................................................................................................................................ 48 Builtin features ............................................................................................................................................ 50 Builtin tools ................................................................................................................................................ 54 Builtin modules ............................................................................................................................................ 65 Builtin classes .............................................................................................................................................. 71 Build process ............................................................................................................................................... 76 De®nitions .................................................................................................................................................. 78 Extender Manual .................................................................................................................................................. 82 Introduction ................................................................................................................................................ 83 Example: 1-to-1 generator .............................................................................................................................. 85 Target types ................................................................................................................................................. 86 Tools and generators ..................................................................................................................................... 88 Features ...................................................................................................................................................... 91 Main target rules .......................................................................................................................................... 94 Toolset modules ........................................................................................................................................... 95 Frequently Asked Questions ................................................................................................................................... 96 How do I get the current value of feature in Jam®le? .......................................................................................... 97 I am getting a "Duplicate name of actual target" error. What does that mean? .......................................................... 98 Accessing environment variables .................................................................................................................. 100 How to control properties order? ................................................................................................................... 101 How to control the library linking order on Unix? ............................................................................................ 102 Can I get capture external program output using a Boost.Jam variable? ................................................................ 103 How to get the project root (a.k.a. Jamroot) location? ........................................................................................ 104 How to change compilation ¯ags for one ®le? ................................................................................................. 105 Why are the dll-path and hardcode-dll-paths properties useful? .............................................................. 106 iii XML to PDF by RenderX XEP XSL-FO Formatter, visit us at http://www.renderx.com/ Boost.Build V2 User Manual Targets in site-con®g.jam ............................................................................................................................. 107 Header-only libraries ................................................................................................................................... 108 A. Boost.Jam Documentation ...............................................................................................................................