Update docs

Author: petk

docs/cmake-modules/FindRE2C.md

@@ -65,7 +65,7 @@ re2c_target(
 * `<input>` - The re2c template file input. Relative source file path is
   interpreted as being relative to the current source directory.
 * `<output>` - The output file. Relative output file path is interpreted as
-  being relative to the current source directory.
+  being relative to the current binary directory.
 * `HEADER` - Generate a <header> file. Relative header file path is interpreted
   as being relative to the current binary directory.
 * `OPTIONS` - List of additional options to pass to re2c command-line tool.

docs/cmake-modules/PHP/ConfigureFile.md

@@ -21,10 +21,15 @@ php_configure_file(
 )
 ```
 
-* `VARIABLES`
+* `INPUT` or `CONTENT` specify the input template (either a file or a content
+  string). Relative <template-file> is interpreted as being relative to the
+  current source directory.
 
-  Pairs of variable names and values. Variable values support generator
-  expressions.
+* `OUTPUT` specifies the output file. Relative file path is interpreted as being
+  relative to the current binary directory.
+
+* `VARIABLES` represent the pairs of variable names and values. Variable values
+  support generator expressions.
 
   The `$<INSTALL_PREFIX>` generator expression can be used in variable values,
   which is replaced with installation prefix either set via the

docs/cmake-modules/PHP/Rebuild.md

@@ -2,9 +2,12 @@
 
 See: [Rebuild.cmake](https://github.com/petk/php-build-system/tree/master/cmake/cmake/modules/PHP/Rebuild.cmake)
 
-Rebuild all project targets.
+Ensure all project targets are rebuilt as needed.
 
-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.
+When PHP is not found on the system, the `php_cli` target is used to generate
+certain files during development. This can lead to cyclic dependencies among
+targets if custom commands depend on the `php_cli` target. While such automatic
+rebuilding is not considered good practice, it ensures that all targets are kept
+up to date.
+
+TODO: This works only for a limited set of cases for now and will be refactored.

docs/cmake-modules/PHP/Stubs.md

@@ -0,0 +1,7 @@
+# PHP/Stubs
+
+See: [Stubs.cmake](https://github.com/petk/php-build-system/tree/master/cmake/cmake/modules/PHP/Stubs.cmake)
+
+Generate *_arginfo.h headers from the *.stub.php sources
+
+The build/gen_stub.php script requires the PHP tokenizer extension.