Boost logo

Boost-Commit :

From: bdawes_at_[hidden]
Date: 2007-11-23 17:55:49

Author: bemandawes
Date: 2007-11-23 17:55:48 EST (Fri, 23 Nov 2007)
New Revision: 41319

Add the instructions formerly in the (now deleted) runner sub-directory
   trunk/tools/regression/doc/instructions.html (contents, props changed)
Text files modified:
   trunk/tools/regression/doc/index.html | 4 +++-
   1 files changed, 3 insertions(+), 1 deletions(-)

Modified: trunk/tools/regression/doc/index.html
--- trunk/tools/regression/doc/index.html (original)
+++ trunk/tools/regression/doc/index.html 2007-11-23 17:55:48 EST (Fri, 23 Nov 2007)
@@ -21,6 +21,8 @@
+ <li>Instructions for running the regression
+ tests</li>
     <li>process_jam_log.cpp -
     Processes the bjam outputs, creating a file named test_log.xml for each
     test encountered.</li>
@@ -49,4 +51,4 @@
   copy at <a href=
\ No newline at end of file

Added: trunk/tools/regression/doc/instructions.html
--- (empty file)
+++ trunk/tools/regression/doc/instructions.html 2007-11-23 17:55:48 EST (Fri, 23 Nov 2007)
@@ -0,0 +1,109 @@
+<meta http-equiv="Content-Language" content="en-us">
+<meta name="GENERATOR" content="Microsoft FrontPage 5.0">
+<meta name="ProgId" content="FrontPage.Editor.Document">
+<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
+<title>Running Boost Regression Tests</title>
+<link rel="stylesheet" type="text/css" href="../../../doc/html/minimal.css">
+<table border="0" cellpadding="5" cellspacing="0" style="border-collapse: collapse" bordercolor="#111111" width="831">
+ <tr>
+ <td width="277">
+<a href="../../../../index.htm">
+<img src="../../../boost.png" alt="boost.png (6897 bytes)" align="middle" width="277" height="86" border="0"></a></td>
+ <td width="531" align="middle">
+ <font size="7">Running Boost Regression Tests</font>
+ </td>
+ </tr>
+ <li>Python 2.3 or later.<br>
+ <li>Subversion 1.4 or later.<br>
+ <li>At least 5 gigabytes of disk space per compiler to be tested.</li>
+<h2>Step by step instructions</h2>
+ <li>Create a new directory for the branch you want to test.<br>
+ <li>Download the
+ <a href="">
+</a> script into that directory.<br>
+ <li>Run &quot;<code>python [options] [commands]</code>&quot;.</li>
+ <dd>
+ <pre>commands: cleanup, collect-logs, get-source, get-tools, patch,
+regression, setup, show-revision, test, test-clean, test-process,
+test-run, update-source, upload-logs
+ -h, --help show this help message and exit
+ --runner=RUNNER runner ID (e.g. 'Metacomm')
+ --comment=COMMENT an HTML comment file to be inserted in the
+ reports
+ --tag=TAG the tag for the results
+ --toolsets=TOOLSETS comma-separated list of toolsets to test with
+ --incremental do incremental run (do not remove previous
+ binaries)
+ --timeout=TIMEOUT specifies the timeout, in minutes, for a single
+ test run/compilation
+ --bjam-options=BJAM_OPTIONS
+ options to pass to the regression test
+ --bjam-toolset=BJAM_TOOLSET
+ bootstrap toolset for 'bjam' executable
+ --pjl-toolset=PJL_TOOLSET
+ bootstrap toolset for 'process_jam_log'
+ executable
+ --platform=PLATFORM
+ --user=USER Boost SVN user ID
+ --local=LOCAL the name of the boost tarball
+ --force-update=FORCE_UPDATE
+ do an SVN update (if applicable) instead of a
+ clean checkout, even when performing a full run
+ --have-source=HAVE_SOURCE
+ do neither a tarball download nor an SVN update;
+ used primarily for testing script changes
+ --proxy=PROXY HTTP proxy server address and port
+ (e.g.'<a rel="nofollow" href="'" target="_top">'</a>)
+ --ftp-proxy=FTP_PROXY
+ FTP proxy server (e.g. 'ftpproxy')
+ --dart-server=DART_SERVER
+ the dart server to send results to
+ --debug-level=DEBUG_LEVEL
+ debugging level; controls the amount of
+ debugging output printed
+ --send-bjam-log send full bjam log of the regression run
+ --mail=MAIL email address to send run notification to
+ --smtp-login=SMTP_LOGIN
+ STMP server address/login information, in the
+ following form:
+ &lt;user&gt;:&lt;password&gt;@&lt;host&gt;[:&lt;port&gt;]
+ --skip-tests=SKIP_TESTS
+ do not run bjam; used for testing script changes</pre>
+ </dd>
+<p>To test trunk use &quot;<code>--tag=trunk</code>&quot; (the default), and to test the
+release use &quot;<code>--tag=branches/release</code>&quot;. Or substitute any Boost tree
+of your choice.</p>
+<p>© Copyright Rene Rivera, 2007<br>
+Distributed under the Boost Software License, Version 1.0. See</p>
+<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%B %d, %Y" startspan -->November 23, 2007<!--webbot bot="Timestamp" endspan i-checksum="39587" --> </font>
\ No newline at end of file

Boost-Commit list run by bdawes at, david.abrahams at, gregod at, cpdaniel at, john at