From 81476350b0e0db30a61496a524c45cec738c447f Mon Sep 17 00:00:00 2001 From: Beman Date: Thu, 9 Jan 2014 22:02:02 -0500 Subject: Initial commit. Untested. --- tools/regression/doc/reports.html | 83 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 83 insertions(+) create mode 100644 tools/regression/doc/reports.html 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 @@ + + + + + + +Running Regression Reports + + + +

Running Regression Test Reports

+ +

Introduction

After initial setup, a script is run that:

Prerequisites

Linux. 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.
Git installed.
A C++ compiler installed.

Initial setup

Run once only:

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

Build report generation program `boost_report`

This only has to be done when there is a change to the report generation + program.

+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

Run reports

Updates its internal procedures from the git public repository.
Downloads current result zip files from an ftp server.
Generates the HTML reports. (Now using a C++ program that is much faster + than the old XSLT process.)
Uploads a zip file containing the reports to a web server.

To run:

boost/tools/regression/xsl_reports/build_results.sh develop

To Do

build_results.sh should take care of updating boost_report if needed.
Avoid the clone --recursive; just install the core libraries (for some + definition of core libraries).
Add install options to tools/regression/build/Jamroot.jam?

+ +

Revised + 09 January 2014

+ +

Distributed under the + Boost Software License, Version 1.0.

+ + + + \ No newline at end of file -- cgit v1.2.1