Update docs

Author: petk

bin/make-docs.php

@@ -1,6 +1,8 @@
 #!/usr/bin/env php
 <?php
 
+declare(strict_types=1);
+
 /**
  * Generate documentation from the CMake project specific modules where needed.
  *
@@ -25,7 +27,7 @@ function generateModuleDocs(
 
         $content = '';
         $content .= "# $namespace" . "$moduleName\n\n";
-        if ($url === '') {
+        if ('' === $url) {
             $url = 'https://github.com/petk/php-build-system/tree/master/cmake/cmake/modules/' . $namespace . $moduleName . '.cmake';
         }
         $content .= "See: [$moduleName.cmake]($url)\n\n";
@@ -38,7 +40,7 @@ function generateModuleDocs(
 
         file_put_contents(
             $destination . '/' . $namespace . $moduleName . '.md',
-            $content
+            $content,
         );
     }
 }
@@ -60,10 +62,10 @@ function generateModuleDocs(
 
 foreach ($files as $file) {
     $relativeFilename = trim(str_replace($modulesDirectory, '', $file), '/');
-    echo "Processing " . $relativeFilename . "\n";
+    echo 'Processing ' . $relativeFilename . "\n";
 
     $namespace = trim(str_replace($modulesDirectory, '', dirname($file)), '/');
-    $namespace = ($namespace == '') ? '' : $namespace . '/';
+    $namespace = ('' == $namespace) ? '' : $namespace . '/';
 
     generateModuleDocs($file, $namespace, $docs);
 }

docs/cmake-code-style.md

@@ -33,11 +33,12 @@ ecosystem.
   * [9.1. Determining processor](#91-determining-processor)
 * [10. See also](#10-see-also)
   * [10.1. Tools](#101-tools)
-    * [10.1.1. cmake-format (by cmakelang project)](#1011-cmake-format-by-cmakelang-project)
-    * [10.1.2. cmake-lint (by cmakelang project)](#1012-cmake-lint-by-cmakelang-project)
-    * [10.1.3. cmakelint](#1013-cmakelint)
-    * [10.1.4. bin/check-cmake.sh](#1014-bincheck-cmakesh)
-    * [10.1.5. cmake-format.json](#1015-cmake-formatjson)
+    * [10.1.1. Gersemi](#1011-gersemi)
+    * [10.1.2. cmake-format (by cmakelang project)](#1012-cmake-format-by-cmakelang-project)
+    * [10.1.3. cmake-lint (by cmakelang project)](#1013-cmake-lint-by-cmakelang-project)
+    * [10.1.4. cmakelint](#1014-cmakelint)
+    * [10.1.5. bin/check-cmake.php](#1015-bincheck-cmakephp)
+    * [10.1.6. cmake-format.json](#1016-cmake-formatjson)
   * [10.2. Further resources](#102-further-resources)
 
 ## 1. Introduction
@@ -607,7 +608,16 @@ levels of maturity and a lack of updates to keep pace with new CMake versions.
 It's worth mentioning that this recommendation may evolve in the future as these
 tools continue to develop and adapt.
 
-#### 10.1.1. cmake-format (by cmakelang project)
+#### 10.1.1. Gersemi
+
+The [`gersemi`](https://github.com/BlankSpruce/gersemi) tool can check and fix
+CMake code style:
+
+```sh
+gersemi --check --indent 2 --diff --definitions cmake -- cmake
+```
+
+#### 10.1.2. cmake-format (by cmakelang project)
 
 The [`cmake-format`](https://cmake-format.readthedocs.io/en/latest/) tool can
 find formatting issues and sync the CMake code style:
@@ -636,7 +646,7 @@ dumping the formatted content to stdout:
 cmake-format -i path/to/cmake/file
 ```
 
-#### 10.1.2. cmake-lint (by cmakelang project)
+#### 10.1.3. cmake-lint (by cmakelang project)
 
 The [`cmake-lint`](https://cmake-format.readthedocs.io/en/latest/cmake-lint.html)
 tool is part of the cmakelang project and can help with linting CMake files:
@@ -648,7 +658,7 @@ cmake-lint <cmake/CMakeLists.txt cmake/...>
 This tool can also utilize the `cmake-format.[json|py|yaml]` file using the `-c`
 option.
 
-#### 10.1.3. cmakelint
+#### 10.1.4. cmakelint
 
 For linting there is also a separate and useful
 [cmakelint](https://github.com/cmake-lint/cmake-lint) tool which similarly lints
@@ -658,22 +668,22 @@ and helps to better structure CMake files:
 cmakelint <cmake/CMakeLists.txt cmake/...>
 ```
 
-#### 10.1.4. bin/check-cmake.sh
+#### 10.1.5. bin/check-cmake.php
 
 For convenience there is a custom helper script added to this repository that
 checks CMake files:
 
 ```sh
-./bin/check-cmake.sh
+./bin/check-cmake.php cmake
 ```
 
-#### 10.1.5. cmake-format.json
+#### 10.1.6. cmake-format.json
 
 The `cmake-format.json` file is used to configure how `cmake-lint` and
 `cmake-format` tools work.
 
 There is `bin/cmake-format.json` added to this repository and is used by the
-custom `bin/check-cmake.sh` script. It includes only changed configuration
+custom `bin/check-cmake.php` script. It includes only changed configuration
 values from the upstream defaults.
 
 * `disabled_codes`

docs/cmake-modules/PHP/AddCustomCommand.md

@@ -34,8 +34,9 @@ php_add_custom_command(
 ```
 
 It acts similar to `add_custom_command()` and `add_custom_target()`, except that
-the DEPENDS argument doesn't add dependencies among targets but instead checks
-their timestamps manually and executes the PHP_COMMAND only when needed.
+when PHP is not found on the system, the DEPENDS argument doesn't add
+dependencies among targets but instead checks their timestamps manually and
+executes the PHP_COMMAND only when needed.
 
 ```cmake
 php_add_custom_command(

docs/cmake-modules/PHP/Rebuild.md

@@ -0,0 +1,10 @@
+# PHP/Rebuild
+
+See: [Rebuild.cmake](https://github.com/petk/php-build-system/tree/master/cmake/cmake/modules/PHP/Rebuild.cmake)
+
+Rebuild all project targets.
+
+When PHP is not found on the system, PHP generates some files during development
+using the php_cli target itself, which can bring cyclic dependencies among
+targets if custom commands would depend on the php_cli target. Although not a
+good practice, this helps bringing all targets to updated state.