mirror of
https://github.com/boostorg/build.git
synced 2026-02-15 13:02:11 +00:00
Spelling corrections.
Patch from Jurko Gospodneti. [SVN r25869]
This commit is contained in:
@@ -91,7 +91,7 @@
|
||||
<b>Alpha</b> (TBD)
|
||||
|
||||
<p>Optimization. Using buildable tools: consider using bison, which
|
||||
is itself build with Boost.Build.</p>
|
||||
is itself built with Boost.Build.</p>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
|
||||
@@ -36,7 +36,7 @@
|
||||
<listitem>
|
||||
<para>Finally, using build request specified on the command line,
|
||||
Boost.Build decides which targets should be built, and how. That
|
||||
information is passes back to Boost.Jam, which takes care of
|
||||
information is passed back to Boost.Jam, which takes care of
|
||||
actually running commands.</para>
|
||||
</listitem>
|
||||
</orderedlist>
|
||||
@@ -115,13 +115,13 @@ using gcc : 3.4 : g++-3.4 ;
|
||||
using gcc : 3.2 : g++-3.2 ;
|
||||
</programlisting>
|
||||
Note that in the first call to "using", the compiler found in path
|
||||
will be used, and there's ne need to explicitly specify the command.
|
||||
will be used, and there's no need to explicitly specify the command.
|
||||
</para>
|
||||
|
||||
<para>As shown above, both "version" and "invocation command" parameters
|
||||
are optional, but there's important restriction: if you configure the same
|
||||
compiler more then once, you must pass the "version" parameter every
|
||||
time. For example, the following is not allowed:
|
||||
are optional, but there's an important restriction: if you configure the
|
||||
same compiler more then once, you must pass the "version" parameter
|
||||
every time. For example, the following is not allowed:
|
||||
<programlisting>
|
||||
using gcc ;
|
||||
using gcc : 3.4 : g++-3.4 ;
|
||||
@@ -177,7 +177,7 @@ using gcc : 3.4 : : <compileflags>-m64 <linkflags>-m64 ;
|
||||
|
||||
<para>In addition to Jamfiles, Boost.Build has another user-editable
|
||||
file, project-root.jam, which is mostly usefull to declare constants
|
||||
global to all the projects. It is also describe <link
|
||||
global to all the projects. It is described in more detail <link
|
||||
linkend="bbv2.advanced.project-root">below</link>.
|
||||
</para>
|
||||
|
||||
@@ -350,7 +350,7 @@ function-name main-target-name
|
||||
<simpara>
|
||||
"usage-requirements" is the list of properties that will be
|
||||
propagated to all main targets that use this one, i.e. to all
|
||||
dependedents.
|
||||
dependents.
|
||||
</simpara>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
@@ -410,12 +410,12 @@ exe c : c.cpp /boost/program_options//program_opions ;
|
||||
<link linkend="bbv2.tutorial.conditions">tutorial</link>.
|
||||
</para>
|
||||
|
||||
<para>Sometimes a main target is really needed only by some other
|
||||
main target. E.g. a rule that declares test-suite uses a main
|
||||
target that represent test, but those main targets are rarely
|
||||
needed by themself.</para>
|
||||
<para>Sometimes a main target is really needed only by some other main
|
||||
target. For example, a rule that declares a test-suite uses a main
|
||||
target that represent test, but those main targets are rarely needed
|
||||
by themself.</para>
|
||||
|
||||
<para>It possible to declare target inline, i.e. the "sources"
|
||||
<para>It is possible to declare target inline, i.e. the "sources"
|
||||
parameter may include call to other main rules. For example:</para>
|
||||
|
||||
<programlisting>
|
||||
@@ -450,7 +450,7 @@ project id : <attributes> ;
|
||||
</programlisting>
|
||||
Here, attributes is a sequence of (attribute-name,
|
||||
attribute-value) pairs. The list of attribute names along with its
|
||||
handling is also shown in the table below. For example, it it
|
||||
handling is also shown in the table below. For example, it is
|
||||
possible to write:
|
||||
<programlisting>
|
||||
project tennis
|
||||
@@ -660,7 +660,7 @@ project tennis
|
||||
project-root can be merged together. To achieve this effect, the
|
||||
project root file should call the <literal>project</literal> rule. The
|
||||
semantic is precisely the same as if the call was made in
|
||||
Jamfile, except that project-root.jam will start serve as
|
||||
Jamfile, except that project-root.jam will start to serve as
|
||||
Jamfile. The Jamfile in the directory of project-root.jam will be
|
||||
ignored, and project-root.jam will be able to declare main
|
||||
targets as usual.</para>
|
||||
@@ -725,7 +725,7 @@ should be absolute project id.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
The command line specifies which targets to built and which what
|
||||
The command line specifies which targets to build and with what
|
||||
properties. For example:
|
||||
<programlisting>
|
||||
bjam app1 lib1//lib1 toolset=gcc variant=debug optimization=full
|
||||
@@ -738,7 +738,7 @@ bjam app1 lib1//lib1 toolset=gcc variant=debug optimization=full
|
||||
<programlisting>
|
||||
bjam app1 lib1//lib1 gcc debug optimization=full
|
||||
</programlisting>
|
||||
The complete syntax which had some additional shortcuts if described <link
|
||||
The complete syntax which has some additional shortcuts if described <link
|
||||
linkend="bbv2.reference.commandline">here</link>.
|
||||
</para>
|
||||
|
||||
@@ -838,7 +838,7 @@ lib b : : <variant>debug <file>/pool/debug/b.so ;
|
||||
For convenience, the following syntax is allowed:
|
||||
<programlisting>
|
||||
lib z ;
|
||||
lib giu db aux ;
|
||||
lib gui db aux ;
|
||||
</programlisting>
|
||||
and is does exactly the same as:
|
||||
<programlisting>
|
||||
@@ -865,7 +865,7 @@ lib png : z : <name>png ;
|
||||
library, (say, <code>b</code>) is linked dynamically, the <code>b</code>
|
||||
library will be incorporated in <code>a</code>. (If <code>b</code>
|
||||
is dynamic library as well, then <code>a</code> will only refer to
|
||||
it, and don't include any extra code.) When the <code>a</code>
|
||||
it, and not include any extra code.) When the <code>a</code>
|
||||
library is linked statically, Boost.Build will assure that all
|
||||
executables which link to <code>a</code> will also link to
|
||||
<code>b</code>.
|
||||
@@ -1048,7 +1048,7 @@ unit-test helpers_test : helpers_test.cpp helpers ;
|
||||
</programlisting>
|
||||
|
||||
<para><emphasis role="bold">Rationale:</emphasis> Runtime debugging is on in debug build
|
||||
so suit expectations of people used various IDEs. It's
|
||||
to suit expectations of people used various IDEs. It's
|
||||
assumed other folks don't have any specific expectation in
|
||||
this point.</para>
|
||||
</listitem></varlistentry>
|
||||
|
||||
@@ -46,7 +46,7 @@
|
||||
<literal><toolset>gcc-3.0.1</literal>.</para>
|
||||
|
||||
<para>A <emphasis>property set</emphasis> is a set of properties (i.e. a
|
||||
collection without dublicates), for instance:
|
||||
collection without duplicates), for instance:
|
||||
<literal><toolset>gcc <runtime-link>static</literal>.</para>
|
||||
|
||||
<para>A <emphasis>property path</emphasis> is a property set whose elements have
|
||||
@@ -525,7 +525,7 @@ part should have the either the form
|
||||
<emphasis>feature-name</emphasis>=<emphasis>feature-value1</emphasis>[","<emphasis>feature-valueN</emphasis>]*
|
||||
</programlisting>
|
||||
|
||||
or, in case of implict feature
|
||||
or, in case of implicit feature
|
||||
|
||||
<programlisting>
|
||||
<emphasis>feature-value1</emphasis>[","<emphasis>feature-valueN</emphasis>;]*
|
||||
@@ -611,7 +611,7 @@ linked binaries would be created.
|
||||
<row>
|
||||
<entry><literal>--no-error-backtrace</literal></entry>
|
||||
|
||||
<entry>Don't print backtrace on errors. Primary usefull for
|
||||
<entry>Don't print backtrace on errors. Primary useful for
|
||||
testing.</entry>
|
||||
</row>
|
||||
|
||||
|
||||
@@ -235,7 +235,7 @@ top/
|
||||
|
||||
the project root is <filename>top/</filename>. Because there is
|
||||
no <filename>Jamfile</filename> in
|
||||
<filename>top/lib/</filename>, the projects in
|
||||
<filename>top/util/</filename>, the projects in
|
||||
<filename>top/src/</filename> and
|
||||
<filename>top/util/foo/</filename> are immediate children of the
|
||||
root project.
|
||||
@@ -550,7 +550,7 @@ exe e10 : e10.cpp foo ;
|
||||
<para>The first mechanism is called <firstterm>conditinal
|
||||
requirement</firstterm>. For example, you might want to set specific
|
||||
defines when the library is build as shared, or you have your own define
|
||||
to be used in relese mode. Here's a piece of Jamfile.
|
||||
to be used in release mode. Here's a piece of Jamfile.
|
||||
<programlisting>
|
||||
lib network : network.cpp
|
||||
: <link>shared:<define>NEWORK_LIB_SHARED
|
||||
@@ -565,7 +565,7 @@ lib network : network.cpp
|
||||
<para>
|
||||
Sometimes different variant of a target are so different, that
|
||||
describing them using conditional requirements would be hard. Imagine
|
||||
that a library has different sources on two two supported toolsets, and
|
||||
that a library has different sources on two supported toolsets, and
|
||||
dummy implementation for all the other toolset. We can express this
|
||||
situation using <firstterm>target alternatives</firstterm>:
|
||||
<programlisting>
|
||||
@@ -609,7 +609,7 @@ lib lib2
|
||||
If "app" binary should use "lib2", we can write:
|
||||
|
||||
<programlisting>
|
||||
exe app : app.cpp /util/foo//lib2 ../util/lib2//lib2 ;
|
||||
exe app : app.cpp ../util/lib2//lib2 ;
|
||||
</programlisting>
|
||||
|
||||
If we build release version of "app", then it will be linked
|
||||
@@ -643,7 +643,7 @@ lib zlib : : <name>z_d <variant>debug ;
|
||||
version of zlib, but for other libraries this is quite reasonable.
|
||||
</para>
|
||||
|
||||
<para>More advanced use of prebuilt target is descibed in <ulink
|
||||
<para>More advanced use of prebuilt target is described in <ulink
|
||||
url="doc/recipes.html#site_config_targets">recipes</ulink>.</para>
|
||||
|
||||
</section>
|
||||
|
||||
Reference in New Issue
Block a user