Testing Boost.Build V2 on C++ Boost

This page describes how you can run C++ Boost regression tests with Boost.Build V2.

Configure

Go to tools/build/v2 directory of C++ Boost and open the file user-config.jam in an editor. Following comments there, configure one toolset you want to test with. For example:

using msvc ;

or

using gcc ;

This assumes that the compiler is in PATH.

You also need to configure the location of Python, for testing of Boost.Python library. Add the following to user-config.jam:

using python : 2.3 : /usr ;

Adjust the version number, and the installation root accordingly.

Verify regression tests setup

Go to the status directory and run bjam --v2 -n. You should see a list of command that would be executed. If you see any error message, report it.

Run the tests

Depending on time/space available you can either:

• Run just with Boost.Build V2
• Run with Boost.Build V1 and V2, comparing the differences.

For Linux, a script to run with V1 and V2 and compare the differences in available: attachment:"run_all.sh"​. It should be run from the status directory.

Prerequisites

• Build the regression tools, by going to tools/regression/build and running bjam. The directory boost/dist/bin should now contain two binaries: process_jam_log and compiler_status.

Running tests with V2

Go to the status directory.

• On Linux, run:

  bjam --v2 -d2 --dump-tests 2>&1 | tee bjam2.log
  cat bjam2.log | process_jam_log --v2 
  compiler_status --v2 ''boost-root'' boost_v2.html boost_v2_links.html
  

• On Windows, run:

  bjam --v2 -d2 --dump-tests > bjam2.log 2>&1
  process_jam_log --v2 < bjam2.log
  compiler_status --v2 ''boost-root'' boost_v2.html boost_v2_links.html
  

Running tests with V1

• On Linux, run:

  bjam -d2 --dump-tests 2>&1 | tee bjam1.log
  cat bjam2.log | process_jam_log
  compiler_status ''boost-root'' boost_v1.html boost_v1_links.html
  

• On Windows, run:

  bjam -d2 --dump-tests > bjam1.log 2>&1
  process_jam_log < bjam1.log
  compiler_status ''boost-root'' boost_v1.html boost_v1_links.html
  

Compare the results

• On Linux, run the following commands:

  cp boost_v1.html boost_v1_aux.html
  perl -pi -e 's/boost_v1_links/boost_v2_links/' boost_v1_aux.html
  diff -u boost_v1_aux.html boost_v2.html > boost.diff
  

• On windows, either perform the same actions by Windows tools, or send the boost_v1.html and boost_v2.html files to Vladimir Prus.