From 08cd516749d31ce8ff29dfd2f2ddc8868b408a12 Mon Sep 17 00:00:00 2001 From: Vadim Zeitlin Date: Sun, 12 Jun 2022 21:16:29 +0200 Subject: [PATCH] Document that clang is required for building wxOSX Due to the use of Apple-specific extensions in the SDK headers, gcc can't be used to compile wxOSX any more. Closes #22519. --- docs/doxygen/mainpages/introduction.h | 4 ++-- docs/doxygen/mainpages/platdetails.h | 4 ++++ 2 files changed, 6 insertions(+), 2 deletions(-) diff --git a/docs/doxygen/mainpages/introduction.h b/docs/doxygen/mainpages/introduction.h index f1529d786d..02f115413b 100644 --- a/docs/doxygen/mainpages/introduction.h +++ b/docs/doxygen/mainpages/introduction.h @@ -91,8 +91,8 @@ NetBSD, Solaris, AIX, ...) and require GTK+ 2.6 or later or GTK+ 3.x. The primary supported compiler is GNU g++. @li wxOSX/Cocoa: This is the native port for Apple computers. wxOSX/Cocoa -supports 32 or 64 bit Intel Macs running macOS 10.10 or later. The port can be -built either with g++ or clang. +supports 32 or 64 bit Intel Macs running macOS 10.10 or later. The port can +currently be only built using Apple clang. Other platforms (e.g. iOS - with a minimum requirement of iOS 13), compilers (Sun CC, HP-UX aCC, IBM xlC or SGI mipsPro under Unix) and ports (wxQT, wxGTK1, diff --git a/docs/doxygen/mainpages/platdetails.h b/docs/doxygen/mainpages/platdetails.h index 309a330258..3356b7bc43 100644 --- a/docs/doxygen/mainpages/platdetails.h +++ b/docs/doxygen/mainpages/platdetails.h @@ -54,6 +54,10 @@ wxOSX/Cocoa is the port of wxWidgets for the macOS platform. It requires a minimum SDK 10.11, Xcode 7.2.1 or greater (runs under 10.10.5 and higher), and supports x86_64 (but not i386) and ARM builds and deploying under 10.10. +Note that Apple clang must be used to build wxOSX, due to the use of +Apple-specific extensions ("blocks") in the macOS SDK headers, and hence the +applications using it must be built using clang as well. + @subpage plat_osx_install "Build and Install Instructions"