Merge branch 'PHP-8.4'

Author: petk

cmake/cmake/modules/FindACL.cmake

@@ -1,9 +1,15 @@
 #[=============================================================================[
 # FindACL
 
-Find the ACL library.
+Finds the ACL library:
 
-Module defines the following `IMPORTED` target(s):
+```cmake
+find_package(ACL)
+```
+
+## Imported targets
+
+This module defines the following imported targets:
 
 * `ACL::ACL` - The package library, if found.
 
@@ -27,11 +33,14 @@ Module defines the following `IMPORTED` target(s):
   check if the ACL library supports `ACL_USER` and `ACL_GROUP`. For example,
   macOS doesn't have support for user/group.
 
-## Usage
+## Examples
+
+Basic usage:
 
 ```cmake
 # CMakeLists.txt
 find_package(ACL)
+target_link_libraries(example PRIVATE ACL::ACL)
 ```
 #]=============================================================================]
 

cmake/cmake/modules/FindApache.cmake

@@ -1,13 +1,19 @@
 #[=============================================================================[
 # FindApache
 
-Find the Apache packages and tools.
+Finds the Apache packages and tools:
+
+```cmake
+find_package(Apache)
+```
 
 The Apache development package usually contains Apache header files, the `apr`
 (Apache Portable Runtime) library and its headers, `apr` config command-line
 tool, and the `apxs` command-line tool.
 
-Module defines the following `IMPORTED` target(s):
+## Imported targets
+
+This module defines the following imported targets:
 
 * `Apache::Apache` - The package library, if found.
 
@@ -37,11 +43,14 @@ Module defines the following `IMPORTED` target(s):
 * `Apache_APR_INCLUDE_DIR` - Directory containing `apr` library headers.
 * `Apache_APR_LIBRARY` - The path to the `apr` library.
 
-## Usage
+## Examples
+
+Basic usage:
 
 ```cmake
 # CMakeLists.txt
 find_package(Apache)
+target_link_libraries(example PRIVATE Apache::Apache)
 ```
 #]=============================================================================]
 

cmake/cmake/modules/FindAppArmor.cmake

@@ -1,9 +1,15 @@
 #[=============================================================================[
 # FindAppArmor
 
-Find the AppArmor library.
+Finds the AppArmor library:
 
-Module defines the following `IMPORTED` target(s):
+```cmake
+find_package(AppArmor)
+```
+
+## Imported targets
+
+This module defines the following imported targets:
 
 * `AppArmor::AppArmor` - The package library, if found.
 
@@ -19,11 +25,14 @@ Module defines the following `IMPORTED` target(s):
 * `AppArmor_INCLUDE_DIR` - Directory containing package library headers.
 * `AppArmor_LIBRARY` - The path to the package library.
 
-## Usage
+## Examples
+
+Basic usage:
 
 ```cmake
 # CMakeLists.txt
 find_package(AppArmor)
+target_link_libraries(example PRIVATE AppArmor::AppArmor)
 ```
 #]=============================================================================]
 

cmake/cmake/modules/FindArgon2.cmake

@@ -1,9 +1,15 @@
 #[=============================================================================[
 # FindArgon2
 
-Find the Argon2 library.
+Finds the Argon2 library:
 
-Module defines the following `IMPORTED` target(s):
+```cmake
+find_package(Argon2)
+```
+
+## Imported targets
+
+This module defines the following imported targets:
 
 * `Argon2::Argon2` - The package library, if found.
 
@@ -19,11 +25,14 @@ Module defines the following `IMPORTED` target(s):
 * `Argon2_INCLUDE_DIR` - Directory containing package library headers.
 * `Argon2_LIBRARY` - The path to the package library.
 
-## Usage
+## Examples
+
+Basic usage:
 
 ```cmake
 # CMakeLists.txt
 find_package(Argon2)
+target_link_libraries(example PRIVATE Argon2::Argon2)
 ```
 #]=============================================================================]
 

cmake/cmake/modules/FindAtomic.cmake

@@ -1,9 +1,15 @@
 #[=============================================================================[
 # FindAtomic
 
-Find the atomic instructions.
+Finds the atomic instructions:
 
-Module defines the following `IMPORTED` target(s):
+```cmake
+find_package(Atomic)
+```
+
+## Imported targets
+
+This module defines the following imported targets:
 
 * `Atomic::Atomic` - The Atomic library, if found.
 
@@ -13,11 +19,14 @@ Module defines the following `IMPORTED` target(s):
 * `Atomic_LIBRARIES` - A list of libraries needed in order to use atomic
   functionality.
 
-## Usage
+## Examples
+
+Basic usage:
 
 ```cmake
 # CMakeLists.txt
 find_package(Atomic)
+target_link_libraries(example PRIVATE Atomic::Atomic)
 ```
 #]=============================================================================]
 

cmake/cmake/modules/FindBISON.cmake

@@ -1,17 +1,10 @@
 #[=============================================================================[
 # FindBISON
 
-Find `bison`, the general-purpose parser generator, command-line executable.
+This module extends the upstream CMake `FindBISON` module with few
+customizations.
 
-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

@@ -1,9 +1,15 @@
 #[=============================================================================[
 # FindBerkeleyDB
 
-Find the Berkeley DB library.
+Finds the Berkeley DB library:
 
-Module defines the following `IMPORTED` target(s):
+```cmake
+find_package(BerkeleyDB)
+```
+
+## Imported targets
+
+This module defines the following imported targets:
 
 * `BerkeleyDB::BerkeleyDB` - The package library, if found.
 
@@ -26,11 +32,14 @@ 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
+## Examples
+
+Basic usage:
 
 ```cmake
 # CMakeLists.txt
 find_package(BerkeleyDB)
+target_link_libraries(example PRIVATE BerkeleyDB::BerkeleyDB)
 ```
 #]=============================================================================]
 

cmake/cmake/modules/FindCapstone.cmake

@@ -1,9 +1,15 @@
 #[=============================================================================[
 # FindCapstone
 
-Find the Capstone library.
+Finds the Capstone library:
 
-Module defines the following `IMPORTED` target(s):
+```cmake
+find_package(Capstone)
+```
+
+## Imported targets
+
+This module defines the following imported targets:
 
 * `Capstone::Capstone` - The package library, if found.
 
@@ -19,11 +25,14 @@ Module defines the following `IMPORTED` target(s):
 * `Capstone_INCLUDE_DIR` - Directory containing package library headers.
 * `Capstone_LIBRARY` - The path to the package library.
 
-## Usage
+## Examples
+
+Basic usage:
 
 ```cmake
 # CMakeLists.txt
 find_package(Capstone)
+target_link_libraries(example PRIVATE Capstone::Capstone)
 ```
 #]=============================================================================]
 

cmake/cmake/modules/FindCcache.cmake

@@ -1,7 +1,11 @@
 #[=============================================================================[
 # FindCcache
 
-Find the Ccache compiler cache tool for faster compilation times.
+Finds the Ccache compiler cache tool for faster compilation times:
+
+```cmake
+find_package(Ccache)
+```
 
 ## Result variables
 
@@ -17,7 +21,9 @@ 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
+## Examples
+
+Basic usage:
 
 ```cmake
 # CMakeLists.txt

cmake/cmake/modules/FindCdb.cmake

@@ -1,9 +1,15 @@
 #[=============================================================================[
 # FindCdb
 
-Find the cdb library.
+Finds the cdb library:
 
-Module defines the following `IMPORTED` target(s):
+```cmake
+find_package(Cdb)
+```
+
+## Imported targets
+
+This module defines the following imported targets:
 
 * `Cdb::Cdb` - The package library, if found.
 
@@ -19,11 +25,14 @@ Module defines the following `IMPORTED` target(s):
 * `Cdb_INCLUDE_DIR` - Directory containing package library headers.
 * `Cdb_LIBRARY` - The path to the package library.
 
-## Usage
+## Examples
+
+Basic usage:
 
 ```cmake
 # CMakeLists.txt
 find_package(Cdb)
+target_link_libraries(example PRIVATE Cdb::Cdb)
 ```
 #]=============================================================================]