diff options
Diffstat (limited to 'doc/html/bbv2/overview.html')
-rw-r--r-- | doc/html/bbv2/overview.html | 48 |
1 files changed, 24 insertions, 24 deletions
diff --git a/doc/html/bbv2/overview.html b/doc/html/bbv2/overview.html index 76620f7d22..c096178023 100644 --- a/doc/html/bbv2/overview.html +++ b/doc/html/bbv2/overview.html @@ -130,8 +130,8 @@ add_program ("a", "a.c") </p> <p> In order to support true multivariant builds, Boost.Build introduces the concept of a - <a class="indexterm" name="idp636656384"></a> - <a class="indexterm" name="idp636657744"></a> + <a class="indexterm" name="idp617564320"></a> + <a class="indexterm" name="idp617565680"></a> <em class="firstterm">metatarget</em>—an object that is created when the build description is parsed and can be called later with specific build properties to generate actual targets. @@ -158,7 +158,7 @@ b2 toolset=gcc toolset=msvc </p> <p> Another key concept is - <a class="indexterm" name="idp636664096"></a> + <a class="indexterm" name="idp617572032"></a> <em class="firstterm">build property</em>. A build property is a variable that affects the build process. It can be specified on the command line, and is passed when calling a metatarget. While all build tools have a similar mechanism, @@ -166,7 +166,7 @@ b2 toolset=gcc toolset=msvc and providing a large set of properties with portable semantics. </p> <p> - The final concept is <a class="indexterm" name="idp636666448"></a> + The final concept is <a class="indexterm" name="idp617574384"></a> <em class="firstterm">property propagation</em>. Boost.Build does not require that every metatarget is called with the same properties. Instead, the "top-level" metatargets are called with the properties specified on the command line. @@ -191,7 +191,7 @@ b2 toolset=gcc toolset=msvc <p> <a class="link" href="../">Boost.Jam</a> has an interpreted, procedural language. On the lowest level, a <a class="link" href="../">Boost.Jam - </a> program consists of variables and <a class="indexterm" name="idp636675776"></a> <em class="firstterm">rules</em> (the Jam term for + </a> program consists of variables and <a class="indexterm" name="idp617583712"></a> <em class="firstterm">rules</em> (the Jam term for functions). They are grouped into modules—there is one global module and a number of named modules. Besides that, a <a class="link" href="../">Boost.Jam</a> program contains classes and class instances. @@ -792,7 +792,7 @@ b2 toolset=gcc variant=debug optimization=space The complete list of features can be found in <a class="xref" href="reference.html#bbv2.overview.builtins.features" title="Builtin features">the section called “Builtin features”</a>. The most common features are summarized below.</p> <div class="table"> -<a name="idp636859728"></a><p class="title"><b>Table 49.2. </b></p> +<a name="idp617767680"></a><p class="title"><b>Table 49.2. </b></p> <div class="table-contents"><table class="table"> <colgroup> <col> @@ -911,11 +911,11 @@ b2 include=static,shared <div class="titlepage"><div><div><h3 class="title"> <a name="bbv2.overview.targets"></a>Declaring Targets</h3></div></div></div> <div class="toc"><dl class="toc"> -<dt><span class="section"><a href="overview.html#idp636916720">Name</a></span></dt> -<dt><span class="section"><a href="overview.html#idp636922448">Sources</a></span></dt> +<dt><span class="section"><a href="overview.html#idp617824672">Name</a></span></dt> +<dt><span class="section"><a href="overview.html#idp617830400">Sources</a></span></dt> <dt><span class="section"><a href="overview.html#bbv2.overview.targets.requirements">Requirements</a></span></dt> -<dt><span class="section"><a href="overview.html#idp636958768">Default Build</a></span></dt> -<dt><span class="section"><a href="overview.html#idp636961584">Additional Information</a></span></dt> +<dt><span class="section"><a href="overview.html#idp617866656">Default Build</a></span></dt> +<dt><span class="section"><a href="overview.html#idp617869472">Additional Information</a></span></dt> </dl></div> <p><a name="bbv2.overview.targets.main"></a> A <em class="firstterm">Main target</em> is a user-defined named @@ -924,9 +924,9 @@ b2 include=static,shared target rules described in <a class="xref" href="reference.html#bbv2.reference.rules" title="Builtin rules">the section called “Builtin rules”</a>. The user can also declare custom main target rules as shown in <a class="xref" href="extender.html#bbv2.extending.rules" title="Main target rules">the section called “Main target rules”</a>. </p> -<a class="indexterm" name="idp636900048"></a><p>Most main target rules in Boost.Build have the same common +<a class="indexterm" name="idp617808000"></a><p>Most main target rules in Boost.Build have the same common signature:</p> -<a class="indexterm" name="idp636901696"></a><a name="bbv2.main-target-rule-syntax"></a><pre class="programlisting"> +<a class="indexterm" name="idp617809648"></a><a name="bbv2.main-target-rule-syntax"></a><pre class="programlisting"> rule <em class="replaceable"><code>rule-name</code></em> ( main-target-name : sources + : @@ -974,7 +974,7 @@ rule <em class="replaceable"><code>rule-name</code></em> ( </p> <div class="section"> <div class="titlepage"><div><div><h4 class="title"> -<a name="idp636916720"></a>Name</h4></div></div></div> +<a name="idp617824672"></a>Name</h4></div></div></div> <p>The name of main target has two purposes. First, it's used to refer to this target from other targets and from command line. Second, it's used to compute the names of the generated files. Typically, filenames are obtained from main target name by appending system-dependent suffixes and @@ -994,7 +994,7 @@ obj test.debug : test.cpp : <variant>debug ; </div> <div class="section"> <div class="titlepage"><div><div><h4 class="title"> -<a name="idp636922448"></a>Sources</h4></div></div></div> +<a name="idp617830400"></a>Sources</h4></div></div></div> <p>The list of sources specifies what should be processed to get the resulting targets. Most of the time, it's just a list of files. Sometimes, you'll want to automatically construct the @@ -1041,7 +1041,7 @@ exe c : c.cpp /boost/program_options//program_options ; <div class="section"> <div class="titlepage"><div><div><h4 class="title"> <a name="bbv2.overview.targets.requirements"></a>Requirements</h4></div></div></div> -<a class="indexterm" name="idp636934160"></a><p>Requirements are the properties that should always be present when +<a class="indexterm" name="idp617842112"></a><p>Requirements are the properties that should always be present when building a target. Typically, they are includes and defines: </p> <pre class="programlisting"> @@ -1060,7 +1060,7 @@ obj main : main.cpp : <optimization>off ; <p> </p> <p><a name="bbv2.overview.targets.requirements.conditional"></a> - <a class="indexterm" name="idp636938896"></a> + <a class="indexterm" name="idp617846848"></a> Sometimes, particular relationships need to be maintained among a target's build properties. This can be achieved with <em class="firstterm">conditional @@ -1092,7 +1092,7 @@ lib network : network.cpp <p> </p> <p><a name="bbv2.overview.targets.requirements.indirect"></a> - <a class="indexterm" name="idp636948336"></a> + <a class="indexterm" name="idp617856224"></a> A more powerful variant of conditional requirements is <em class="firstterm">indirect conditional requirements</em>. You can provide a rule that will be called with the current build properties and can compute additional properties @@ -1149,7 +1149,7 @@ exe test3 : test3.cpp : -<threading>multi ; </div> <div class="section"> <div class="titlepage"><div><div><h4 class="title"> -<a name="idp636958768"></a>Default Build</h4></div></div></div> +<a name="idp617866656"></a>Default Build</h4></div></div></div> <p>The <code class="varname">default-build</code> parameter is a set of properties to be used if the build request does not otherwise specify a value for features in the set. For example: @@ -1166,7 +1166,7 @@ exe hello : hello.cpp : : <threading>multi ; </div> <div class="section"> <div class="titlepage"><div><div><h4 class="title"> -<a name="idp636961584"></a>Additional Information</h4></div></div></div> +<a name="idp617869472"></a>Additional Information</h4></div></div></div> <p> The ways a target is built can be so different that describing them using conditional requirements would be @@ -1259,7 +1259,7 @@ project tennis </p> <div class="table"> -<a name="idp636984208"></a><p class="title"><b>Table 49.3. </b></p> +<a name="idp617892032"></a><p class="title"><b>Table 49.3. </b></p> <div class="table-contents"><table class="table" summary=""> <colgroup> <col> @@ -1360,8 +1360,8 @@ project tennis <a name="bbv2.overview.build_process"></a>The Build Process</h3></div></div></div> <div class="toc"><dl class="toc"> <dt><span class="section"><a href="overview.html#bbv2.overview.build_request">Build Request</a></span></dt> -<dt><span class="section"><a href="overview.html#idp637020176">Building a main target</a></span></dt> -<dt><span class="section"><a href="overview.html#idp637032256">Building a Project</a></span></dt> +<dt><span class="section"><a href="overview.html#idp617928000">Building a main target</a></span></dt> +<dt><span class="section"><a href="overview.html#idp617940016">Building a Project</a></span></dt> </dl></div> <p>When you've described your targets, you want Boost.Build to run the right tools and create the needed targets. @@ -1418,7 +1418,7 @@ b2 app1 lib1//lib1 gcc debug optimization=full </div> <div class="section"> <div class="titlepage"><div><div><h4 class="title"> -<a name="idp637020176"></a>Building a main target</h4></div></div></div> +<a name="idp617928000"></a>Building a main target</h4></div></div></div> <p>When you request, directly or indirectly, a build of a main target with specific requirements, the following steps are done. Some brief explanation is provided, and more details are given in <a class="xref" href="reference.html#bbv2.reference.buildprocess" title="Build process">the section called “Build process”</a>. @@ -1478,7 +1478,7 @@ b2 app1 lib1//lib1 gcc debug optimization=full </div> <div class="section"> <div class="titlepage"><div><div><h4 class="title"> -<a name="idp637032256"></a>Building a Project</h4></div></div></div> +<a name="idp617940016"></a>Building a Project</h4></div></div></div> <p>Often, a user builds a complete project, not just one main target. In fact, invoking <span class="command"><strong>b2</strong></span> without arguments |