2013-10-18 08:52:38 +02:00
|
|
|
# Contributing to Catch
|
|
|
|
|
|
2017-01-10 08:35:54 +01:00
|
|
|
So you want to contribute something to Catch? That's great! Whether it's a bug fix, a new feature, support for
|
|
|
|
|
additional compilers - or just a fix to the documentation - all contributions are very welcome and very much appreciated.
|
|
|
|
|
Of course so are bug reports and other comments and questions.
|
2013-10-18 08:52:38 +02:00
|
|
|
|
2017-01-10 08:35:54 +01:00
|
|
|
If you are contributing to the code base there are a few simple guidelines to keep in mind. This also includes notes to
|
|
|
|
|
help you find your way around. As this is liable to drift out of date please raise an issue or, better still, a pull
|
|
|
|
|
request for this file, if you notice that.
|
2013-10-18 08:52:38 +02:00
|
|
|
|
2014-08-20 20:03:31 +02:00
|
|
|
## Branches
|
|
|
|
|
|
2017-01-10 08:35:54 +01:00
|
|
|
Ongoing development is currently on _master_. At some point an integration branch will be set-up and PRs should target
|
|
|
|
|
that - but for now it's all against master. You may see feature branches come and go from time to time, too.
|
2014-08-20 20:03:31 +02:00
|
|
|
|
2013-10-18 08:52:38 +02:00
|
|
|
## Directory structure
|
|
|
|
|
|
2017-01-10 08:35:54 +01:00
|
|
|
_Users_ of Catch primarily use the single header version. _Maintainers_ should work with the full source (which is still,
|
|
|
|
|
primarily, in headers). This can be found in the `include` folder. There are a set of test files, currently under
|
|
|
|
|
`projects/SelfTest`. The test app can be built via CMake from the `CMakeLists.txt` file in the root, or you can generate
|
|
|
|
|
project files for Visual Studio, XCode, and others (instructions in the `projects` folder). If you have access to CLion
|
|
|
|
|
that can work with the CMake file directly.
|
2013-10-18 08:52:38 +02:00
|
|
|
|
2017-01-10 08:35:54 +01:00
|
|
|
As well as the runtime test files you'll also see a `SurrogateCpps` directory under `projects/SelfTest`.
|
|
|
|
|
This contains a set of .cpp files that each `#include` a single header.
|
|
|
|
|
While these files are not essential to compilation they help to keep the implementation headers self-contained.
|
|
|
|
|
At time of writing this set is not complete but has reasonable coverage.
|
|
|
|
|
If you add additional headers please try to remember to add a surrogate cpp for it.
|
2013-10-18 08:52:38 +02:00
|
|
|
|
2017-01-10 08:35:54 +01:00
|
|
|
The other directories are `scripts` which contains a set of python scripts to help in testing Catch as well as
|
|
|
|
|
generating the single include, and `docs`, which contains the documentation as a set of markdown files.
|
2013-10-18 08:52:38 +02:00
|
|
|
|
2017-01-10 08:35:54 +01:00
|
|
|
__When submitting a pull request please do not include changes to the single include, or to the version number file
|
|
|
|
|
as these are managed by the scripts!__
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
*this document is still in-progress...*
|
2013-10-18 08:52:38 +02:00
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
2014-10-21 19:25:57 +02:00
|
|
|
[Home](Readme.md)
|
