diff options
author | Beman <bdawes@acm.org> | 2014-01-09 22:02:02 -0500 |
---|---|---|
committer | Beman <bdawes@acm.org> | 2014-01-09 22:02:02 -0500 |
commit | 81476350b0e0db30a61496a524c45cec738c447f (patch) | |
tree | 04c02529eec2d73041af2e7b4c749ae78bca4791 | |
parent | 497c625e347cb00921e8d3fa278bf8f415146f20 (diff) | |
download | boost-81476350b0e0db30a61496a524c45cec738c447f.tar.gz |
Initial commit. Untested.
-rw-r--r-- | tools/regression/doc/reports.html | 83 |
1 files changed, 83 insertions, 0 deletions
diff --git a/tools/regression/doc/reports.html b/tools/regression/doc/reports.html new file mode 100644 index 0000000000..94a581dfaa --- /dev/null +++ b/tools/regression/doc/reports.html @@ -0,0 +1,83 @@ +<html> + +<head> +<meta name="GENERATOR" content="Microsoft FrontPage 5.0"> +<meta name="ProgId" content="FrontPage.Editor.Document"> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>Running Regression Reports</title> +</head> + +<body> + <h1><img src="../../../boost.png" alt="boost.png (6897 bytes)" align= + "center" width="277" height="86" /> Running Regression Test Reports</h1> + + <h2>Introduction</h2> + <p>After initial setup, a script is run that:</p> + <h2>Prerequisites</h2> + <ul> + <li><b>Linux</b>. In theory it should be possible to run the run the reports + on most modern operating system, including OS X and Windows, but all testing + and current use has been on Linux.</li> + <li><b>Git</b> installed.</li> + <li>A C++ compiler installed.</li> + </ul> + <h2>Initial setup</h2> + <p>Run once only:</p> + <blockquote> + <pre>cd ~ # or some other directory of your choice +mkdir boost-reports # or some other name of your choice +cd boost-reports +mkdir trunk # TODO: change to develop | master | ? +git clone --recursive git@github.com:boostorg/boost.git boost +pushd boost +git checkout develop +git pull +git submodule foreach 'git +./bootstrap.sh +./b2 headers</pre> + </blockquote> + <h2>Build report generation program <code>boost_report</code></h2> + <p>This only has to be done when there is a change to the report generation + program.</p> + <blockquote> + <pre> +pushd ~/modular-boost/tools/regression/build +b2 boost_report +# find location of exectuable, then: +mv bin/gcc-4.8/release/boost_report ~/boost-reports +popd</pre> + </blockquote> + <h2>Run reports</h2> + <ul> + <li>Updates its internal procedures from the git public repository.</li> + <li>Downloads current result zip files from an ftp server.</li> + <li>Generates the HTML reports. (Now using a C++ program that is much faster + than the old XSLT process.)</li> + <li>Uploads a zip file containing the reports to a web server.</li> + </ul> + <p>To run:</p> + <blockquote> + <pre>boost/tools/regression/xsl_reports/build_results.sh develop</pre> + </blockquote> + <h2>To Do</h2> + <ul> + <li>build_results.sh should take care of updating boost_report if needed.</li> + <li>Avoid the clone --recursive; just install the core libraries (for some + definition of core libraries).</li> + <li>Add install options to tools/regression/build/Jamroot.jam?</li> + </ul> + <p> </p> + <hr> + + <p><font size="2">Revised + <!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B %Y" startspan -->09 January 2014<!--webbot bot="Timestamp" endspan i-checksum="32406" --></font></p> + + <p><font size="2">Copyright Beman Dawes 2014.</font></p> + + <p><font size="2">Distributed under the + <a href="http://www.boost.org/LICENSE_1_0.txt">Boost Software License, Version 1.0</a>.</font></p> + <p> </p> + +</body> + +</html>
\ No newline at end of file |