Merge branch 'PHP-8.4'

Author: petk

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>...]
 

bin/make-docs.php

@@ -62,29 +62,12 @@ function generateModuleDocs(
     $markdown .= "* Source code: [$relativeFilename]($url)\n\n";
     $markdown .= $content . "\n";
 
-    if ($namespace) {
-        $footer = <<<EOT
-            ## Basic usage
-
-            ```cmake
-            # CMakeLists.txt
-            include({$namespace}{$moduleName})
-            ```
-            EOT;
-    } elseif (1 === preg_match('/^Find(.+)$/', $moduleName, $matches)) {
+    if (1 === preg_match('/^Find(.+)$/', $moduleName, $matches)) {
         $findPackageName = $matches[1] ?? null;
         $findPackageUpper = strtoupper($findPackageName);
 
-        $footer = <<<EOT
-            ## Basic usage
+        $markdown .= <<<EOT
 
-            ```cmake
-            # CMakeLists.txt
-            find_package($findPackageName)
-            ```
-            EOT;
-
-        $footer_2 = <<<EOT
             ## Customizing search locations
 
             To customize where to look for the $findPackageName package base
@@ -102,26 +85,10 @@ function generateModuleDocs(
                   -D{$findPackageUpper}_ROOT=/opt/$findPackageName \
                   -DSOMEOTHERPACKAGE_ROOT=/opt/some-other-package
             ```
-            EOT;
-    } else {
-        $footer = <<<EOT
-            ## Basic usage
 
-            ```cmake
-            # CMakeLists.txt
-            include(cmake/$moduleName.cmake)
-            ```
             EOT;
     }
 
-    if (1 !== preg_match('/## Basic usage[\r\n]/', $content, $matches)) {
-        $markdown .= "\n" . $footer . "\n";
-    }
-
-    if (isset($footer_2)) {
-        $markdown .= "\n" . $footer_2 . "\n";
-    }
-
     if (!file_exists($destination)) {
         mkdir($destination, 0777, true);
     }

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)