From 3677b53c2449cc3fa4c912421b6a5c12994256e0 Mon Sep 17 00:00:00 2001 From: Jan Bouwer Date: Wed, 30 Aug 2023 10:46:23 +1000 Subject: [PATCH 1/2] Documentation & comment updates. * test/test-config-example.jam (Comment): Changed 'test-system.jam' to 'test-config.jam' - Consistency with doco elsewhere & code in 'test/BoostBuild.py'. * test/test_system.html Updated instructions to reflect broken Python2 compatibility ( 9a96cbab20 - "test_all.py", line 97: s = f"\r{s}" ) and spelling fixes. --- test/test-config-example.jam | 2 +- test/test_system.html | 23 ++++++++++++++--------- 2 files changed, 15 insertions(+), 10 deletions(-) diff --git a/test/test-config-example.jam b/test/test-config-example.jam index 269683a69b..8c2647693e 100644 --- a/test/test-config-example.jam +++ b/test/test-config-example.jam @@ -4,7 +4,7 @@ # Skeleton for test configuration. If your local configuration -# interferes with testing, rename this files to 'test-system.jam' +# interferes with testing, rename this file to 'test-config.jam' # and tweak it. When tests are run, only this file will be loaded, # while site-config.jam and user-config.jam will be ignored. diff --git a/test/test_system.html b/test/test_system.html index e7f5694e1f..38a4273044 100644 --- a/test/test_system.html +++ b/test/test_system.html @@ -94,8 +94,8 @@

A testing system for B2

Introduction for users

The testing system for B2 is a small set of Python modules and - scripts for automatically testing user-obversable behaviour. It uses - components from testing systems of Scons + scripts for automatically testing user-observable behaviour. It uses + components from testing systems of SCons and Subversion, together with some additional functionality.

@@ -105,8 +105,8 @@

Introduction for users

  • Get the source tree of B2 (located at tools/build in Boost)
  • -
  • Have Python installed. Version - 2.1 is known to work.
  • +
  • Have Python 3 installed. Prior + versions are no longer compatible.
  • Build Boost.Jam. See $boost_build_root/engine/index.html for @@ -131,8 +131,13 @@

    Introduction for users

    Examples:

    -python test_all.py
    -python generators_test.py
    +./test_all.py
    +./generators_test.py
    +
    +or +
    +python3 test_all.py
    +python3 generators_test.py
     

    If everything is OK, you will see a list of passed tests. Otherwise, a @@ -144,8 +149,8 @@

    Command line options

    you can specify a specific one on the command line:

    -python test_all.py borland
    -python generators_test.py msvc-7.1
    +python3 test_all.py borland
    +python3 generators_test.py msvc-7.1
     

    Other test script flags you can specify on the command line are:

    @@ -173,7 +178,7 @@

    Introduction for developers