Changes between Initial Version and Version 1 of TestingOnBoost

Timestamp:

Feb 10, 2006, 4:57:13 PM (20 years ago)

Author:

ghost

Comment:

--

TestingOnBoost

@@ +1 @@
+= 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 configure one toolset you want to test with. For example:
+{{{
+using msvc ;
+}}}
+or
+{{{
+using gcc ;
+}}}
+This assumes that the compiler is in {{{PATH}}}.
+
+== 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.  
+
+=== Prerequisites ===
+
+ * Build the regression tools, by going to {{{tools/regression/build}}} and running {{{bjam}}}. The directory {{{run}}} should not contains 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 V2 ===
+
+ * 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.
+
+