[Boost-commit] svn:boost r47726 - trunk/tools/build/v2/doc/src

From: jurko.gospodnetic_at_[hidden]
Date: 2008-07-23 12:21:52

Author: jurko
Date: 2008-07-23 12:21:51 EDT (Wed, 23 Jul 2008)
New Revision: 47726
URL: http://svn.boost.org/trac/boost/changeset/47726

Log:
Minor stylistic Boost Build documentation changes.
Text files modified: 
   trunk/tools/build/v2/doc/src/reference.xml |    60 ++++++++++++++++++++++++++--------------
   1 files changed, 39 insertions(+), 21 deletions(-)

Modified: trunk/tools/build/v2/doc/src/reference.xml
==============================================================================
--- trunk/tools/build/v2/doc/src/reference.xml	(original)
+++ trunk/tools/build/v2/doc/src/reference.xml	2008-07-23 12:21:51 EDT (Wed, 23 Jul 2008)
@@ -420,41 +420,55 @@
 
         <listitem>
           <para>
-            A feature that combines several low-level features, making
-            it easy to request common build configurations.
+            A feature combining several low-level features, making it easy to
+            request common build configurations.
           </para>
 
-          <para><emphasis role="bold">Allowed values:</emphasis> <literal>debug</literal>, <literal>release</literal>,
-            <literal>profile</literal>.</para>
+          <para>
+            <emphasis role="bold">Allowed values:</emphasis>
+            <literal>debug</literal>, <literal>release</literal>,
+            <literal>profile</literal>.
+          </para>
 
-          <para>The value <literal>debug</literal> expands to</para>
+          <para>
+            The value <literal>debug</literal> expands to
+          </para>
 
 <programlisting>
 &lt;optimization&gt;off &lt;debug-symbols&gt;on &lt;inlining&gt;off &lt;runtime-debugging&gt;on
 </programlisting>
 
-          <para>The value <literal>release</literal> expands to</para>
+          <para>
+            The value <literal>release</literal> expands to
+          </para>
 
 <programlisting>
 &lt;optimization&gt;speed &lt;debug-symbols&gt;off &lt;inlining&gt;full &lt;runtime-debugging&gt;off
 </programlisting>
 
-          <para>The value <literal>profile</literal> expands to the same as
-          <literal>release</literal>, plus:</para>
+          <para>
+            The value <literal>profile</literal> expands to the same as
+            <literal>release</literal>, plus:
+          </para>
 
 <programlisting>
 &lt;profiling&gt;on &lt;debug-symbols&gt;on
 </programlisting>
 
-          <para>User can define his own build variants using the <code>variant</code> rule from the <code>common</code>
-          module.</para>
+          <para>
+            Users can define their own build variants using the
+            <code>variant</code> rule from the <code>common</code> module.
+          </para>
 
-          <para><emphasis role="bold">Notee:</emphasis> Runtime
-          debugging is on in debug builds to suit the expectations of
-          people used to various IDEs.
-          <!-- Define "runtime debugging." Why will those people expect it to be on in debug builds? -->
+          <para>
+            <emphasis role="bold">Note:</emphasis> Runtime debugging is on in
+            debug builds to suit the expectations of people used to various
+            IDEs.
+            <!-- Define "runtime debugging". Why will those people expect it to
+            be on in debug builds? -->
           </para>
-        </listitem></varlistentry>
+        </listitem>
+      </varlistentry>
 
       <varlistentry id="bbv2.advanced.builtins.features.link">
         <term><literal>link</literal></term>
@@ -465,10 +479,11 @@
             <literal>static</literal></para>
 
           <simpara>
-            A feature that controls how libraries are built.
+            A feature controling how libraries are built.
           </simpara>
 
-        </listitem></varlistentry>
+        </listitem>
+      </varlistentry>
 
       <varlistentry id="bbv2.advanced.builtins.features.runtime-link">
         <indexterm><primary>runtime linking</primary></indexterm>
@@ -720,7 +735,10 @@
       <varlistentry><term><literal>instruction-set</literal></term>
         <indexterm><primary>instruction-set</primary></indexterm>
         <listitem>
-          <para>Allowed values for this feature depend on used toolset.</para>
+          <para>
+            <emphasis role="bold">Allowed values:</emphasis> depend on the used
+            toolset.
+          </para>
 
           <para>The <literal>instruction-set</literal> specifies for which
           specific instruction set the code should be generated.  The
@@ -970,9 +988,9 @@
             </varlistentry>
 
             <varlistentry>
-              <term><literal>setup-amd64></literal></term>
-              <term><literal>setup-i386></literal></term>
-              <term><literal>setup-ia64></literal></term>
+              <term><literal>setup-amd64</literal></term>
+              <term><literal>setup-i386</literal></term>
+              <term><literal>setup-ia64</literal></term>
 
               <listitem><para>The filename of the target platform specific
               environment setup script to run before invoking any of the tools