8567c2ae8a
* topic/8707-8834-junit-several-loggers: Change log update Documentation JUnit default output stream Logger tests: overriding the output_stream_logger matching algorithm and changing the format of the messages sent by the framework Combined logger: CLA handling and stream/log level per formatter Junit logger: integration into the set of loggers JUnit logger: implementation Multiple logger: entry in progress now being per logger as well Multiple logger: now enabling a logger by its format Multiple logger: breaking changes in the API in order to be able to add a logger per format on the fly Loggers: now handling abort signal as well Multiple loggers: having several loggers at the same time Algorithm: replace all strings with/out wildcards output_test_stream: being able to override the match_pattern method by making it virtual (+ other functions) output_test_stream: improved messages on error Framework: fixing the time associated to each test unit issues with VS placeholders
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 [http://www.boost.org/tools/quickbook/index.html 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:
- Docbook XSL that can be found here: http://sourceforge.net/projects/docbook/files/docbook-xsl/
- Docbook DTD that can be found here: http://www.docbook.org/schemas/
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 bjam
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 bjam 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