Merge branch 'PHP-8.3' into PHP-8.4

CMakeLists.txt

@@ -10,7 +10,7 @@ wrapper to bridge the upstream PHP source code with the CMake-based build system
 in this repository located at the cmake directory, streamlining the integration
 process.
 
-Basic usage:
+Usage:
 
   cmake -B <build-dir> [<options>...]
 

cmake/Zend/cmake/CheckFloatPrecision.cmake

@@ -26,6 +26,13 @@ See: https://wiki.php.net/rfc/rounding
 * `HAVE_FPU_INLINE_ASM_X86`
 
   Whether FPU control word can be manipulated by inline assembler.
+
+## Usage
+
+```cmake
+# CMakeLists.txt
+include(cmake/CheckFloatPrecision.cmake)
+```
 #]=============================================================================]
 
 include_guard(GLOBAL)

cmake/Zend/cmake/CheckGlobalRegisterVariables.cmake

@@ -12,6 +12,13 @@ See also: [GCC global register variables](https://gcc.gnu.org/onlinedocs/gcc/Glo
 * `HAVE_GCC_GLOBAL_REGS`
 
   Whether global register variables are supported.
+
+## Usage
+
+```cmake
+# CMakeLists.txt
+include(cmake/CheckGlobalRegisterVariables.cmake)
+```
 #]=============================================================================]
 
 include_guard(GLOBAL)

cmake/Zend/cmake/CheckMMAlignment.cmake

@@ -9,6 +9,13 @@ also does the logarithmic test.
 * `ZEND_MM_ALIGNMENT`
 * `ZEND_MM_ALIGNMENT_LOG2`
 * `ZEND_MM_NEED_EIGHT_BYTE_REALIGNMENT`
+
+## Usage
+
+```cmake
+# CMakeLists.txt
+include(cmake/CheckMMAlignment.cmake)
+```
 #]=============================================================================]
 
 include_guard(GLOBAL)

cmake/Zend/cmake/CheckStackDirection.cmake

@@ -8,6 +8,13 @@ Check whether the stack grows downwards. Assumes contiguous stack.
 * `ZEND_CHECK_STACK_LIMIT`
 
   Whether checking the stack limit is supported.
+
+## Usage
+
+```cmake
+# CMakeLists.txt
+include(cmake/CheckStackDirection.cmake)
+```
 #]=============================================================================]
 
 include_guard(GLOBAL)

cmake/Zend/cmake/CheckStrerrorR.cmake

@@ -14,6 +14,13 @@ version.
 
   Whether `strerror_r()` returns a `char *` message, otherwise it returns an
   `int` error number.
+
+## Usage
+
+```cmake
+# CMakeLists.txt
+include(cmake/CheckStrerrorR.cmake)
+```
 #]=============================================================================]
 
 include_guard(GLOBAL)

cmake/Zend/cmake/Fibers.cmake

@@ -24,6 +24,13 @@ platform, otherwise it checks if ucontext can be used.
 
   Interface library using Boost fiber assembly files and compile options if
   available.
+
+## Usage
+
+```cmake
+# CMakeLists.txt
+include(cmake/Fibers.cmake)
+```
 #]=============================================================================]
 
 include_guard(GLOBAL)

cmake/Zend/cmake/MaxExecutionTimers.cmake

@@ -26,6 +26,13 @@ Check whether to enable Zend max execution timers.
 
   Includes possible additional library to be linked for using `timer_create()`
   and a compile definition.
+
+## Usage
+
+```cmake
+# CMakeLists.txt
+include(cmake/MaxExecutionTimers.cmake)
+```
 #]=============================================================================]
 
 include_guard(GLOBAL)

cmake/cmake/modules/FindACL.cmake

@@ -26,6 +26,13 @@ Module defines the following `IMPORTED` target(s):
 * Set `ACL_USE_USER_GROUP` to `TRUE` before calling `find_package(ACL)` to also
   check if the ACL library supports `ACL_USER` and `ACL_GROUP`. For example,
   macOS doesn't have support for user/group.
+
+## Usage
+
+```cmake
+# CMakeLists.txt
+find_package(ACL)
+```
 #]=============================================================================]
 
 include(CheckSourceCompiles)

cmake/cmake/modules/FindApache.cmake

@@ -36,6 +36,13 @@ Module defines the following `IMPORTED` target(s):
 * `Apache_INCLUDE_DIR` - Directory containing package library headers.
 * `Apache_APR_INCLUDE_DIR` - Directory containing `apr` library headers.
 * `Apache_APR_LIBRARY` - The path to the `apr` library.
+
+## Usage
+
+```cmake
+# CMakeLists.txt
+find_package(Apache)
+```
 #]=============================================================================]
 
 include(FeatureSummary)

cmake/cmake/modules/FindAppArmor.cmake

@@ -18,6 +18,13 @@ Module defines the following `IMPORTED` target(s):
 
 * `AppArmor_INCLUDE_DIR` - Directory containing package library headers.
 * `AppArmor_LIBRARY` - The path to the package library.
+
+## Usage
+
+```cmake
+# CMakeLists.txt
+find_package(AppArmor)
+```
 #]=============================================================================]
 
 include(CheckLibraryExists)

cmake/cmake/modules/FindArgon2.cmake

@@ -18,6 +18,13 @@ Module defines the following `IMPORTED` target(s):
 
 * `Argon2_INCLUDE_DIR` - Directory containing package library headers.
 * `Argon2_LIBRARY` - The path to the package library.
+
+## Usage
+
+```cmake
+# CMakeLists.txt
+find_package(Argon2)
+```
 #]=============================================================================]
 
 include(FeatureSummary)

cmake/cmake/modules/FindAtomic.cmake

@@ -12,6 +12,13 @@ Module defines the following `IMPORTED` target(s):
 * `Atomic_FOUND` - Whether atomic instructions are available.
 * `Atomic_LIBRARIES` - A list of libraries needed in order to use atomic
   functionality.
+
+## Usage
+
+```cmake
+# CMakeLists.txt
+find_package(Atomic)
+```
 #]=============================================================================]
 
 include(CheckSourceCompiles)

cmake/cmake/modules/FindBISON.cmake

@@ -5,6 +5,13 @@ Find `bison`, the general-purpose parser generator, command-line executable.
 
 This module extends the CMake `FindBISON` module.
 See: https://cmake.org/cmake/help/latest/module/FindBISON.html
+
+## Usage
+
+```cmake
+# CMakeLists.txt
+find_package(BISON)
+```
 #]=============================================================================]
 
 include(FeatureSummary)

cmake/cmake/modules/FindBerkeleyDB.cmake

@@ -25,6 +25,13 @@ Module defines the following `IMPORTED` target(s):
 
 * Set `BerkeleyDB_USE_DB1` to `TRUE` before calling `find_package(BerkeleyDB)`
   to enable the Berkeley DB 1.x support/emulation.
+
+## Usage
+
+```cmake
+# CMakeLists.txt
+find_package(BerkeleyDB)
+```
 #]=============================================================================]
 
 include(CheckSourceCompiles)

cmake/cmake/modules/FindCapstone.cmake

@@ -18,6 +18,13 @@ Module defines the following `IMPORTED` target(s):
 
 * `Capstone_INCLUDE_DIR` - Directory containing package library headers.
 * `Capstone_LIBRARY` - The path to the package library.
+
+## Usage
+
+```cmake
+# CMakeLists.txt
+find_package(Capstone)
+```
 #]=============================================================================]
 
 include(FeatureSummary)

cmake/cmake/modules/FindCcache.cmake

@@ -16,6 +16,13 @@ Find the Ccache compiler cache tool for faster compilation times.
 
 * The `CCACHE_DISABLE` regular or environment variable which disables ccache and
   doesn't adjust the C and CXX launcher. For more info see Ccache documentation.
+
+## Usage
+
+```cmake
+# CMakeLists.txt
+find_package(Ccache)
+```
 #]=============================================================================]
 
 include(FeatureSummary)

cmake/cmake/modules/FindCdb.cmake

@@ -18,6 +18,13 @@ Module defines the following `IMPORTED` target(s):
 
 * `Cdb_INCLUDE_DIR` - Directory containing package library headers.
 * `Cdb_LIBRARY` - The path to the package library.
+
+## Usage
+
+```cmake
+# CMakeLists.txt
+find_package(Cdb)
+```
 #]=============================================================================]
 
 include(CheckLibraryExists)

cmake/cmake/modules/FindCrypt.cmake

@@ -25,6 +25,13 @@ Module defines the following `IMPORTED` target(s):
 * `Crypt_IS_BUILT_IN` - Whether crypt is a part of the C library.
 * `Crypt_INCLUDE_DIR` - Directory containing package library headers.
 * `Crypt_LIBRARY` - The path to the package library.
+
+## Usage
+
+```cmake
+# CMakeLists.txt
+find_package(Crypt)
+```
 #]=============================================================================]
 
 include(CheckSymbolExists)

cmake/cmake/modules/FindDTrace.cmake

@@ -50,7 +50,7 @@ Generates DTrace header `<header>` and creates `INTERFACE` library
   interpreted as being relative to the current source directory.
 * `INCLUDES` - A list of include directories for appending to DTrace object.
 
-## Basic usage
+## Usage
 
 ```cmake
 # CMakeLists.txt

cmake/cmake/modules/FindDbm.cmake

@@ -30,6 +30,13 @@ Module defines the following `IMPORTED` target(s):
 
 * `Dbm_INCLUDE_DIR` - Directory containing package library headers.
 * `Dbm_LIBRARY` - The path to the package library.
+
+## Usage
+
+```cmake
+# CMakeLists.txt
+find_package(Dbm)
+```
 #]=============================================================================]
 
 include(CheckLibraryExists)

cmake/cmake/modules/FindDmalloc.cmake

@@ -18,6 +18,13 @@ Module defines the following `IMPORTED` target(s):
 
 * `Dmalloc_INCLUDE_DIR` - Directory containing package library headers.
 * `Dmalloc_LIBRARY` - The path to the package library.
+
+## Usage
+
+```cmake
+# CMakeLists.txt
+find_package(Dmalloc)
+```
 #]=============================================================================]
 
 include(FeatureSummary)

cmake/cmake/modules/FindEditline.cmake

@@ -18,6 +18,13 @@ Module defines the following `IMPORTED` target(s):
 
 * `Editline_INCLUDE_DIR` - Directory containing package library headers.
 * `Editline_LIBRARY` - The path to the package library.
+
+## Usage
+
+```cmake
+# CMakeLists.txt
+find_package(Editline)
+```
 #]=============================================================================]
 
 include(CheckLibraryExists)

cmake/cmake/modules/FindEnchant.cmake

@@ -21,6 +21,13 @@ Module defines the following `IMPORTED` target(s):
 
 * `Enchant_INCLUDE_DIR` - Directory containing package library headers.
 * `Enchant_LIBRARY` - The path to the package library.
+
+## Usage
+
+```cmake
+# CMakeLists.txt
+find_package(Enchant)
+```
 #]=============================================================================]
 
 include(FeatureSummary)

cmake/cmake/modules/FindFFI.cmake

@@ -18,6 +18,13 @@ Module defines the following `IMPORTED` target(s):
 
 * `FFI_INCLUDE_DIR` - Directory containing package library headers.
 * `FFI_LIBRARY` - The path to the package library.
+
+## Usage
+
+```cmake
+# CMakeLists.txt
+find_package(FFI)
+```
 #]=============================================================================]
 
 include(FeatureSummary)

cmake/cmake/modules/FindFirebird.cmake

@@ -22,6 +22,13 @@ Module defines the following `IMPORTED` target(s):
 * `Firebird_LIBRARY` - The path to the package library.
 * `Firebird_CONFIG_EXECUTABLE` - Path to the fb_config Firebird command-line
   utility.
+
+## Usage
+
+```cmake
+# CMakeLists.txt
+find_package(Firebird)
+```
 #]=============================================================================]
 
 include(FeatureSummary)

cmake/cmake/modules/FindFreeTDS.cmake

@@ -17,6 +17,13 @@ Module defines the following `IMPORTED` target(s):
 
 * `FreeTDS_INCLUDE_DIR` - Directory containing package library headers.
 * `FreeTDS_LIBRARY` - The path to the package library.
+
+## Usage
+
+```cmake
+# CMakeLists.txt
+find_package(FreeTDS)
+```
 #]=============================================================================]
 
 include(CheckLibraryExists)

cmake/cmake/modules/FindGD.cmake

@@ -18,6 +18,13 @@ Module defines the following `IMPORTED` target(s):
 
 * `GD_INCLUDE_DIR` - Directory containing package library headers.
 * `GD_LIBRARY` - The path to the package library.
+
+## Usage
+
+```cmake
+# CMakeLists.txt
+find_package(GD)
+```
 #]=============================================================================]
 
 include(FeatureSummary)

cmake/cmake/modules/FindGMP.cmake

@@ -18,6 +18,13 @@ Module defines the following `IMPORTED` target(s):
 
 * `GMP_INCLUDE_DIR` - Directory containing package library headers.
 * `GMP_LIBRARY` - The path to the package library.
+
+## Usage
+
+```cmake
+# CMakeLists.txt
+find_package(GMP)
+```
 #]=============================================================================]
 
 include(FeatureSummary)