From 407ee0af2fb04fa9055e3361fa9aaf259de8c272 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Martin=20Ho=C5=99e=C5=88ovsk=C3=BD?= Date: Sun, 20 Oct 2019 19:43:19 +0200 Subject: [PATCH] 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 --- docs/limitations.md | 9 +++++++++ 1 file changed, 9 insertions(+) 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.