diff --git a/features/commandline.xml b/features/commandline.xml
index 1c5b3707af8d..01613bf4898e 100644
--- a/features/commandline.xml
+++ b/features/commandline.xml
@@ -533,19 +533,28 @@ string(15) "doesntmakesense"
--syntax-check
- Provides a convenient way to perform only a syntax check
- on the given PHP code. On success, the text
+ Syntax check but do not execute the given PHP code.
+ The input from standard input will be processed if no filenames are specified,
+ otherwise each filename will be checked.
+ On success, the text
No syntax errors detected in <filename> is
- written to standard output and the shell return code is
- 0. On failure, the text Errors parsing
- <filename> in addition to the internal parser error
- message is written to standard output and the shell return code is set
- to -1.
+ written to standard output.
+ On failure, the text Errors parsing <filename>
+ is written to standard output in addition to the internal parser error.
+ If any failures are found in the specified files (or standard input),
+ the shell return code is set to -1, otherwise the
+ shell return code is set to 0.
- This option won't find fatal errors (like undefined functions). Use
- the to test for fatal errors too.
+ This option won't find fatal errors (like undefined functions) that
+ require executing the code.
+
+
+ Prior to PHP 8.3.0, it was only possible to specify one filename to
+ be checked.
+
+
This option does not work together with the