1<a id="top"></a> 2 3# Release notes 4**Contents**<br> 5[2.11.2](#2112)<br> 6[2.11.1](#2111)<br> 7[2.11.0](#2110)<br> 8[2.10.2](#2102)<br> 9[2.10.1](#2101)<br> 10[2.10.0](#2100)<br> 11[2.9.2](#292)<br> 12[2.9.1](#291)<br> 13[2.9.0](#290)<br> 14[2.8.0](#280)<br> 15[2.7.2](#272)<br> 16[2.7.1](#271)<br> 17[2.7.0](#270)<br> 18[2.6.1](#261)<br> 19[2.6.0](#260)<br> 20[2.5.0](#250)<br> 21[2.4.2](#242)<br> 22[2.4.1](#241)<br> 23[2.4.0](#240)<br> 24[2.3.0](#230)<br> 25[2.2.3](#223)<br> 26[2.2.2](#222)<br> 27[2.2.1](#221)<br> 28[2.2.0](#220)<br> 29[2.1.2](#212)<br> 30[2.1.1](#211)<br> 31[2.1.0](#210)<br> 32[2.0.1](#201)<br> 33[Older versions](#older-versions)<br> 34[Even Older versions](#even-older-versions)<br> 35 36 37## 2.11.2 38 39### Improvements 40* GCC and Clang now issue warnings for suspicious code in assertions (#1880) 41 * E.g. `REQUIRE( int != unsigned int )` will now issue mixed signedness comparison warning 42 * This has always worked on MSVC, but it now also works for GCC and current Clang versions 43* Colorization of "Test filters" output should be more robust now 44* `--wait-for-keypress` now also accepts `never` as an option (#1866) 45* Reporters no longer round-off nanoseconds when reporting benchmarking results (#1876) 46* Catch2's debug break now supports iOS while using Thumb instruction set (#1862) 47* It is now possible to customize benchmark's warm-up time when running the test binary (#1844) 48 * `--benchmark-warmup-time {ms}` 49* User can now specify how Catch2 should break into debugger (#1846) 50 51### Fixes 52* Fixes missing `<random>` include in benchmarking (#1831) 53* Fixed missing `<iterator>` include in benchmarking (#1874) 54* Hidden test cases are now also tagged with `[!hide]` as per documentation (#1847) 55* Detection of whether libc provides `std::nextafter` has been improved (#1854) 56* Detection of `wmain` no longer incorrectly looks for `WIN32` macro (#1849) 57 * Now it just detects Windows platform 58* Composing already-composed matchers no longer modifies the partially-composed matcher expression 59 * This bug has been present for the last ~2 years and nobody reported it 60 61 62## 2.11.1 63 64### Improvements 65* Breaking into debugger is supported on iOS (#1817) 66* `google-build-using-namespace` clang-tidy warning is suppressed (#1799) 67 68### Fixes 69* Clang on Windows is no longer assumed to implement MSVC's traditional preprocessor (#1806) 70* `ObjectStorage` now behaves properly in `const` contexts (#1820) 71* `GENERATE_COPY(a, b)` now compiles properly (#1809, #1815) 72* Some more cleanups in the benchmarking support 73 74 75## 2.11.0 76 77### Improvements 78* JUnit reporter output now contains more details in case of failure (#1347, #1719) 79* Added SonarQube Test Data reporter (#1738) 80 * It is in a separate header, just like the TAP, Automake, and TeamCity reporters 81* `range` generator now allows floating point numbers (#1776) 82* Reworked part of internals to increase throughput 83 84 85### Fixes 86* The single header version should contain full benchmarking support (#1800) 87* `[.foo]` is now properly parsed as `[.][foo]` when used on the command line (#1798) 88* Fixed compilation of benchmarking on platforms where `steady_clock::period` is not `std::nano` (#1794) 89 90 91 92## 2.10.2 93 94### Improvements 95* Catch2 will now compile on platform where `INFINITY` is double (#1782) 96 97 98### Fixes 99* Warning suppressed during listener registration will no longer leak 100 101 102 103## 2.10.1 104 105### Improvements 106* Catch2 now guards itself against `min` and `max` macros from `windows.h` (#1772) 107* Templated tests will now compile with ICC (#1748) 108* `WithinULP` matcher now uses scientific notation for stringification (#1760) 109 110 111### Fixes 112* Templated tests no longer trigger `-Wunused-templates` (#1762) 113* Suppressed clang-analyzer false positive in context getter (#1230, #1735) 114 115 116### Miscellaneous 117* CMake no longer prohibits in-tree build when Catch2 is used as a subproject (#1773, #1774) 118 119 120 121## 2.10.0 122 123### Fixes 124* `TEMPLATE_LIST_TEST_CASE` now properly handles non-copyable and non-movable types (#1729) 125* Fixed compilation error on Solaris caused by a system header defining macro `TT` (#1722, #1723) 126* `REGISTER_ENUM` will now fail at compilation time if the registered enum is too large 127* Removed use of `std::is_same_v` in C++17 mode (#1757) 128* Fixed parsing of escaped special characters when reading test specs from a file (#1767, #1769) 129 130 131### Improvements 132* Trailing and leading whitespace in test/section specs are now ignored. 133* Writing to Android debug log now uses `__android_log_write` instead of `__android_log_print` 134* Android logging support can now be turned on/off at compile time (#1743) 135 * The toggle is `CATCH_CONFIG_ANDROID_LOGWRITE` 136* Added a generator that returns elements of a range 137 * Use via `from_range(from, to)` or `from_range(container)` 138* Added support for CRTs that do not provide `std::nextafter` (#1739) 139 * They must still provide global `nextafter{f,l,}` 140 * Enabled via `CATCH_CONFIG_GLOBAL_NEXTAFTER` 141* Special cased `Approx(inf)` not to match non-infinite values 142 * Very strictly speaking this might be a breaking change, but it should match user expectations better 143* The output of benchmarking through the Console reporter when `--benchmark-no-analysis` is set is now much simpler (#1768) 144* Added a matcher that can be used for checking an exceptions message (#1649, #1728) 145 * The matcher helper function is called `Message` 146 * The exception must publicly derive from `std::exception` 147 * The matching is done exactly, including case and whitespace 148* Added a matcher that can be used for checking relative equality of floating point numbers (#1746) 149 * Unlike `Approx`, it considers both sides when determining the allowed margin 150 * Special cases `NaN` and `INFINITY` to match user expectations 151 * The matcher helper function is called `WithinRel` 152* The ULP matcher now allows for any possible distance between the two numbers 153* The random number generators now use Catch-global instance of RNG (#1734, #1736) 154 * This means that nested random number generators actually generate different numbers 155 156 157### Miscellaneous 158* In-repo PNGs have been optimized to lower overhead of using Catch2 via git clone 159* Catch2 now uses its own implementation of the URBG concept 160 * In the future we also plan to use our own implementation of the distributions from `<random>` to provide cross-platform repeatability of random results 161 162 163 164## 2.9.2 165 166### Fixes 167* `ChunkGenerator` can now be used with chunks of size 0 (#1671) 168* Nested subsections are now run properly when specific section is run via the `-c` argument (#1670, #1673) 169* Catch2 now consistently uses `_WIN32` to detect Windows platform (#1676) 170* `TEMPLATE_LIST_TEST_CASE` now support non-default constructible type lists (#1697) 171* Fixed a crash in the XMLReporter when a benchmark throws exception during warmup (#1706) 172* Fixed a possible infinite loop in CompactReporter (#1715) 173* Fixed `-w NoTests` returning 0 even when no tests were matched (#1449, #1683, #1684) 174* Fixed matcher compilation under Obj-C++ (#1661) 175 176### Improvements 177* `RepeatGenerator` and `FixedValuesGenerator` now fail to compile when used with `bool` (#1692) 178 * Previously they would fail at runtime. 179* Catch2 now supports Android's debug logging for its debug output (#1710) 180* Catch2 now detects and configures itself for the RTX platform (#1693) 181 * You still need to pass `--benchmark-no-analysis` if you are using benchmarking under RTX 182* Removed a "storage class is not first" warning when compiling Catch2 with PGI compiler (#1717) 183 184### Miscellaneous 185* Documentation now contains indication when a specific feature was introduced (#1695) 186 * These start with Catch2 v2.3.0, (a bit over a year ago). 187 * `docs/contributing.md` has been updated to provide contributors guidance on how to add these to newly written documentation 188* Various other documentation improvements 189 * ToC fixes 190 * Documented `--order` and `--rng-seed` command line options 191 * Benchmarking documentation now clearly states that it requires opt-in 192 * Documented `CATCH_CONFIG_CPP17_OPTIONAL` and `CATCH_CONFIG_CPP17_BYTE` macros 193 * Properly documented built-in vector matchers 194 * Improved `*_THROWS_MATCHES` documentation a bit 195* CMake config file is now arch-independent even if `CMAKE_SIZEOF_VOID_P` is in CMake cache (#1660) 196* `CatchAddTests` now properly escapes `[` and `]` in test names (#1634, #1698) 197* Reverted `CatchAddTests` adding tags as CTest labels (#1658) 198 * The script broke when test names were too long 199 * Overwriting `LABELS` caused trouble for users who set them manually 200 * CMake does not let users append to `LABELS` if the test name has spaces 201 202 203## 2.9.1 204 205### Fixes 206* Fix benchmarking compilation failure in files without `CATCH_CONFIG_EXTERNAL_INTERFACES` (or implementation) 207 208## 2.9.0 209 210### Improvements 211* The experimental benchmarking support has been replaced by integrating Nonius code (#1616) 212 * This provides a much more featurefull micro-benchmarking support. 213 * Due to the compilation cost, it is disabled by default. See the documentation for details. 214 * As far as backwards compatibility is concerned, this feature is still considered experimental in that we might change the interface based on user feedback. 215* `WithinULP` matcher now shows the acceptable range (#1581) 216* Template test cases now support type lists (#1627) 217 218 219## 2.8.0 220 221### Improvements 222* Templated test cases no longer check whether the provided types are unique (#1628) 223 * This allows you to e.g. test over `uint32_t`, `uint64_t`, and `size_t` without compilation failing 224* The precision of floating point stringification can be modified by user (#1612, #1614) 225* We now provide `REGISTER_ENUM` convenience macro for generating `StringMaker` specializations for enums 226 * See the "String conversion" documentation for details 227* Added new set of macros for template test cases that enables the use of NTTPs (#1531, #1609) 228 * See "Test cases and sections" documentation for details 229 230### Fixes 231* `UNSCOPED_INFO` macro now has a prefixed/disabled/prefixed+disabled versions (#1611) 232* Reporting errors at startup should no longer cause a segfault under certain circumstances (#1626) 233 234 235### Miscellaneous 236* CMake will now prevent you from attempting in-tree build (#1636, #1638) 237 * Previously it would break with an obscure error message during the build step 238 239 240## 2.7.2 241 242### Improvements 243* Added an approximate vector matcher (#1499) 244 245### Fixes 246* Filters will no longer be shown if there were none 247* Fixed compilation error when using Homebrew GCC on OS X (#1588, #1589) 248* Fixed the console reporter not showing messages that start with a newline (#1455, #1470) 249* Modified JUnit reporter's output so that rng seed and filters are reported according to the JUnit schema (#1598) 250* Fixed some obscure warnings and static analysis passes 251 252### Miscellaneous 253* Various improvements to `ParseAndAddCatchTests` (#1559, #1601) 254 * When a target is parsed, it receives `ParseAndAddCatchTests_TESTS` property which summarizes found tests 255 * Fixed problem with tests not being found if the `OptionalCatchTestLauncher` variables is used 256 * Including the script will no longer forcefully modify `CMAKE_MINIMUM_REQUIRED_VERSION` 257 * CMake object libraries are ignored when parsing to avoid needless warnings 258* `CatchAddTests` now adds test's tags to their CTest labels (#1600) 259* Added basic CPack support to our build 260 261## 2.7.1 262 263### Improvements 264* Reporters now print out the filters applied to test cases (#1550, #1585) 265* Added `GENERATE_COPY` and `GENERATE_REF` macros that can use variables inside the generator expression 266 * Because of the significant danger of lifetime issues, the default `GENERATE` macro still does not allow variables 267* The `map` generator helper now deduces the mapped return type (#1576) 268 269### Fixes 270* Fixed ObjC++ compilation (#1571) 271* Fixed test tag parsing so that `[.foo]` is now parsed as `[.][foo]`. 272* Suppressed warning caused by the Windows headers defining SE codes in different manners (#1575) 273 274## 2.7.0 275 276### Improvements 277* `TEMPLATE_PRODUCT_TEST_CASE` now uses the resulting type in the name, instead of the serial number (#1544) 278* Catch2's single header is now strictly ASCII (#1542) 279* Added generator for random integral/floating point types 280 * The types are inferred within the `random` helper 281* Added back RangeGenerator (#1526) 282 * RangeGenerator returns elements within a certain range 283* Added ChunkGenerator generic transform (#1538) 284 * A ChunkGenerator returns the elements from different generator in chunks of n elements 285* Added `UNSCOPED_INFO` (#415, #983, #1522) 286 * This is a variant of `INFO` that lives until next assertion/end of the test case. 287 288 289### Fixes 290* All calls to C stdlib functions are now `std::` qualified (#1541) 291 * Code brought in from Clara was also updated. 292* Running tests will no longer open the specified output file twice (#1545) 293 * This would cause trouble when the file was not a file, but rather a named pipe 294 * Fixes the CLion/Resharper integration with Catch 295* Fixed `-Wunreachable-code` occurring with (old) ccache+cmake+clang combination (#1540) 296* Fixed `-Wdefaulted-function-deleted` warning with Clang 8 (#1537) 297* Catch2's type traits and helpers are now properly namespaced inside `Catch::` (#1548) 298* Fixed std{out,err} redirection for failing test (#1514, #1525) 299 * Somehow, this bug has been present for well over a year before it was reported 300 301 302### Contrib 303* `ParseAndAddCatchTests` now properly escapes commas in the test name 304 305 306 307## 2.6.1 308 309### Improvements 310* The JUnit reporter now also reports random seed (#1520, #1521) 311 312### Fixes 313* The TAP reporter now formats comments with test name properly (#1529) 314* `CATCH_REQUIRE_THROWS`'s internals were unified with `REQUIRE_THROWS` (#1536) 315 * This fixes a potential `-Wunused-value` warning when used 316* Fixed a potential segfault when using any of the `--list-*` options (#1533, #1534) 317 318 319## 2.6.0 320 321**With this release the data generator feature is now fully supported.** 322 323 324### Improvements 325* Added `TEMPLATE_PRODUCT_TEST_CASE` (#1454, #1468) 326 * This allows you to easily test various type combinations, see documentation for details 327* The error message for `&&` and `||` inside assertions has been improved (#1273, #1480) 328* The error message for chained comparisons inside assertions has been improved (#1481) 329* Added `StringMaker` specialization for `std::optional` (#1510) 330* The generator interface has been redone once again (#1516) 331 * It is no longer considered experimental and is fully supported 332 * The new interface supports "Input" generators 333 * The generator documentation has been fully updated 334 * We also added 2 generator examples 335 336 337### Fixes 338* Fixed `-Wredundant-move` on newer Clang (#1474) 339* Removed unreachable mentions `std::current_exception`, `std::rethrow_exception` in no-exceptions mode (#1462) 340 * This should fix compilation with IAR 341* Fixed missing `<type_traits>` include (#1494) 342* Fixed various static analysis warnings 343 * Unrestored stream state in `XmlWriter` (#1489) 344 * Potential division by zero in `estimateClockResolution` (#1490) 345 * Uninitialized member in `RunContext` (#1491) 346 * `SourceLineInfo` move ops are now marked `noexcept` 347 * `CATCH_BREAK_INTO_DEBUGGER` is now always a function 348* Fix double run of a test case if user asks for a specific section (#1394, #1492) 349* ANSI colour code output now respects `-o` flag and writes to the file as well (#1502) 350* Fixed detection of `std::variant` support for compilers other than Clang (#1511) 351 352 353### Contrib 354* `ParseAndAddCatchTests` has learned how to use `DISABLED` CTest property (#1452) 355* `ParseAndAddCatchTests` now works when there is a whitspace before the test name (#1493) 356 357 358### Miscellaneous 359* We added new issue templates for reporting issues on GitHub 360* `contributing.md` has been updated to reflect the current test status (#1484) 361 362 363 364## 2.5.0 365 366### Improvements 367* Added support for templated tests via `TEMPLATE_TEST_CASE` (#1437) 368 369 370### Fixes 371* Fixed compilation of `PredicateMatcher<const char*>` by removing partial specialization of `MatcherMethod<T*>` 372* Listeners now implicitly support any verbosity (#1426) 373* Fixed compilation with Embarcadero builder by introducing `Catch::isnan` polyfill (#1438) 374* Fixed `CAPTURE` asserting for non-trivial captures (#1436, #1448) 375 376 377### Miscellaneous 378* We should now be providing first party Conan support via https://bintray.com/catchorg/Catch2 (#1443) 379* Added new section "deprecations and planned changes" to the documentation 380 * It contains summary of what is deprecated and might change with next major version 381* From this release forward, the released headers should be pgp signed (#430) 382 * KeyID `E29C 46F3 B8A7 5028 6079 3B7D ECC9 C20E 314B 2360` 383 * or https://codingnest.com/files/horenmar-publickey.asc 384 385 386## 2.4.2 387 388### Improvements 389* XmlReporter now also outputs the RNG seed that was used in a run (#1404) 390* `Catch::Session::applyCommandLine` now also accepts `wchar_t` arguments. 391 * However, Catch2 still does not support unicode. 392* Added `STATIC_REQUIRE` macro (#1356, #1362) 393* Catch2's singleton's are now cleaned up even if tests are run (#1411) 394 * This is mostly useful as a FP prevention for users who define their own main. 395* Specifying an invalid reporter via `-r` is now reported sooner (#1351, #1422) 396 397 398### Fixes 399* Stringification no longer assumes that `char` is signed (#1399, #1407) 400 * This caused a `Wtautological-compare` warning. 401* SFINAE for `operator<<` no longer sees different overload set than the actual insertion (#1403) 402 403 404### Contrib 405* `catch_discover_tests` correctly adds tests with comma in name (#1327, #1409) 406* Added a new customization point in how the tests are launched to `catch_discover_tests` 407 408 409## 2.4.1 410 411### Improvements 412* Added a StringMaker for `std::(w)string_view` (#1375, #1376) 413* Added a StringMaker for `std::variant` (#1380) 414 * This one is disabled by default to avoid increased compile-time drag 415* Added detection for cygwin environment without `std::to_string` (#1396, #1397) 416 417### Fixes 418* `UnorderedEqualsMatcher` will no longer accept erroneously accept 419vectors that share suffix, but are not permutation of the desired vector 420* Abort after (`-x N`) can no longer be overshot by nested `REQUIRES` and 421subsequently ignored (#1391, #1392) 422 423 424## 2.4.0 425 426**This release brings two new experimental features, generator support 427and a `-fno-exceptions` support. Being experimental means that they 428will not be subject to the usual stability guarantees provided by semver.** 429 430### Improvements 431* Various small runtime performance improvements 432* `CAPTURE` macro is now variadic 433* Added `AND_GIVEN` macro (#1360) 434* Added experimental support for data generators 435 * See [their documentation](generators.md) for details 436* Added support for compiling and running Catch without exceptions 437 * Doing so limits the functionality somewhat 438 * Look [into the documentation](configuration.md#disablingexceptions) for details 439 440### Fixes 441* Suppressed `-Wnon-virtual-dtor` warnings in Matchers (#1357) 442* Suppressed `-Wunreachable-code` warnings in floating point matchers (#1350) 443 444### CMake 445* It is now possible to override which Python is used to run Catch's tests (#1365) 446* Catch now provides infrastructure for adding tests that check compile-time configuration 447* Catch no longer tries to install itself when used as a subproject (#1373) 448* Catch2ConfigVersion.cmake is now generated as arch-independent (#1368) 449 * This means that installing Catch from 32-bit machine and copying it to 64-bit one works 450 * This fixes conan installation of Catch 451 452 453## 2.3.0 454 455**This release changes the include paths provided by our CMake and 456pkg-config integration. The proper include path for the single-header 457when using one of the above is now `<catch2/catch.hpp>`. This change 458also necessitated changes to paths inside the repository, so that the 459single-header version is now at `single_include/catch2/catch.hpp`, rather 460than `single_include/catch.hpp`.** 461 462 463 464### Fixes 465* Fixed Objective-C++ build 466* `-Wunused-variable` suppression no longer leaks from Catch's header under Clang 467* Implementation of the experimental new output capture can now be disabled (#1335) 468 * This allows building Catch2 on platforms that do not provide things like `dup` or `tmpfile`. 469* The JUnit and XML reporters will no longer skip over successful tests when running without `-s` (#1264, #1267, #1310) 470 * See improvements for more details 471 472### Improvements 473* pkg-config and CMake integration has been rewritten 474 * If you use them, the new include path is `#include <catch2/catch.hpp>` 475 * CMake installation now also installs scripts from `contrib/` 476 * For details see the [new documentation](cmake-integration.md#top) 477* Reporters now have a new customization point, `ReporterPreferences::shouldReportAllAssertions` 478 * When this is set to `false` and the tests are run without `-s`, passing assertions are not sent to the reporter. 479 * Defaults to `false`. 480* Added `DYNAMIC_SECTION`, a section variant that constructs its name using stream 481 * This means that you can do `DYNAMIC_SECTION("For X := " << x)`. 482 483 484## 2.2.3 485 486**To fix some of the bugs, some behavior had to change in potentially breaking manner.** 487**This means that even though this is a patch release, it might not be a drop-in replacement.** 488 489### Fixes 490* Listeners are now called before reporter 491 * This was always documented to be the case, now it actually works that way 492* Catch's commandline will no longer accept multiple reporters 493 * This was done because multiple reporters never worked properly and broke things in non-obvious ways 494 * **This has potential to be a breaking change** 495* MinGW is now detected as Windows platform w/o SEH support (#1257) 496 * This means that Catch2 no longer tries to use POSIX signal handling when compiled with MinGW 497* Fixed potential UB in parsing tags using non-ASCII characters (#1266) 498 * Note that Catch2 still supports only ASCII test names/tags/etc 499* `TEST_CASE_METHOD` can now be used on classnames containing commas (#1245) 500 * You have to enclose the classname in extra set of parentheses 501* Fixed insufficient alt stack size for POSIX signal handling (#1225) 502* Fixed compilation error on Android due to missing `std::to_string` in C++11 mode (#1280) 503* Fixed the order of user-provided `FALLBACK_STRINGIFIER` in stringification machinery (#1024) 504 * It was intended to be replacement for built-in fallbacks, but it was used _after_ them. 505 * **This has potential to be a breaking change** 506* Fixed compilation error when a type has an `operator<<` with templated lhs (#1285, #1306) 507 508### Improvements 509* Added a new, experimental, output capture (#1243) 510 * This capture can also redirect output written via C apis, e.g. `printf` 511 * To opt-in, define `CATCH_CONFIG_EXPERIMENTAL_REDIRECT` in the implementation file 512* Added a new fallback stringifier for classes derived from `std::exception` 513 * Both `StringMaker` specialization and `operator<<` overload are given priority 514 515### Miscellaneous 516* `contrib/` now contains dbg scripts that skip over Catch's internals (#904, #1283) 517 * `gdbinit` for gdb `lldbinit` for lldb 518* `CatchAddTests.cmake` no longer strips whitespace from tests (#1265, #1281) 519* Online documentation now describes `--use-colour` option (#1263) 520 521 522## 2.2.2 523 524### Fixes 525* Fixed bug in `WithinAbs::match()` failing spuriously (#1228) 526* Fixed clang-tidy diagnostic about virtual call in destructor (#1226) 527* Reduced the number of GCC warnings suppression leaking out of the header (#1090, #1091) 528 * Only `-Wparentheses` should be leaking now 529* Added upper bound on the time benchmark timer calibration is allowed to take (#1237) 530 * On platforms where `std::chrono::high_resolution_clock`'s resolution is low, the calibration would appear stuck 531* Fixed compilation error when stringifying static arrays of `unsigned char`s (#1238) 532 533### Improvements 534* XML encoder now hex-encodes invalid UTF-8 sequences (#1207) 535 * This affects xml and junit reporters 536 * Some invalid UTF-8 parts are left as is, e.g. surrogate pairs. This is because certain extensions of UTF-8 allow them, such as WTF-8. 537* CLR objects (`T^`) can now be stringified (#1216) 538 * This affects code compiled as C++/CLI 539* Added `PredicateMatcher`, a matcher that takes an arbitrary predicate function (#1236) 540 * See [documentation for details](https://github.com/catchorg/Catch2/blob/master/docs/matchers.md) 541 542### Others 543* Modified CMake-installed pkg-config to allow `#include <catch.hpp>`(#1239) 544 * The plans to standardize on `#include <catch2/catch.hpp>` are still in effect 545 546 547## 2.2.1 548 549### Fixes 550* Fixed compilation error when compiling Catch2 with `std=c++17` against libc++ (#1214) 551 * Clara (Catch2's CLI parsing library) used `std::optional` without including it explicitly 552* Fixed Catch2 return code always being 0 (#1215) 553 * In the words of STL, "We feel superbad about letting this in" 554 555 556## 2.2.0 557 558### Fixes 559* Hidden tests are not listed by default when listing tests (#1175) 560 * This makes `catch_discover_tests` CMake script work better 561* Fixed regression that meant `<windows.h>` could potentially not be included properly (#1197) 562* Fixed installing `Catch2ConfigVersion.cmake` when Catch2 is a subproject. 563 564### Improvements 565* Added an option to warn (+ exit with error) when no tests were ran (#1158) 566 * Use as `-w NoTests` 567* Added provisional support for Emscripten (#1114) 568* [Added a way to override the fallback stringifier](https://github.com/catchorg/Catch2/blob/master/docs/configuration.md#fallback-stringifier) (#1024) 569 * This allows project's own stringification machinery to be easily reused for Catch 570* `Catch::Session::run()` now accepts `char const * const *`, allowing it to accept array of string literals (#1031, #1178) 571 * The embedded version of Clara was bumped to v1.1.3 572* Various minor performance improvements 573* Added support for DJGPP DOS crosscompiler (#1206) 574 575 576## 2.1.2 577 578### Fixes 579* Fixed compilation error with `-fno-rtti` (#1165) 580* Fixed NoAssertion warnings 581* `operator<<` is used before range-based stringification (#1172) 582* Fixed `-Wpedantic` warnings (extra semicolons and binary literals) (#1173) 583 584 585### Improvements 586* Added `CATCH_VERSION_{MAJOR,MINOR,PATCH}` macros (#1131) 587* Added `BrightYellow` colour for use in reporters (#979) 588 * It is also used by ConsoleReporter for reconstructed expressions 589 590### Other changes 591* Catch is now exported as a CMake package and linkable target (#1170) 592 593## 2.1.1 594 595### Improvements 596* Static arrays are now properly stringified like ranges across MSVC/GCC/Clang 597* Embedded newer version of Clara -- v1.1.1 598 * This should fix some warnings dragged in from Clara 599* MSVC's CLR exceptions are supported 600 601 602### Fixes 603* Fixed compilation when comparison operators do not return bool (#1147) 604* Fixed CLR exceptions blowing up the executable during translation (#1138) 605 606 607### Other changes 608* Many CMake changes 609 * `NO_SELFTEST` option is deprecated, use `BUILD_TESTING` instead. 610 * Catch specific CMake options were prefixed with `CATCH_` for namespacing purposes 611 * Other changes to simplify Catch2's packaging 612 613 614 615## 2.1.0 616 617### Improvements 618* Various performance improvements 619 * On top of the performance regression fixes 620* Experimental support for PCH was added (#1061) 621* `CATCH_CONFIG_EXTERNAL_INTERFACES` now brings in declarations of Console, Compact, XML and JUnit reporters 622* `MatcherBase` no longer has a pointless second template argument 623* Reduced the number of warning suppressions that leak into user's code 624 * Bugs in g++ 4.x and 5.x mean that some of them have to be left in 625 626 627### Fixes 628* Fixed performance regression from Catch classic 629 * One of the performance improvement patches for Catch classic was not applied to Catch2 630* Fixed platform detection for iOS (#1084) 631* Fixed compilation when `g++` is used together with `libc++` (#1110) 632* Fixed TeamCity reporter compilation with the single header version 633 * To fix the underlying issue we will be versioning reporters in single_include folder per release 634* The XML reporter will now report `WARN` messages even when not used with `-s` 635* Fixed compilation when `VectorContains` matcher was combined using `&&` (#1092) 636* Fixed test duration overflowing after 10 seconds (#1125, #1129) 637* Fixed `std::uncaught_exception` deprecation warning (#1124) 638 639 640### New features 641* New Matchers 642 * Regex matcher for strings, `Matches`. 643 * Set-equal matcher for vectors, `UnorderedEquals` 644 * Floating point matchers, `WithinAbs` and `WithinULP`. 645* Stringification now attempts to decompose all containers (#606) 646 * Containers are objects that respond to ADL `begin(T)` and `end(T)`. 647 648 649### Other changes 650* Reporters will now be versioned in the `single_include` folder to ensure their compatibility with the last released version 651 652 653 654 655## 2.0.1 656 657### Breaking changes 658* Removed C++98 support 659* Removed legacy reporter support 660* Removed legacy generator support 661 * Generator support will come back later, reworked 662* Removed `Catch::toString` support 663 * The new stringification machinery uses `Catch::StringMaker` specializations first and `operator<<` overloads second. 664* Removed legacy `SCOPED_MSG` and `SCOPED_INFO` macros 665* Removed `INTERNAL_CATCH_REGISTER_REPORTER` 666 * `CATCH_REGISTER_REPORTER` should be used to register reporters 667* Removed legacy `[hide]` tag 668 * `[.]`, `[.foo]` and `[!hide]` are still supported 669* Output into debugger is now colourized 670* `*_THROWS_AS(expr, exception_type)` now unconditionally appends `const&` to the exception type. 671* `CATCH_CONFIG_FAST_COMPILE` now affects the `CHECK_` family of assertions as well as `REQUIRE_` family of assertions 672 * This is most noticeable in `CHECK(throws())`, which would previously report failure, properly stringify the exception and continue. Now it will report failure and stop executing current section. 673* Removed deprecated matcher utility functions `Not`, `AllOf` and `AnyOf`. 674 * They are superseded by operators `!`, `&&` and `||`, which are natural and do not have limited arity 675* Removed support for non-const comparison operators 676 * Non-const comparison operators are an abomination that should not exist 677 * They were breaking support for comparing function to function pointer 678* `std::pair` and `std::tuple` are no longer stringified by default 679 * This is done to avoid dragging in `<tuple>` and `<utility>` headers in common path 680 * Their stringification can be enabled per-file via new configuration macros 681* `Approx` is subtly different and hopefully behaves more as users would expect 682 * `Approx::scale` defaults to `0.0` 683 * `Approx::epsilon` no longer applies to the larger of the two compared values, but only to the `Approx`'s value 684 * `INFINITY == Approx(INFINITY)` returns true 685 686 687### Improvements 688* Reporters and Listeners can be defined in files different from the main file 689 * The file has to define `CATCH_CONFIG_EXTERNAL_INTERFACES` before including catch.hpp. 690* Errors that happen during set up before main are now caught and properly reported once main is entered 691 * If you are providing your own main, you can access and use these as well. 692* New assertion macros, *_THROWS_MATCHES(expr, exception_type, matcher) are provided 693 * As the arguments suggest, these allow you to assert that an expression throws desired type of exception and pass the exception to a matcher. 694* JUnit reporter no longer has significantly different output for test cases with and without sections 695* Most assertions now support expressions containing commas (ie `REQUIRE(foo() == std::vector<int>{1, 2, 3});`) 696* Catch now contains experimental micro benchmarking support 697 * See `projects/SelfTest/Benchmark.tests.cpp` for examples 698 * The support being experiment means that it can be changed without prior notice 699* Catch uses new CLI parsing library (Clara) 700 * Users can now easily add new command line options to the final executable 701 * This also leads to some changes in `Catch::Session` interface 702* All parts of matchers can be removed from a TU by defining `CATCH_CONFIG_DISABLE_MATCHERS` 703 * This can be used to somewhat speed up compilation times 704* An experimental implementation of `CATCH_CONFIG_DISABLE` has been added 705 * Inspired by Doctest's `DOCTEST_CONFIG_DISABLE` 706 * Useful for implementing tests in source files 707 * ie for functions in anonymous namespaces 708 * Removes all assertions 709 * Prevents `TEST_CASE` registrations 710 * Exception translators are not registered 711 * Reporters are not registered 712 * Listeners are not registered 713* Reporters/Listeners are now notified of fatal errors 714 * This means specific signals or structured exceptions 715 * The Reporter/Listener interface provides default, empty, implementation to preserve backward compatibility 716* Stringification of `std::chrono::duration` and `std::chrono::time_point` is now supported 717 * Needs to be enabled by a per-file compile time configuration option 718* Add `pkg-config` support to CMake install command 719 720 721### Fixes 722* Don't use console colour if running in XCode 723* Explicit constructor in reporter base class 724* Swept out `-Wweak-vtables`, `-Wexit-time-destructors`, `-Wglobal-constructors` warnings 725* Compilation for Universal Windows Platform (UWP) is supported 726 * SEH handling and colorized output are disabled when compiling for UWP 727* Implemented a workaround for `std::uncaught_exception` issues in libcxxrt 728 * These issues caused incorrect section traversals 729 * The workaround is only partial, user's test can still trigger the issue by using `throw;` to rethrow an exception 730* Suppressed C4061 warning under MSVC 731 732 733### Internal changes 734* The development version now uses .cpp files instead of header files containing implementation. 735 * This makes partial rebuilds much faster during development 736* The expression decomposition layer has been rewritten 737* The evaluation layer has been rewritten 738* New library (TextFlow) is used for formatting text to output 739 740 741## Older versions 742 743### 1.12.x 744 745#### 1.12.2 746##### Fixes 747* Fixed missing <cassert> include 748 749#### 1.12.1 750 751##### Fixes 752* Fixed deprecation warning in `ScopedMessage::~ScopedMessage` 753* All uses of `min` or `max` identifiers are now wrapped in parentheses 754 * This avoids problems when Windows headers define `min` and `max` macros 755 756#### 1.12.0 757 758##### Fixes 759* Fixed compilation for strict C++98 mode (ie not gnu++98) and older compilers (#1103) 760* `INFO` messages are included in the `xml` reporter output even without `-s` specified. 761 762 763### 1.11.x 764 765#### 1.11.0 766 767##### Fixes 768* The original expression in `REQUIRE_FALSE( expr )` is now reporter properly as `!( expr )` (#1051) 769 * Previously the parentheses were missing and `x != y` would be expanded as `!x != x` 770* `Approx::Margin` is now inclusive (#952) 771 * Previously it was meant and documented as inclusive, but the check itself wasn't 772 * This means that `REQUIRE( 0.25f == Approx( 0.0f ).margin( 0.25f ) )` passes, instead of fails 773* `RandomNumberGenerator::result_type` is now unsigned (#1050) 774 775##### Improvements 776* `__JETBRAINS_IDE__` macro handling is now CLion version specific (#1017) 777 * When CLion 2017.3 or newer is detected, `__COUNTER__` is used instead of 778* TeamCity reporter now explicitly flushes output stream after each report (#1057) 779 * On some platforms, output from redirected streams would show up only after the tests finished running 780* `ParseAndAddCatchTests` now can add test files as dependency to CMake configuration 781 * This means you do not have to manually rerun CMake configuration step to detect new tests 782 783### 1.10.x 784 785#### 1.10.0 786 787##### Fixes 788* Evaluation layer has been rewritten (backported from Catch 2) 789 * The new layer is much simpler and fixes some issues (#981) 790* Implemented workaround for VS 2017 raw string literal stringification bug (#995) 791* Fixed interaction between `[!shouldfail]` and `[!mayfail]` tags and sections 792 * Previously sections with failing assertions would be marked as failed, not failed-but-ok 793 794##### Improvements 795* Added [libidentify](https://github.com/janwilmans/LibIdentify) support 796* Added "wait-for-keypress" option 797 798### 1.9.x 799 800#### 1.9.6 801 802##### Improvements 803* Catch's runtime overhead has been significantly decreased (#937, #939) 804* Added `--list-extra-info` cli option (#934). 805 * It lists all tests together with extra information, ie filename, line number and description. 806 807 808 809#### 1.9.5 810 811##### Fixes 812* Truthy expressions are now reconstructed properly, not as booleans (#914) 813* Various warnings are no longer erroneously suppressed in test files (files that include `catch.hpp`, but do not define `CATCH_CONFIG_MAIN` or `CATCH_CONFIG_RUNNER`) (#871) 814* Catch no longer fails to link when main is compiled as C++, but linked against Objective-C (#855) 815* Fixed incorrect gcc version detection when deciding to use `__COUNTER__` (#928) 816 * Previously any GCC with minor version less than 3 would be incorrectly classified as not supporting `__COUNTER__`. 817* Suppressed C4996 warning caused by upcoming updated to MSVC 2017, marking `std::uncaught_exception` as deprecated. (#927) 818 819##### Improvements 820* CMake integration script now incorporates debug messages and registers tests in an improved way (#911) 821* Various documentation improvements 822 823 824 825#### 1.9.4 826 827##### Fixes 828* `CATCH_FAIL` macro no longer causes compilation error without variadic macro support 829* `INFO` messages are no longer cleared after being reported once 830 831##### Improvements and minor changes 832* Catch now uses `wmain` when compiled under Windows and `UNICODE` is defined. 833 * Note that Catch still officially supports only ASCII 834 835#### 1.9.3 836 837##### Fixes 838* Completed the fix for (lack of) uint64_t in earlier Visual Studios 839 840#### 1.9.2 841 842##### Improvements and minor changes 843* All of `Approx`'s member functions now accept strong typedefs in C++11 mode (#888) 844 * Previously `Approx::scale`, `Approx::epsilon`, `Approx::margin` and `Approx::operator()` didn't. 845 846 847##### Fixes 848* POSIX signals are now disabled by default under QNX (#889) 849 * QNX does not support current enough (2001) POSIX specification 850* JUnit no longer counts exceptions as failures if given test case is marked as ok to fail. 851* `Catch::Option` should now have its storage properly aligned. 852* Catch no longer attempts to define `uint64_t` on windows (#862) 853 * This was causing trouble when compiled under Cygwin 854 855##### Other 856* Catch is now compiled under MSVC 2017 using `std:c++latest` (C++17 mode) in CI 857* We now provide cmake script that autoregisters Catch tests into ctest. 858 * See `contrib` folder. 859 860 861#### 1.9.1 862 863##### Fixes 864* Unexpected exceptions are no longer ignored by default (#885, #887) 865 866 867#### 1.9.0 868 869 870##### Improvements and minor changes 871* Catch no longer attempts to ensure the exception type passed by user in `REQUIRE_THROWS_AS` is a constant reference. 872 * It was causing trouble when `REQUIRE_THROWS_AS` was used inside templated functions 873 * This actually reverts changes made in v1.7.2 874* Catch's `Version` struct should no longer be double freed when multiple instances of Catch tests are loaded into single program (#858) 875 * It is now a static variable in an inline function instead of being an `extern`ed struct. 876* Attempt to register invalid tag or tag alias now throws instead of calling `exit()`. 877 * Because this happen before entering main, it still aborts execution 878 * Further improvements to this are coming 879* `CATCH_CONFIG_FAST_COMPILE` now speeds-up compilation of `REQUIRE*` assertions by further ~15%. 880 * The trade-off is disabling translation of unexpected exceptions into text. 881* When Catch is compiled using C++11, `Approx` is now constructible with anything that can be explicitly converted to `double`. 882* Captured messages are now printed on unexpected exceptions 883 884##### Fixes: 885* Clang's `-Wexit-time-destructors` should be suppressed for Catch's internals 886* GCC's `-Wparentheses` is now suppressed for all TU's that include `catch.hpp`. 887 * This is functionally a revert of changes made in 1.8.0, where we tried using `_Pragma` based suppression. This should have kept the suppression local to Catch's assertions, but bugs in GCC's handling of `_Pragma`s in C++ mode meant that it did not always work. 888* You can now tell Catch to use C++11-based check when checking whether a type can be streamed to output. 889 * This fixes cases when an unstreamable type has streamable private base (#877) 890 * [Details can be found in documentation](configuration.md#catch_config_cpp11_stream_insertable_check) 891 892 893##### Other notes: 894* We have added VS 2017 to our CI 895* Work on Catch 2 should start soon 896 897 898 899### 1.8.x 900 901#### 1.8.2 902 903 904##### Improvements and minor changes 905* TAP reporter now behaves as if `-s` was always set 906 * This should be more consistent with the protocol desired behaviour. 907* Compact reporter now obeys `-d yes` argument (#780) 908 * The format is "XXX.123 s: <section-name>" (3 decimal places are always present). 909 * Before it did not report the durations at all. 910* XML reporter now behaves the same way as Console reporter in regards to `INFO` 911 * This means it reports `INFO` messages on success, if output on success (`-s`) is enabled. 912 * Previously it only reported `INFO` messages on failure. 913* `CAPTURE(expr)` now stringifies `expr` in the same way assertion macros do (#639) 914* Listeners are now finally [documented](event-listeners.md#top). 915 * Listeners provide a way to hook into events generated by running your tests, including start and end of run, every test case, every section and every assertion. 916 917 918##### Fixes: 919* Catch no longer attempts to reconstruct expression that led to a fatal error (#810) 920 * This fixes possible signal/SEH loop when processing expressions, where the signal was triggered by expression decomposition. 921* Fixed (C4265) missing virtual destructor warning in Matchers (#844) 922* `std::string`s are now taken by `const&` everywhere (#842). 923 * Previously some places were taking them by-value. 924* Catch should no longer change errno (#835). 925 * This was caused by libstdc++ bug that we now work around. 926* Catch now provides `FAIL_CHECK( ... )` macro (#765). 927 * Same as `FAIL( ... )`, but does not abort the test. 928* Functions like `fabs`, `tolower`, `memset`, `isalnum` are now used with `std::` qualification (#543). 929* Clara no longer assumes first argument (binary name) is always present (#729) 930 * If it is missing, empty string is used as default. 931* Clara no longer reads 1 character past argument string (#830) 932* Regression in Objective-C bindings (Matchers) fixed (#854) 933 934 935##### Other notes: 936* We have added VS 2013 and 2015 to our CI 937* Catch Classic (1.x.x) now contains its own, forked, version of Clara (the argument parser). 938 939 940 941#### 1.8.1 942 943##### Fixes 944 945Cygwin issue with `gettimeofday` - `#define` was not early enough 946 947#### 1.8.0 948 949##### New features/ minor changes 950 951* Matchers have new, simpler (and documented) interface. 952 * Catch provides string and vector matchers. 953 * For details see [Matchers documentation](matchers.md#top). 954* Changed console reporter test duration reporting format (#322) 955 * Old format: `Some simple comparisons between doubles completed in 0.000123s` 956 * New format: `xxx.123s: Some simple comparisons between doubles` _(There will always be exactly 3 decimal places)_ 957* Added opt-in leak detection under MSVC + Windows (#439) 958 * Enable it by compiling Catch's main with `CATCH_CONFIG_WINDOWS_CRTDBG` 959* Introduced new compile-time flag, `CATCH_CONFIG_FAST_COMPILE`, trading features for compilation speed. 960 * Moves debug breaks out of tests and into implementation, speeding up test compilation time (~10% on linux). 961 * _More changes are coming_ 962* Added [TAP (Test Anything Protocol)](https://testanything.org/) and [Automake](https://www.gnu.org/software/automake/manual/html_node/Log-files-generation-and-test-results-recording.html#Log-files-generation-and-test-results-recording) reporters. 963 * These are not present in the default single-include header and need to be downloaded from GitHub separately. 964 * For details see [documentation about integrating with build systems](build-systems.md#top). 965* XML reporter now reports filename as part of the `Section` and `TestCase` tags. 966* `Approx` now supports an optional margin of absolute error 967 * It has also received [new documentation](assertions.md#top). 968 969##### Fixes 970* Silenced C4312 ("conversion from int to 'ClassName *") warnings in the evaluate layer. 971* Fixed C4512 ("assignment operator could not be generated") warnings under VS2013. 972* Cygwin compatibility fixes 973 * Signal handling is no longer compiled by default. 974 * Usage of `gettimeofday` inside Catch should no longer cause compilation errors. 975* Improved `-Wparentheses` suppression for gcc (#674) 976 * When compiled with gcc 4.8 or newer, the suppression is localized to assertions only 977 * Otherwise it is suppressed for the whole TU 978* Fixed test spec parser issue (with escapes in multiple names) 979 980##### Other 981* Various documentation fixes and improvements 982 983 984### 1.7.x 985 986#### 1.7.2 987 988##### Fixes and minor improvements 989Xml: 990 991(technically the first two are breaking changes but are also fixes and arguably break few if any people) 992* C-escape control characters instead of XML encoding them (which requires XML 1.1) 993* Revert XML output to XML 1.0 994* Can provide stylesheet references by extending the XML reporter 995* Added description and tags attributes to XML Reporter 996* Tags are closed and the stream flushed more eagerly to avoid stdout interpolation 997 998 999Other: 1000* `REQUIRE_THROWS_AS` now catches exception by `const&` and reports expected type 1001* In `SECTION`s the file/ line is now of the `SECTION`. not the `TEST_CASE` 1002* Added std:: qualification to some functions from C stdlib 1003* Removed use of RTTI (`dynamic_cast`) that had crept back in 1004* Silenced a few more warnings in different circumstances 1005* Travis improvements 1006 1007#### 1.7.1 1008 1009##### Fixes: 1010* Fixed inconsistency in defining `NOMINMAX` and `WIN32_LEAN_AND_MEAN` inside `catch.hpp`. 1011* Fixed SEH-related compilation error under older MinGW compilers, by making Windows SEH handling opt-in for compilers other than MSVC. 1012 * For specifics, look into the [documentation](configuration.md#top). 1013* Fixed compilation error under MinGW caused by improper compiler detection. 1014* Fixed XML reporter sometimes leaving an empty output file when a test ends with signal/structured exception. 1015* Fixed XML reporter not reporting captured stdout/stderr. 1016* Fixed possible infinite recursion in Windows SEH. 1017* Fixed possible compilation error caused by Catch's operator overloads being ambiguous in regards to user-defined templated operators. 1018 1019#### 1.7.0 1020 1021##### Features/ Changes: 1022* Catch now runs significantly faster for passing tests 1023 * Microbenchmark focused on Catch's overhead went from ~3.4s to ~0.7s. 1024 * Real world test using [JSON for Modern C++](https://github.com/nlohmann/json)'s test suite went from ~6m 25s to ~4m 14s. 1025* Catch can now run specific sections within test cases. 1026 * For now the support is only basic (no wildcards or tags), for details see the [documentation](command-line.md#top). 1027* Catch now supports SEH on Windows as well as signals on Linux. 1028 * After receiving a signal, Catch reports failing assertion and then passes the signal onto the previous handler. 1029* Approx can be used to compare values against strong typedefs (available in C++11 mode only). 1030 * Strong typedefs mean types that are explicitly convertible to double. 1031* CHECK macro no longer stops executing section if an exception happens. 1032* Certain characters (space, tab, etc) are now pretty printed. 1033 * This means that a `char c = ' '; REQUIRE(c == '\t');` would be printed as `' ' == '\t'`, instead of ` == 9`. 1034 1035##### Fixes: 1036* Text formatting no longer attempts to access out-of-bounds characters under certain conditions. 1037* THROW family of assertions no longer trigger `-Wunused-value` on expressions containing explicit cast. 1038* Breaking into debugger under OS X works again and no longer required `DEBUG` to be defined. 1039* Compilation no longer breaks under certain compiler if a lambda is used inside assertion macro. 1040 1041##### Other: 1042* Catch's CMakeLists now defines install command. 1043* Catch's CMakeLists now generates projects with warnings enabled. 1044 1045 1046### 1.6.x 1047 1048#### 1.6.1 1049 1050##### Features/ Changes: 1051* Catch now supports breaking into debugger on Linux 1052 1053##### Fixes: 1054* Generators no longer leak memory (generators are still unsupported in general) 1055* JUnit reporter now reports UTC timestamps, instead of "tbd" 1056* `CHECK_THAT` macro is now properly defined as `CATCH_CHECK_THAT` when using `CATCH_` prefixed macros 1057 1058##### Other: 1059* Types with overloaded `&&` operator are no longer evaluated twice when used in an assertion macro. 1060* The use of `__COUNTER__` is suppressed when Catch is parsed by CLion 1061 * This change is not active when compiling a binary 1062* Approval tests can now be run on Windows 1063* CMake will now warn if a file is present in the `include` folder but not is not enumerated as part of the project 1064* Catch now defines `NOMINMAX` and `WIN32_LEAN_AND_MEAN` before including `windows.h` 1065 * This can be disabled if needed, see [documentation](configuration.md#top) for details. 1066 1067 1068#### 1.6.0 1069 1070##### Cmake/ projects: 1071* Moved CMakeLists.txt to root, made it friendlier for CLion and generating XCode and VS projects, and removed the manually maintained XCode and VS projects. 1072 1073##### Features/ Changes: 1074* Approx now supports `>=` and `<=` 1075* Can now use `\` to escape chars in test names on command line 1076* Standardize C++11 feature toggles 1077 1078##### Fixes: 1079* Blue shell colour 1080* Missing argument to `CATCH_CHECK_THROWS` 1081* Don't encode extended ASCII in XML 1082* use `std::shuffle` on more compilers (fixes deprecation warning/error) 1083* Use `__COUNTER__` more consistently (where available) 1084 1085##### Other: 1086* Tweaks and changes to scripts - particularly for Approval test - to make them more portable 1087 1088 1089## Even Older versions 1090Release notes were not maintained prior to v1.6.0, but you should be able to work them out from the Git history 1091 1092--- 1093 1094[Home](Readme.md#top) 1095