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

summaryrefslogtreecommitdiffhomepage
diff options
context:
space:
mode:
authorLeitwolf112026-11-17 22:00:16 +0300
committerLeitwolf112026-11-17 22:00:16 +0300
commit0f987a33220d3217a4e3e8416ce413f9983e3aa0 (patch)
treebe5fad6dc9621404418a1793139050f6ad5bb2f6
parent95e2cad52aa1dd573ea0e6075af0fdd49c30a78a (diff)
downloadcatch3-build/catch3-link-names.tar.gz
Keep the debug "d": a debug build is not the same librarybuild/catch3-link-names
The previous commit dropped CMake's DEBUG_POSTFIX on every platform. A debug build is a different library from a release build, so it keeps its own name, libCatch3d and libCatch3Maind. The released archives and the Progmasoft Linux packages hold release builds, which are libCatch3 and libCatch3Main, so an installed Catch3 links with -lCatch3 and -lCatch3Main. The Ubuntu install job links with -lCatch3Maind -lCatch3d in its Debug rows and with -lCatch3Main -lCatch3 in its Release rows; pkg-config gives the right names in both. The documentation names both. Checked locally: a Release install gives libCatch3.a and libCatch3Main.a, a Debug install libCatch3d.a and libCatch3Maind.a; a test links and passes with each, and pkg-config prints the matching flags. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
-rw-r--r--.github/workflows/linux-builds.yml7
-rw-r--r--docs/progmasoft-catch3.md6
-rw-r--r--src/CMakeLists.txt9
3 files changed, 16 insertions, 6 deletions
diff --git a/.github/workflows/linux-builds.yml b/.github/workflows/linux-builds.yml
index 877b1501..16be72a1 100644
--- a/.github/workflows/linux-builds.yml
+++ b/.github/workflows/linux-builds.yml
@@ -74,14 +74,19 @@ jobs:
#include <Progmasoft/Catch3.hpp>
TEST_CASE("an installed Catch3 links by its name") { REQUIRE(1 + 1 == 2); }
EOF
+ # A debug build is named apart with a "d".
+ d=""
+ if [ "$BUILD_TYPE" = Debug ]; then d=d; fi
clang++ -std=c++${{matrix.std}} -I"$prefix/include" "$RUNNER_TEMP/consumer/test.cpp" \
- -L"$prefix/lib" -lCatch3Main -lCatch3 -o "$RUNNER_TEMP/consumer/by-name"
+ -L"$prefix/lib" "-lCatch3Main$d" "-lCatch3$d" -o "$RUNNER_TEMP/consumer/by-name"
"$RUNNER_TEMP/consumer/by-name"
export PKG_CONFIG_PATH="$prefix/share/pkgconfig"
# shellcheck disable=SC2046 # pkg-config prints several flags.
clang++ -std=c++${{matrix.std}} "$RUNNER_TEMP/consumer/test.cpp" \
$(pkg-config --cflags --libs catch3-with-main) -o "$RUNNER_TEMP/consumer/by-pkg-config"
"$RUNNER_TEMP/consumer/by-pkg-config"
+ env:
+ BUILD_TYPE: ${{matrix.build_type}}
thread-sanitizer:
name: Ubuntu 26.04, C++17, ThreadSanitizer and UBSan
diff --git a/docs/progmasoft-catch3.md b/docs/progmasoft-catch3.md
index a28bc7e1..fadff6aa 100644
--- a/docs/progmasoft-catch3.md
+++ b/docs/progmasoft-catch3.md
@@ -181,8 +181,10 @@ target_link_libraries(MyTests PRIVATE Catch3::Catch3WithMain)
Without a build system, an installed Catch3 links by its name: the library is
`Catch3` and the one that brings `main` is `Catch3Main`, as `libCatch3.a` and
-`libCatch3Main.a` (`Catch3.lib` and `Catch3Main.lib` on Windows), in every
-build configuration. `Catch3Main` comes first, since it uses `Catch3`:
+`libCatch3Main.a` (`Catch3.lib` and `Catch3Main.lib` on Windows). The released
+archives and packages hold these release builds; a debug build made with
+CMake is named apart, `Catch3d` and `Catch3Maind`. `Catch3Main` comes first,
+since it uses `Catch3`:
```sh
c++ -std=c++17 tests.cpp -lCatch3Main -lCatch3
diff --git a/src/CMakeLists.txt b/src/CMakeLists.txt
index 5e4cb935..f0de95b4 100644
--- a/src/CMakeLists.txt
+++ b/src/CMakeLists.txt
@@ -399,10 +399,11 @@ target_link_libraries(Catch3
)
# The files are libCatch3 and libCatch3Main (Catch3.lib and Catch3Main.lib on
-# Windows) in every configuration, so that an installed Catch3 links with
-# -lCatch3 and -lCatch3Main. Released archives and packages hold release
-# builds, so a debug build needs no name of its own.
+# Windows), so that an installed Catch3 links with -lCatch3 and -lCatch3Main.
+# A debug build is not the same library and is named apart with a "d"; the
+# released archives and packages hold release builds.
set_target_properties(Catch3 PROPERTIES
+ DEBUG_POSTFIX "d"
VERSION ${PROJECT_VERSION}
SOVERSION ${PROJECT_VERSION}
)
@@ -437,6 +438,8 @@ set_target_properties(Catch3WithMain
VERSION ${PROJECT_VERSION}
SOVERSION ${PROJECT_VERSION}
)
+set_target_properties(Catch3WithMain PROPERTIES DEBUG_POSTFIX "d")
+
if(NOT_SUBPROJECT)
# Create and install an export set for the targets as Catch3::Catch3 and
# Catch3::Catch3WithMain.