From 1369f3dd6b10ed7ea940645fbc9d6df4f63e9121 Mon Sep 17 00:00:00 2001 From: Jordan Smith Date: Thu, 10 Jul 2025 10:35:27 -0400 Subject: [PATCH 1/6] add minimum compiler versions to build from source --- source/get-started.txt | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/source/get-started.txt b/source/get-started.txt index 5eeec7e..f3a64c2 100644 --- a/source/get-started.txt +++ b/source/get-started.txt @@ -38,6 +38,18 @@ programming language, see our :driver:`list of official drivers <>`. .. _cpp-quick-start-download-and-install: +Minimum Compiler Requirements +----------------------------- + +To build the MongoDB C++ driver from source, you must use a compiler that meets the following minimum version requirements: + +- GCC 8.1 or newer +- Clang 3.8 or newer +- Apple Clang 13.1 or newer +- MSVC 19.0.24210 (Visual Studio 2015 Update 3) or newer + +These requirements apply only when building from source. Using prebuilt headers and libraries does not require these compiler versions. + Download and Install -------------------- From d59c8969690d5a246df98c562a8ef4147a5a57b1 Mon Sep 17 00:00:00 2001 From: Jordan Smith Date: Thu, 10 Jul 2025 10:56:29 -0400 Subject: [PATCH 2/6] integrate with dependencies section --- source/get-started.txt | 21 +++++++-------------- 1 file changed, 7 insertions(+), 14 deletions(-) diff --git a/source/get-started.txt b/source/get-started.txt index f3a64c2..aa3f008 100644 --- a/source/get-started.txt +++ b/source/get-started.txt @@ -38,18 +38,6 @@ programming language, see our :driver:`list of official drivers <>`. .. _cpp-quick-start-download-and-install: -Minimum Compiler Requirements ------------------------------ - -To build the MongoDB C++ driver from source, you must use a compiler that meets the following minimum version requirements: - -- GCC 8.1 or newer -- Clang 3.8 or newer -- Apple Clang 13.1 or newer -- MSVC 19.0.24210 (Visual Studio 2015 Update 3) or newer - -These requirements apply only when building from source. Using prebuilt headers and libraries does not require these compiler versions. - Download and Install -------------------- @@ -61,8 +49,13 @@ Download and Install Before you begin this tutorial, ensure you have the following dependencies installed in your development environment: - - Compiler that supports C++17, such as `GCC `__, `Clang `__, - or `Visual Studio `__ + - Compiler that supports C++17, such as one of the following: + + - `GCC `__ v8.1 or newer + - `Clang `__ v3.8 or newer + - `Apple Clang `__ v13.1 or newer + - `Visual Studio `__ 2015 Update 3 or newer + - `CMake `__ v3.15 or later - `pkg-config `__ From 28ef9234e93c83ecf936e27fc579ed9df20c865c Mon Sep 17 00:00:00 2001 From: Jordan Smith Date: Thu, 10 Jul 2025 11:25:32 -0400 Subject: [PATCH 3/6] feedback --- source/get-started.txt | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/source/get-started.txt b/source/get-started.txt index aa3f008..78abde4 100644 --- a/source/get-started.txt +++ b/source/get-started.txt @@ -51,11 +51,11 @@ Download and Install - Compiler that supports C++17, such as one of the following: - - `GCC `__ v8.1 or newer - - `Clang `__ v3.8 or newer - - `Apple Clang `__ v13.1 or newer - - `Visual Studio `__ 2015 Update 3 or newer - + - `GCC `__ v8.1 or later + - `Clang `__ v3.8 or later + - `Apple Clang `__ v13.1 or later + - `Visual Studio `__ 2015 Update 3 or later + - `CMake `__ v3.15 or later - `pkg-config `__ From 919f95c5435b93021de56abaefa825651ce3d2c2 Mon Sep 17 00:00:00 2001 From: Jordan Smith Date: Thu, 10 Jul 2025 13:33:05 -0400 Subject: [PATCH 4/6] move to compatibility page --- source/compatibility.txt | 9 ++++++- source/get-started.txt | 9 ++----- .../compiler-compatibility-table-cxx.rst | 25 +++++++++++++++++++ 3 files changed, 35 insertions(+), 8 deletions(-) create mode 100644 source/includes/compiler-compatibility-table-cxx.rst diff --git a/source/compatibility.txt b/source/compatibility.txt index aab7fd4..740bdd7 100644 --- a/source/compatibility.txt +++ b/source/compatibility.txt @@ -53,4 +53,11 @@ The first column lists the driver version. .. include:: /includes/libmongoc-compatibility-table-cxx.rst For more information on how to read the compatibility tables, see our guide on -:ref:`MongoDB Compatibility Tables. ` \ No newline at end of file +:ref:`MongoDB Compatibility Tables. ` + +Compiler Compatibility +---------------------- + +The {+driver-short+} supports the following compilers: + +.. include:: /includes/compiler-compatibility-table-cxx.rst diff --git a/source/get-started.txt b/source/get-started.txt index 78abde4..5eeec7e 100644 --- a/source/get-started.txt +++ b/source/get-started.txt @@ -49,13 +49,8 @@ Download and Install Before you begin this tutorial, ensure you have the following dependencies installed in your development environment: - - Compiler that supports C++17, such as one of the following: - - - `GCC `__ v8.1 or later - - `Clang `__ v3.8 or later - - `Apple Clang `__ v13.1 or later - - `Visual Studio `__ 2015 Update 3 or later - + - Compiler that supports C++17, such as `GCC `__, `Clang `__, + or `Visual Studio `__ - `CMake `__ v3.15 or later - `pkg-config `__ diff --git a/source/includes/compiler-compatibility-table-cxx.rst b/source/includes/compiler-compatibility-table-cxx.rst new file mode 100644 index 0000000..68bdbd9 --- /dev/null +++ b/source/includes/compiler-compatibility-table-cxx.rst @@ -0,0 +1,25 @@ +.. list-table:: + :header-rows: 1 + :stub-columns: 1 + :class: compatibility-large + + * - Compiler + - Version + + * - `GCC `__ + - v8.1 or later + + * - `Clang `__ + - v3.8 or later + + * - `Apple Clang `__ + - v13.1 or later + + * - `Visual Studio `__ + - 2015 Update 3 or later + +.. note:: + + The preceding compiler versions are the minimum versions required to + build the {+driver-short+} from source. These are not requirements + needed for prebuilt headers and libraries. \ No newline at end of file From fed712d64152c78c0f5204c8b2dcef3fdaa46a41 Mon Sep 17 00:00:00 2001 From: Jordan Smith Date: Thu, 10 Jul 2025 14:29:05 -0400 Subject: [PATCH 5/6] move final note --- source/compatibility.txt | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/compatibility.txt b/source/compatibility.txt index 740bdd7..25ddc9b 100644 --- a/source/compatibility.txt +++ b/source/compatibility.txt @@ -52,12 +52,12 @@ The first column lists the driver version. .. include:: /includes/libmongoc-compatibility-table-cxx.rst -For more information on how to read the compatibility tables, see our guide on -:ref:`MongoDB Compatibility Tables. ` - Compiler Compatibility ---------------------- The {+driver-short+} supports the following compilers: .. include:: /includes/compiler-compatibility-table-cxx.rst + +For more information on how to read the compatibility tables, see our guide on +:ref:`MongoDB Compatibility Tables. ` \ No newline at end of file From e2b1562f670053a1457b4880e3caa42cdb43852a Mon Sep 17 00:00:00 2001 From: Jordan Smith Date: Fri, 11 Jul 2025 10:04:14 -0400 Subject: [PATCH 6/6] feedback --- source/includes/compiler-compatibility-table-cxx.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/includes/compiler-compatibility-table-cxx.rst b/source/includes/compiler-compatibility-table-cxx.rst index 68bdbd9..c8b0c11 100644 --- a/source/includes/compiler-compatibility-table-cxx.rst +++ b/source/includes/compiler-compatibility-table-cxx.rst @@ -6,13 +6,13 @@ * - Compiler - Version - * - `GCC `__ + * - `GCC `__ - v8.1 or later * - `Clang `__ - v3.8 or later - * - `Apple Clang `__ + * - `Xcode `__ - v13.1 or later * - `Visual Studio `__ @@ -22,4 +22,4 @@ The preceding compiler versions are the minimum versions required to build the {+driver-short+} from source. These are not requirements - needed for prebuilt headers and libraries. \ No newline at end of file + to use prebuilt headers and libraries. \ No newline at end of file