Image 2de73b6b83 Support for BestZ / Line of Sight / navmesh pathing 4 years ago
..
adv_scenarios 2de73b6b83 Support for BestZ / Line of Sight / navmesh pathing 4 years ago
closing_chapters 2de73b6b83 Support for BestZ / Line of Sight / navmesh pathing 4 years ago
doxygen 2de73b6b83 Support for BestZ / Line of Sight / navmesh pathing 4 years ago
examples 2de73b6b83 Support for BestZ / Line of Sight / navmesh pathing 4 years ago
html 2de73b6b83 Support for BestZ / Line of Sight / navmesh pathing 4 years ago
introduction 2de73b6b83 Support for BestZ / Line of Sight / navmesh pathing 4 years ago
prod_use 2de73b6b83 Support for BestZ / Line of Sight / navmesh pathing 4 years ago
runtime_configuration 2de73b6b83 Support for BestZ / Line of Sight / navmesh pathing 4 years ago
snippet 2de73b6b83 Support for BestZ / Line of Sight / navmesh pathing 4 years ago
test_organization 2de73b6b83 Support for BestZ / Line of Sight / navmesh pathing 4 years ago
test_output 2de73b6b83 Support for BestZ / Line of Sight / navmesh pathing 4 years ago
testing_tools 2de73b6b83 Support for BestZ / Line of Sight / navmesh pathing 4 years ago
tutorials 2de73b6b83 Support for BestZ / Line of Sight / navmesh pathing 4 years ago
Jamfile.v2 2de73b6b83 Support for BestZ / Line of Sight / navmesh pathing 4 years ago
README.md 2de73b6b83 Support for BestZ / Line of Sight / navmesh pathing 4 years ago
adv_scenarios.qbk 2de73b6b83 Support for BestZ / Line of Sight / navmesh pathing 4 years ago
doxygen_reference_generated_doc.xml 2de73b6b83 Support for BestZ / Line of Sight / navmesh pathing 4 years ago
test.qbk 2de73b6b83 Support for BestZ / Line of Sight / navmesh pathing 4 years ago
usage_recommendations.qbk 2de73b6b83 Support for BestZ / Line of Sight / navmesh pathing 4 years ago
usage_variants.qbk 2de73b6b83 Support for BestZ / Line of Sight / navmesh pathing 4 years ago

README.md

This folder contains the documentation for the Boost.Test library. Any contribution or submission to the library should be accompanied by the corresponding documentation.

The format of the documentation uses Quickbook.

How to build the documentation

In order to generate the documentation, the following is needed:

  • Docbook
  • Doxygen
  • xsltproc

Doxygen

Part of the documentation needs Doxygen. doxygen should be accessible from the PATH.

Docbook

Quickbook needs Docbook (XSL and XML) to be installed. Download and untar the docbook archives:

The directories $docbook_xsl_directory and $docbook_dtd_directory, respectively, will refer to the location of the deflated archive.

Download xsltproc

This program is needed by Docbook, in order to be able to transform XMLs into HTMLs. xsltproc should be accessible from the PATH.

Construct b2

Simply by typing in a console at the root of the Boost repository:

> ./bootstrap.[sh|bat]

Build the documentation

Running the following commands will construct the documentation with b2 and all the needed dependencies:

````

cd $boost_root/libs/test/doc ../../../b2 -sDOCBOOK_XSL_DIR=$docbook_xsl_directory -sDOCBOOK_DTD_DIR=$docbook_dtd_directory


It is possible to run directly

../../../b2 ```

but this results in a download from the Internet of the Docbook XLS and DTD, which is much slower.

Recommendations

  • Documentation is part of the "definition of done". A feature does not exist until it is implemented, tested, documented and reviewed.
  • It is highly recommended that each of your pull request comes with an updated documentation. Not doing so put this work on the shoulders of the maintainers and as a result, it would be likely that the pull request is not addressed in a timely manner.
  • Please also update the changelog for referencing your contribution
  • Every file should come with a copyright notice on the very beginning