[PHP 8.3] It is now possible to lint multiple files.

php/doc-en@725cead

Author: mumumu

features/commandline.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: e50e79746736dbdfbabe9bd3566793b3ddf38f58 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 725ceadea94af4f4db6c76b9665829f27068d2c5 Maintainer: takagi Status: ready -->
 <!-- CREDITS: hirokawa,shimooka,mumumu -->
 <chapter xml:id="features.commandline" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>PHP をコマンドラインから使用する</title>
@@ -541,21 +541,30 @@ string(15) "doesntmakesense"
        <entry>--syntax-check</entry>
        <entry>
         <para>
-         このオプションにより、指定した PHP コードの
-         構文チェックのみを簡単に行なうことができます。成功した場合、
+         構文チェックを行いますが、指定された PHP コードは実行しません。
+         ファイル名が指定されない場合、標準出力の入力をチェックしますが、
+         指定された場合、それぞれのファイルがチェックされます。
+         成功した場合、
          テキスト
          <literal>No syntax errors detected in &lt;filename&gt;</literal>
          が標準出力に書き込まれ、リターンコードは <literal>0</literal>
-         となります。失敗した場合、テキスト <literal>Errors parsing
+         になります。失敗した場合は
+         テキスト <literal>Errors parsing
           &lt;filename&gt;</literal> に加え、内部パーサエラーメッセージ
          が標準出力に書き込まれ、シェルリターンコードは、
          <literal>-1</literal> となります。
         </para>
         <para>
          このオプションは、(未定義の関数のような)致命的なエラー(fatal error)
-         はみつけません。致命的なエラーについても調べたい場合は、
-         <option>-f</option> を使用してください。
+         を見つけることはありません。そうするためには、
+         コード全体を実行する必要があるからです。
         </para>
+        <note>
+         <para>
+          PHP 8.3.0 より前のバージョンでは、
+          構文チェックできるファイルの数は一つだけでした。
+         </para>
+        </note>
         <note>
          <para>
           このオプションは、オプション <option>-r</option> と共に使用することは