From aa6dd3031a5e103dd1a91993448477add7da2dea Mon Sep 17 00:00:00 2001 From: yyc12345 Date: Fri, 23 Jan 2026 20:46:26 +0800 Subject: [PATCH] doc: update compile manual --- COMPILE.md | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/COMPILE.md b/COMPILE.md index 6e5d069..3361dd1 100644 --- a/COMPILE.md +++ b/COMPILE.md @@ -27,10 +27,16 @@ So you actually do not need Google Test, Google Benchmark and Doxygen. ### Compiler > [!WARNING] -> You may face some issues when building on macOS with Clang. That's not your fault. -> Clang used libc++ library lacks some essential features used by this project. -> A possible solution is that use GCC and libstdc++ on macOS instead of default Clang and libc++. -> Build issue may be resolved until libc++ finish these features: `std::stacktrace` and `std::views::enumerate`. +> You may face some issues when building on macOS with Apple Clang. That's not your fault. +> Clang and Apple Clang used libc++ library lacks some essential features used by this project. +> This is especially not good for Apple Clang because Apple Clang is usually behind Clang a bunch of versions. +> +> For resolving this issue, I have written a series of patch header files for libcxx and you can find them in include directory. +> This project should be compiled on macOS but everything has exception. +> If you really have this issue, a possible solution is that use GCC and libstdc++ on macOS instead of default Clang and libc++. +> +> Build issue may be resolved until libc++ finish these features: complete `std::from_chars` and `std::to_chars`, +> `std::stacktrace` and `std::views::enumerate`. ### Google Test