Subject: [Boost-commit] svn:boost r68269 - website/public_html/live/development
From: dnljms_at_[hidden]
Date: 2011-01-19 04:02:46
Author: danieljames
Date: 2011-01-19 04:02:45 EST (Wed, 19 Jan 2011)
New Revision: 68269
URL: http://svn.boost.org/trac/boost/changeset/68269
Log:
Merge Jim Bell's changes to 'running regression tests'.
Properties modified:
website/public_html/live/development/ (props changed)
Text files modified:
website/public_html/live/development/running_regression_tests.html | 52 +++++++++++++++++++++++++++++++++------
1 files changed, 44 insertions(+), 8 deletions(-)
Modified: website/public_html/live/development/running_regression_tests.html
==============================================================================
--- website/public_html/live/development/running_regression_tests.html (original)
+++ website/public_html/live/development/running_regression_tests.html 2011-01-19 04:02:45 EST (Wed, 19 Jan 2011)
@@ -28,11 +28,47 @@
<h1>Running Boost Regression Tests</h1>
</div>
+ <div class="section-title">
+ <h2>Running Regression Tests Locally</h2>
+ </div>
+
+ <div class="section-title">
+ <p><strong><em>It's easy to run regression tests on your Boost
+ distribution.</em></strong></p>
+
+ <p>To run a library's regression tests, run Boost's <a href=
+ "/doc/tools/build/doc/html/jam/usage.html"><tt>bjam</tt></a>
+ utility from that library's
+ <tt>libs/<em><library></em>/test</tt> directory. To run a
+ single test, specify its name (as found in Jamfile.v2) on the
+ command line.</p>
+
+ <p>See the <a href=
+ "/doc/libs/release/more/getting_started/index.html">Getting
+ Started guide</a> for help building or downloading
+ <tt>bjam</tt> for your platform, and navigating your Boost
+ distribution.</p>
+
+ <p>To run every library's regression tests, run <tt>bjam</tt>
+ from Boost's <tt>/status</tt> directory.</p>
+
+ <p>To run Boost.Build's regression tests, run "<tt>python
+ test_all.py</tt>" from Boost's <tt>tools/build/v2/test</tt>
+ directory. (Python 2.3 ≤ version < 3.0 required.)</p>
+ </div>
+
+ <div class="section-title">
+ <h2>Running Boost's Automated Regression and Reporting</h2>
+ </div>
+
<div class="section-body">
- <h2>Requirements</h2>
+ <p>This runs all regressions and reports the results back to
+ the Boost community.</p>
+
+ <h3>Requirements</h3>
<ul>
- <li>Python 2.3 or later.</li>
+ <li>Python (2.3 ≤ version < 3.0).</li>
<li>Subversion 1.4 or later (optional).</li>
@@ -40,7 +76,7 @@
tested.</li>
</ul>
- <h2>Step by step instructions</h2>
+ <h3>Step by step instructions</h3>
<ol>
<li>Create a new directory for the branch you want to
@@ -77,7 +113,7 @@
python run.py ... <strong>--proxy=http://www.someproxy.com:3128>
</pre>
- <h2>Options</h2>
+ <h3>Options</h3>
<pre>
commands: cleanup, collect-logs, get-source, get-tools, patch, regression,
setup, show-revision, test, test-boost-build, test-clean, test-process, test-
@@ -130,7 +166,7 @@
"<code>--tag=branches/release</code>". Or substitute any Boost
tree of your choice.</p>
- <h2>Details</h2>
+ <h3>Details</h3>
<p>The regression run procedure will:</p>
@@ -160,7 +196,7 @@
all submitted test runs and publish them at <a href=
"testing.html#RegressionTesting">various locations</a>.</p>
- <h2>Advanced use</h2>
+ <h3>Advanced use</h3>
<h3>Providing detailed information about your environment</h3>
@@ -225,13 +261,13 @@
<tt>patch_boost</tt> script, and, if found, execute it after
obtaining the Boost sources.</p>
- <h2>Feedback</h2>
+ <h3>Feedback</h3>
<p>Please send all comments/suggestions regarding this document
and the testing procedure itself to the <a href=
"/community/groups.html#testing">Boost Testing list</a>.</p>
- <h2>Notes</h2>
+ <h3>Notes</h3>
<p><a id="runnerid1" name="runnerid1">[1]</a> If you are
running regressions interlacingly with a different set of