mirror of
https://github.com/catchorg/Catch2.git
synced 2024-11-22 13:26:10 +01:00
Fixup various spelling errors (#1208)
This commit is contained in:
parent
d38f782995
commit
b11175548a
@ -9,7 +9,7 @@
|
|||||||
|
|
||||||
Most test frameworks have a large collection of assertion macros to capture all possible conditional forms (```_EQUALS```, ```_NOTEQUALS```, ```_GREATER_THAN``` etc).
|
Most test frameworks have a large collection of assertion macros to capture all possible conditional forms (```_EQUALS```, ```_NOTEQUALS```, ```_GREATER_THAN``` etc).
|
||||||
|
|
||||||
Catch is different. Because it decomposes natural C-style conditional expressions most of these forms are reduced to one or two that you will use all the time. That said there are a rich set of auxilliary macros as well. We'll describe all of these here.
|
Catch is different. Because it decomposes natural C-style conditional expressions most of these forms are reduced to one or two that you will use all the time. That said there are a rich set of auxiliary macros as well. We'll describe all of these here.
|
||||||
|
|
||||||
Most of these macros come in two forms:
|
Most of these macros come in two forms:
|
||||||
|
|
||||||
|
@ -78,7 +78,7 @@ Wildcards consist of the `*` character at the beginning and/or end of test case
|
|||||||
|
|
||||||
Test specs are case insensitive.
|
Test specs are case insensitive.
|
||||||
|
|
||||||
If a spec is prefixed with `exclude:` or the `~` character then the pattern matches an exclusion. This means that tests matching the pattern are excluded from the set - even if a prior inclusion spec included them. Subsequent inclusion specs will take precendence, however.
|
If a spec is prefixed with `exclude:` or the `~` character then the pattern matches an exclusion. This means that tests matching the pattern are excluded from the set - even if a prior inclusion spec included them. Subsequent inclusion specs will take precedence, however.
|
||||||
Inclusions and exclusions are evaluated in left-to-right order.
|
Inclusions and exclusions are evaluated in left-to-right order.
|
||||||
|
|
||||||
Test case examples:
|
Test case examples:
|
||||||
@ -94,7 +94,7 @@ a* ~ab* abc Matches all tests that start with 'a', except those that
|
|||||||
</pre>
|
</pre>
|
||||||
|
|
||||||
Names within square brackets are interpreted as tags.
|
Names within square brackets are interpreted as tags.
|
||||||
A series of tags form an AND expression wheras a comma-separated sequence forms an OR expression. e.g.:
|
A series of tags form an AND expression whereas a comma-separated sequence forms an OR expression. e.g.:
|
||||||
|
|
||||||
<pre>[one][two],[three]</pre>
|
<pre>[one][two],[three]</pre>
|
||||||
This matches all tests tagged `[one]` and `[two]`, as well as all tests tagged `[three]`
|
This matches all tests tagged `[one]` and `[two]`, as well as all tests tagged `[three]`
|
||||||
@ -269,7 +269,7 @@ either before running any tests, after running all tests - or both, depending on
|
|||||||
|
|
||||||
When running benchmarks the clock resolution is estimated. Benchmarks are then run for exponentially increasing
|
When running benchmarks the clock resolution is estimated. Benchmarks are then run for exponentially increasing
|
||||||
numbers of iterations until some multiple of the estimated resolution is exceed. By default that multiple is 100, but
|
numbers of iterations until some multiple of the estimated resolution is exceed. By default that multiple is 100, but
|
||||||
it can be overriden here.
|
it can be overridden here.
|
||||||
|
|
||||||
<a id="usage"></a>
|
<a id="usage"></a>
|
||||||
## Usage
|
## Usage
|
||||||
|
@ -26,7 +26,7 @@ Although Catch is header only it still, internally, maintains a distinction betw
|
|||||||
|
|
||||||
# Reporter / Listener interfaces
|
# Reporter / Listener interfaces
|
||||||
|
|
||||||
CATCH_CONFIG_EXTERNAL_INTERFACES // Brings in neccessary headers for Reporter/Listener implementation
|
CATCH_CONFIG_EXTERNAL_INTERFACES // Brings in necessary headers for Reporter/Listener implementation
|
||||||
|
|
||||||
Brings in various parts of Catch that are required for user defined Reporters and Listeners. This means that new Reporters and Listeners can be defined in this file as well as in the main file.
|
Brings in various parts of Catch that are required for user defined Reporters and Listeners. This means that new Reporters and Listeners can be defined in this file as well as in the main file.
|
||||||
|
|
||||||
@ -79,7 +79,7 @@ This can be useful on certain platforms that do not provide the standard iostrea
|
|||||||
|
|
||||||
By default Catch's stringification machinery falls back to a "{?}". To
|
By default Catch's stringification machinery falls back to a "{?}". To
|
||||||
let projects reuse their own existing stringification machinery, this
|
let projects reuse their own existing stringification machinery, this
|
||||||
fallback can be overriden by defining `CATCH_CONFIG_FALLBACK_STRINGIFIER`
|
fallback can be overridden by defining `CATCH_CONFIG_FALLBACK_STRINGIFIER`
|
||||||
to a name of a function that should perform the stringification instead.
|
to a name of a function that should perform the stringification instead.
|
||||||
|
|
||||||
The provided function must return std::string and must accept any type
|
The provided function must return std::string and must accept any type
|
||||||
|
@ -44,7 +44,7 @@ _Note that you should not use any assertion macros within a Listener!_
|
|||||||
|
|
||||||
## Events that can be hooked
|
## Events that can be hooked
|
||||||
|
|
||||||
The following are the methods that can be overriden in the Listener:
|
The following are the methods that can be overridden in the Listener:
|
||||||
|
|
||||||
```c++
|
```c++
|
||||||
// The whole test run, starting and ending
|
// The whole test run, starting and ending
|
||||||
|
@ -21,7 +21,7 @@ Listing a project here does not imply endorsement and the plan is to keep these
|
|||||||
Boost Asio style bindings for ZeroMQ
|
Boost Asio style bindings for ZeroMQ
|
||||||
|
|
||||||
### [ChakraCore](https://github.com/Microsoft/ChakraCore)
|
### [ChakraCore](https://github.com/Microsoft/ChakraCore)
|
||||||
The core part of the Chakra Javascript engine that powers Microsoft Edge
|
The core part of the Chakra JavaScript engine that powers Microsoft Edge
|
||||||
|
|
||||||
### [ChaiScript](https://github.com/ChaiScript/ChaiScript)
|
### [ChaiScript](https://github.com/ChaiScript/ChaiScript)
|
||||||
A, header-only, embedded scripting language designed from the ground up to directly target C++ and take advantage of modern C++ development techniques
|
A, header-only, embedded scripting language designed from the ground up to directly target C++ and take advantage of modern C++ development techniques
|
||||||
|
@ -30,7 +30,7 @@ int main( int argc, char* argv[] ) {
|
|||||||
|
|
||||||
## Amending the config
|
## Amending the config
|
||||||
|
|
||||||
If you still want Catch to process the command line, but you want to programatically tweak the config, you can do so in one of two ways:
|
If you still want Catch to process the command line, but you want to programmatically tweak the config, you can do so in one of two ways:
|
||||||
|
|
||||||
```c++
|
```c++
|
||||||
#define CATCH_CONFIG_RUNNER
|
#define CATCH_CONFIG_RUNNER
|
||||||
|
@ -379,8 +379,8 @@ Cygwin issue with `gettimeofday` - `#define` was not early enough
|
|||||||
* Cygwin compatibility fixes
|
* Cygwin compatibility fixes
|
||||||
* Signal handling is no longer compiled by default.
|
* Signal handling is no longer compiled by default.
|
||||||
* Usage of `gettimeofday` inside Catch should no longer cause compilation errors.
|
* Usage of `gettimeofday` inside Catch should no longer cause compilation errors.
|
||||||
* Improved `-Wparentheses` supression for gcc (#674)
|
* Improved `-Wparentheses` suppression for gcc (#674)
|
||||||
* When compiled with gcc 4.8 or newer, the supression is localized to assertions only
|
* When compiled with gcc 4.8 or newer, the suppression is localized to assertions only
|
||||||
* Otherwise it is supressed for the whole TU
|
* Otherwise it is supressed for the whole TU
|
||||||
* Fixed test spec parser issue (with escapes in multiple names)
|
* Fixed test spec parser issue (with escapes in multiple names)
|
||||||
|
|
||||||
@ -399,7 +399,7 @@ Xml:
|
|||||||
* C-escape control characters instead of XML encoding them (which requires XML 1.1)
|
* C-escape control characters instead of XML encoding them (which requires XML 1.1)
|
||||||
* Revert XML output to XML 1.0
|
* Revert XML output to XML 1.0
|
||||||
* Can provide stylesheet references by extending the XML reporter
|
* Can provide stylesheet references by extending the XML reporter
|
||||||
* Added description and tags attribites to XML Reporter
|
* Added description and tags attributes to XML Reporter
|
||||||
* Tags are closed and the stream flushed more eagerly to avoid stdout interpolation
|
* Tags are closed and the stream flushed more eagerly to avoid stdout interpolation
|
||||||
|
|
||||||
|
|
||||||
|
@ -1,11 +1,11 @@
|
|||||||
<a id="top"></a>
|
<a id="top"></a>
|
||||||
# How to release
|
# How to release
|
||||||
|
|
||||||
When enough changes have accumulated, it is time to release new version of Catch. This document describes the proces in doing so, that no steps are forgotten. Note that all referenced scripts can be found in the `scripts/` directory.
|
When enough changes have accumulated, it is time to release new version of Catch. This document describes the process in doing so, that no steps are forgotten. Note that all referenced scripts can be found in the `scripts/` directory.
|
||||||
|
|
||||||
## Neccessary steps
|
## Necessary steps
|
||||||
|
|
||||||
These steps are neccessary and have to be performed before each new release. They serve to make sure that the new release is correct and linked-to from the standard places.
|
These steps are necessary and have to be performed before each new release. They serve to make sure that the new release is correct and linked-to from the standard places.
|
||||||
|
|
||||||
|
|
||||||
### Approval testing
|
### Approval testing
|
||||||
@ -54,7 +54,7 @@ The following steps are optional, and do not have to be performed when releasing
|
|||||||
|
|
||||||
### vcpkg update
|
### vcpkg update
|
||||||
|
|
||||||
Catch is maintaining its own port in Microsoft's package manager [vcpkg](https://github.com/Microsoft/vcpkg). This means that when new version of Catch is released, it should be posted there as well. `updateVcpkgPackage.py` can do a lot of neccessary work for you, it creates a branch and commits neccessary changes. You should review these changes, push and open a PR against vcpkg's upstream.
|
Catch is maintaining its own port in Microsoft's package manager [vcpkg](https://github.com/Microsoft/vcpkg). This means that when new version of Catch is released, it should be posted there as well. `updateVcpkgPackage.py` can do a lot of necessary work for you, it creates a branch and commits necessary changes. You should review these changes, push and open a PR against vcpkg's upstream.
|
||||||
|
|
||||||
Note that the script assumes you have your fork of vcpkg checked out in a directory next to the directory where you have checked out Catch, like so:
|
Note that the script assumes you have your fork of vcpkg checked out in a directory next to the directory where you have checked out Catch, like so:
|
||||||
```
|
```
|
||||||
|
@ -13,7 +13,7 @@ namespace Catch {
|
|||||||
using StringMatcher = Matchers::Impl::MatcherBase<std::string>;
|
using StringMatcher = Matchers::Impl::MatcherBase<std::string>;
|
||||||
|
|
||||||
// This is the general overload that takes a any string matcher
|
// This is the general overload that takes a any string matcher
|
||||||
// There is another overload, in catch_assertinhandler.h/.cpp, that only takes a string and infers
|
// There is another overload, in catch_assertionhandler.h/.cpp, that only takes a string and infers
|
||||||
// the Equals matcher (so the header does not mention matchers)
|
// the Equals matcher (so the header does not mention matchers)
|
||||||
void handleExceptionMatchExpr( AssertionHandler& handler, StringMatcher const& matcher, StringRef matcherString ) {
|
void handleExceptionMatchExpr( AssertionHandler& handler, StringMatcher const& matcher, StringRef matcherString ) {
|
||||||
std::string exceptionMessage = Catch::translateActiveException();
|
std::string exceptionMessage = Catch::translateActiveException();
|
||||||
|
@ -133,7 +133,7 @@ namespace Catch {
|
|||||||
if ( !exceptions.empty() ) {
|
if ( !exceptions.empty() ) {
|
||||||
m_startupExceptions = true;
|
m_startupExceptions = true;
|
||||||
Colour colourGuard( Colour::Red );
|
Colour colourGuard( Colour::Red );
|
||||||
Catch::cerr() << "Errors occured during startup!" << '\n';
|
Catch::cerr() << "Errors occurred during startup!" << '\n';
|
||||||
// iterate over all exceptions and notify user
|
// iterate over all exceptions and notify user
|
||||||
for ( const auto& ex_ptr : exceptions ) {
|
for ( const auto& ex_ptr : exceptions ) {
|
||||||
try {
|
try {
|
||||||
|
@ -26,7 +26,7 @@ namespace Catch {
|
|||||||
~TAPReporter() override;
|
~TAPReporter() override;
|
||||||
|
|
||||||
static std::string getDescription() {
|
static std::string getDescription() {
|
||||||
return "Reports test results in TAP format, suitable for test harneses";
|
return "Reports test results in TAP format, suitable for test harnesses";
|
||||||
}
|
}
|
||||||
|
|
||||||
ReporterPreferences getPreferences() const override {
|
ReporterPreferences getPreferences() const override {
|
||||||
|
@ -1,4 +1,4 @@
|
|||||||
# Downloads are done from the oficial github release page links
|
# Downloads are done from the official github release page links
|
||||||
$downloadUrl = "https://github.com/OpenCppCoverage/OpenCppCoverage/releases/download/release-0.9.7.0/OpenCppCoverageSetup-x64-0.9.7.0.exe"
|
$downloadUrl = "https://github.com/OpenCppCoverage/OpenCppCoverage/releases/download/release-0.9.7.0/OpenCppCoverageSetup-x64-0.9.7.0.exe"
|
||||||
$installerPath = [System.IO.Path]::Combine($Env:USERPROFILE, "Downloads", "OpenCppCoverageSetup.exe")
|
$installerPath = [System.IO.Path]::Combine($Env:USERPROFILE, "Downloads", "OpenCppCoverageSetup.exe")
|
||||||
|
|
||||||
|
@ -53,7 +53,7 @@
|
|||||||
:test-result: PASS Inequality checks that should succeed
|
:test-result: PASS Inequality checks that should succeed
|
||||||
:test-result: PASS Less-than inequalities with different epsilons
|
:test-result: PASS Less-than inequalities with different epsilons
|
||||||
:test-result: PASS Long strings can be wrapped
|
:test-result: PASS Long strings can be wrapped
|
||||||
:test-result: PASS Long text is truncted
|
:test-result: PASS Long text is truncated
|
||||||
:test-result: PASS ManuallyRegistered
|
:test-result: PASS ManuallyRegistered
|
||||||
:test-result: PASS Matchers can be (AllOf) composed with the && operator
|
:test-result: PASS Matchers can be (AllOf) composed with the && operator
|
||||||
:test-result: PASS Matchers can be (AnyOf) composed with the || operator
|
:test-result: PASS Matchers can be (AnyOf) composed with the || operator
|
||||||
|
@ -12,7 +12,7 @@
|
|||||||
#include <stdexcept>
|
#include <stdexcept>
|
||||||
|
|
||||||
#ifdef _MSC_VER
|
#ifdef _MSC_VER
|
||||||
#pragma warning(disable:4702) // Unreachable code -- uncoditional throws and so on
|
#pragma warning(disable:4702) // Unreachable code -- unconditional throws and so on
|
||||||
#endif
|
#endif
|
||||||
#ifdef __clang__
|
#ifdef __clang__
|
||||||
#pragma clang diagnostic push
|
#pragma clang diagnostic push
|
||||||
|
@ -2,7 +2,7 @@
|
|||||||
#include <vector>
|
#include <vector>
|
||||||
#include <array>
|
#include <array>
|
||||||
|
|
||||||
// vedctor
|
// vector
|
||||||
TEST_CASE( "vector<int> -> toString", "[toString][vector]" )
|
TEST_CASE( "vector<int> -> toString", "[toString][vector]" )
|
||||||
{
|
{
|
||||||
std::vector<int> vv;
|
std::vector<int> vv;
|
||||||
|
@ -61,9 +61,9 @@ FILE_2 description
|
|||||||
.\" .Sh DIAGNOSTICS \" May not be needed
|
.\" .Sh DIAGNOSTICS \" May not be needed
|
||||||
.\" .Bl -diag
|
.\" .Bl -diag
|
||||||
.\" .It Diagnostic Tag
|
.\" .It Diagnostic Tag
|
||||||
.\" Diagnostic informtion here.
|
.\" Diagnostic information here.
|
||||||
.\" .It Diagnostic Tag
|
.\" .It Diagnostic Tag
|
||||||
.\" Diagnostic informtion here.
|
.\" Diagnostic information here.
|
||||||
.\" .El
|
.\" .El
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
.\" List links in ascending order by section, alphabetically within a section.
|
.\" List links in ascending order by section, alphabetically within a section.
|
||||||
|
@ -127,7 +127,7 @@ def tagAndCollect(lines, id_tag=True, back_links=False, exclude_h=None):
|
|||||||
A list of 3-value sublists, where the first value
|
A list of 3-value sublists, where the first value
|
||||||
represents the heading, the second value the string
|
represents the heading, the second value the string
|
||||||
that was inserted assigned to the IDs in the anchor tags,
|
that was inserted assigned to the IDs in the anchor tags,
|
||||||
and the third value is an integer that reprents the headline level.
|
and the third value is an integer that represents the headline level.
|
||||||
E.g.,
|
E.g.,
|
||||||
[['some header lvl3', 'some-header-lvl3', 3], ...]
|
[['some header lvl3', 'some-header-lvl3', 3], ...]
|
||||||
|
|
||||||
@ -282,7 +282,7 @@ def markdownToclify(
|
|||||||
input_file: str
|
input_file: str
|
||||||
Path to the markdown input file.
|
Path to the markdown input file.
|
||||||
|
|
||||||
output_file: str (defaul: None)
|
output_file: str (default: None)
|
||||||
Path to the markdown output file.
|
Path to the markdown output file.
|
||||||
|
|
||||||
min_toc_len: int (default: 2)
|
min_toc_len: int (default: 2)
|
||||||
@ -420,7 +420,7 @@ def updateDocumentToCMain():
|
|||||||
default=minTocEntries,
|
default=minTocEntries,
|
||||||
type=int,
|
type=int,
|
||||||
metavar='N',
|
metavar='N',
|
||||||
help='the minimum number of entries to create a table of contents for [{deflt}]'.format(deflt=minTocEntries))
|
help='the minimum number of entries to create a table of contents for [{default}]'.format(default=minTocEntries))
|
||||||
|
|
||||||
parser.add_argument(
|
parser.add_argument(
|
||||||
'--remove-toc',
|
'--remove-toc',
|
||||||
|
@ -89,7 +89,7 @@ def git_push(path_to_repo):
|
|||||||
# Make sure we branch off master
|
# Make sure we branch off master
|
||||||
subprocess.call('git checkout master', shell=True)
|
subprocess.call('git checkout master', shell=True)
|
||||||
|
|
||||||
# Update repo to current master, so we don't work off old version of the portsfile
|
# Update repo to current master, so we don't work off old version of the portfile
|
||||||
subprocess.call('git pull Microsoft master', shell=True)
|
subprocess.call('git pull Microsoft master', shell=True)
|
||||||
subprocess.call('git push', shell=True)
|
subprocess.call('git push', shell=True)
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user