Read-only mirrors. Development, issues and pull requests are on GitHub.

summaryrefslogtreecommitdiffhomepage
path: root/docs
diff options
context:
space:
mode:
authorMartin Hořeňovský2019-10-20 19:43:19 +0200
committerMartin Hořeňovský2019-10-20 19:52:39 +0200
commit407ee0af2fb04fa9055e3361fa9aaf259de8c272 (patch)
tree9ac8278ac678841a2899b7652000b721e8135c7b /docs
parent060a41ec7b954cf6a556a88035f04b771680916b (diff)
downloadcatch3-407ee0af2fb04fa9055e3361fa9aaf259de8c272.tar.gz
Add a section on slow linking under MinGW to "Known Limitations" docs
Unless someone steps up to fix the long link times with a set of unobtrusive changes, the recommended solution will remain "use a better linker". Related to #1205, #1247, and #1637 Closes #1247 Closes #1637
Diffstat (limited to 'docs')
-rw-r--r--docs/limitations.md9
1 files changed, 9 insertions, 0 deletions
diff --git a/docs/limitations.md b/docs/limitations.md
index b95cd87f..c7a7733c 100644
--- a/docs/limitations.md
+++ b/docs/limitations.md
@@ -45,6 +45,15 @@ the `REQUIRE` family of macros), Catch2 does not know that there are no
more sections in that test case and must run the test case again.
+### MinGW/CygWin compilation (linking) is extremely slow
+
+Compiling Catch2 with MinGW can be exceedingly slow, especially during
+the linking step. As far as we can tell, this is caused by deficiencies
+in its default linker. If you can tell MinGW to instead use lld, via
+`-fuse-ld=ldd`, the link time should drop down to reasonable length
+again.
+
+
## Features
This section outlines some missing features, what is their status and their possible workarounds.