<commit_before># library_status
A tool for Boost.  It creates a table of all test results organized by test features

Purpose

Any time one considers using a library as large and complex as the Boost libraries, he must have a way of validating the the library functions in his environment. This should be done when the library is installed and anytime questions are raised regarding its applicability and/or its usage.
The procedures described here permit a user to run any combination of tests on any or all libraries and generate a set of convenient tables which show which libraries pass which tests under what conditions.

Preliminaries

Generating these tables requires a couple of utility programs: process_jam_log and library_status. These can be built by moving to the directory tools/regression/build and invoking bjam. If all goes well these utility programs will be found in the directory dist/bin. From there they should be moved to a place in the current path.
Running Tests for One Library

1) Start from your command line environment.
2) set the current directory to:<boost directory>/libs/<library name>/test
3) Invoke one of the following:
	../../../tools/regression/src/library_test (*nix).
	..\..\..\tools\regression\src\library_test (windows).
4) This will display short help message describing the how to set the command line arguments for the compilers and variants you want to appear in the final table.
5) Setting these arguments requires rudimentary knowledge of bjam usage. Hopefully, if you've arrived at this page you've gained the required knowledge during the installation and library build process.
6) Rerun the above command with the argument set accordingly.
7) When the command terminates, there should be a file named library_status.html
8) Display this file with any web browser.


This table was generated by invoking the following command line from within the .../libs/serialization/test directory:

../../../tools/regression/src/library_test --toolset=clang-darwin-03,clang-darwin-11,darwin4.9 address-model=64,32 link=static,shared variant=debug,release
<commit_msg>reversed extra wordage in readme<commit_after># library_status
A tool for Boost.  It creates a table of all test results organized by test features

Purpose

Any time one considers using a library as large and complex as the Boost libraries, he must have a way of validating the the library functions in his environment. This should be done when the library is installed and anytime questions are raised regarding its applicabililty and/or its usage.
The procedures described here permit a user to run any combination of tests on any or all libraries and generate a set of convenient tables which show which libraries pass which tests under what conditions.

Preliminaries

Generating these tables requires a couple of utility programs: process_jam_log and library_status. These can be built by moving to the directory tools/regression/build and invoking bjam. If all goes well these utility programs will be found in the directory dist/bin. From there they should be moved to a place in the current path.
Running Tests for One Library

1) Start from your command line environment.
2) set the current directory to:<boost directory>/libs/<library name>/test
3) Invoke one of the following:
	../../../tools/regression/src/library_test (*nix).
	..\..\..\tools\regression\src\library_test (windows).
4) This will display short help message describing the how to set the command line arguments for the compilers and variants you want to appear in the final table.
5) Setting these arguments requires rudimentary knowledge of bjam usage. Hopefully, if you've arrived at this page you've gained the required knowledge during the installation and library build process.
6) Rerun the above command with the argument set accordingly.
7) When the command terminates, there should be a file named library_status.html
8) Display this file with any web browser.


This table was generated by invoking the following command line from within the .../libs/serialization/test directory:

../../../tools/regression/src/library_test --toolset=clang-darwin-03,clang-darwin-11,darwin4.9 address-model=64,32 link=static,shared variant=debug,release

{'fraction_non_alphanumeric': 0.05340264650283554, 'fraction_numerical': 0.008506616257088847, 'mean_word_length': 4.5478374836173, 'pattern_counts': {'":': 0, '<': 7, '<?xml version=': 0, '>': 7, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '276208', 'n_tokens_mistral': 1042, 'n_tokens_neox': 989, 'n_words': 592}