#25 sync [textui.rst] with sebastianbergmann/phpunit-documentation-english@6e99123

Author: tarohida

src/textui.rst

@@ -10,7 +10,7 @@
 のコマンドライン版テストランナーが起動します。
 コマンドラインのテストランナーを使用したテストの様子を以下に示します。
 
-.. code-block:: bash
+.. parsed-literal::
 
     $ phpunit ArrayTest
     PHPUnit |version|.0 by Sebastian Bergmann and contributors.
@@ -74,66 +74,64 @@ PHPUnit は、*失敗 (failures)* と
 
 以下のコードで、コマンドライン版テストランナーのオプションの一覧を見てみましょう。
 
-.. code-block:: bash
+.. parsed-literal::
 
     $ phpunit --help
     PHPUnit |version|.0 by Sebastian Bergmann and contributors.
 
-    Usage: phpunit [options] UnitTest [UnitTest.php]
-           phpunit [options] <directory>
+    Usage:
+      phpunit [options] UnitTest.php
+      phpunit [options] <directory>
 
     Code Coverage Options:
-
       --coverage-clover <file>    Generate code coverage report in Clover XML format
       --coverage-crap4j <file>    Generate code coverage report in Crap4J XML format
       --coverage-html <dir>       Generate code coverage report in HTML format
       --coverage-php <file>       Export PHP_CodeCoverage object to file
-      --coverage-text=<file>      Generate code coverage report in text format
-                                  Default: Standard output
+      --coverage-text=<file>      Generate code coverage report in text format [default: standard output]
       --coverage-xml <dir>        Generate code coverage report in PHPUnit XML format
-      --whitelist <dir>           Whitelist <dir> for code coverage analysis
+      --coverage-cache <dir>      Cache static analysis results
+      --warm-coverage-cache       Warm static analysis cache
+      --coverage-filter <dir>     Include <dir> in code coverage analysis
+      --path-coverage             Perform path coverage analysis
       --disable-coverage-ignore   Disable annotations for ignoring code coverage
       --no-coverage               Ignore code coverage configuration
-      --dump-xdebug-filter <file> Generate script to set Xdebug code coverage filter
 
     Logging Options:
-
       --log-junit <file>          Log test execution in JUnit XML format to file
       --log-teamcity <file>       Log test execution in TeamCity format to file
       --testdox-html <file>       Write agile documentation in HTML format to file
       --testdox-text <file>       Write agile documentation in Text format to file
       --testdox-xml <file>        Write agile documentation in XML format to file
       --reverse-list              Print defects in reverse order
+      --no-logging                Ignore logging configuration
 
     Test Selection Options:
-
       --filter <pattern>          Filter which tests to run
-      --testsuite <name,...>      Filter which testsuite to run
-      --group ...                 Only runs tests from the specified group(s)
-      --exclude-group ...         Exclude tests from the specified group(s)
+      --testsuite <name>          Filter which testsuite to run
+      --group <name>              Only runs tests from the specified group(s)
+      --exclude-group <name>      Exclude tests from the specified group(s)
       --list-groups               List available test groups
       --list-suites               List available test suites
       --list-tests                List available tests
       --list-tests-xml <file>     List available tests in XML format
-      --test-suffix ...           Only search for test in files with specified
-                                  suffix(es). Default: Test.php,.phpt
+      --test-suffix <suffixes>    Only search for test in files with specified suffix(es). Default: Test.php,.phpt
 
     Test Execution Options:
-
       --dont-report-useless-tests Do not report tests that do not test anything
       --strict-coverage           Be strict about @covers annotation usage
       --strict-global-state       Be strict about changes to global state
       --disallow-test-output      Be strict about output during tests
       --disallow-resource-usage   Be strict about resource usage during small tests
       --enforce-time-limit        Enforce time limit based on test size
-      --default-time-limit=<sec>  Timeout in seconds for tests without @small, @medium or @large
+      --default-time-limit <sec>  Timeout in seconds for tests without @small, @medium or @large
       --disallow-todo-tests       Disallow @todo-annotated tests
 
       --process-isolation         Run each test in a separate PHP process
       --globals-backup            Backup and restore $GLOBALS for each test
       --static-backup             Backup and restore static attributes for each test
 
-      --colors=<flag>             Use colors in output ("never", "auto" or "always")
+      --colors <flag>             Use colors in output ("never", "auto" or "always")
       --columns <n>               Number of columns to use for progress output
       --columns max               Use maximum number of columns for progress output
       --stderr                    Write to STDERR instead of STDOUT
@@ -144,39 +142,40 @@ PHPUnit は、*失敗 (failures)* と
       --stop-on-risky             Stop execution upon first risky test
       --stop-on-skipped           Stop execution upon first skipped test
       --stop-on-incomplete        Stop execution upon first incomplete test
-      --fail-on-warning           Treat tests with warnings as failures
+      --fail-on-incomplete        Treat incomplete tests as failures
       --fail-on-risky             Treat risky tests as failures
+      --fail-on-skipped           Treat skipped tests as failures
+      --fail-on-warning           Treat tests with warnings as failures
       -v|--verbose                Output more verbose information
       --debug                     Display debugging information
 
-      --loader <loader>           TestSuiteLoader implementation to use
       --repeat <times>            Runs the test(s) repeatedly
       --teamcity                  Report test execution progress in TeamCity format
       --testdox                   Report test execution progress in TestDox format
       --testdox-group             Only include tests from the specified group(s)
       --testdox-exclude-group     Exclude tests from the specified group(s)
+      --no-interaction            Disable TestDox progress animation
       --printer <printer>         TestListener implementation to use
 
-      --resolve-dependencies      Resolve dependencies between tests
-      --order-by=<order>          Run tests in order: default|reverse|random|defects|depends
-      --random-order-seed=<N>     Use a specific random seed <N> for random order
-      --cache-result              Write run result to cache to enable ordering tests defects-first
+      --order-by <order>          Run tests in order: default|defects|duration|no-depends|random|reverse|size
+      --random-order-seed <N>     Use a specific random seed <N> for random order
+      --cache-result              Write test results to cache file
+      --do-not-cache-result       Do not write test results to cache file
 
     Configuration Options:
-
       --prepend <file>            A PHP script that is included as early as possible
       --bootstrap <file>          A PHP script that is included before the tests run
       -c|--configuration <file>   Read configuration from XML file
       --no-configuration          Ignore default configuration file (phpunit.xml)
-      --no-logging                Ignore logging configuration
+      --extensions <extensions>   A comma separated list of PHPUnit extensions to load
       --no-extensions             Do not load PHPUnit extensions
       --include-path <path(s)>    Prepend PHP's include_path with given path(s)
-      -d key[=value]              Sets a php.ini value
+      -d <key[=value]>            Sets a php.ini value
+      --cache-result-file <file>  Specify result cache path and filename
       --generate-configuration    Generate configuration file with suggested settings
-      --cache-result-file==<FILE> Specify result cache path and filename
+      --migrate-configuration     Migrate configuration file to current format
 
     Miscellaneous Options:
-
       -h|--help                   Prints this usage information
       --version                   Prints the version and exits
       --atleast-version <min>     Checks that version is greater than min and exits
@@ -202,49 +201,32 @@ PHPUnit は、*失敗 (failures)* と
 ``--coverage-clover``
 
     テスト結果から XML 形式のログファイルを作成し、
-    コードカバレッジ情報もそこに含めます。
-    詳細は :ref:`logging` を参照ください。
-
-    この機能は、tokenizer 拡張モジュールおよび Xdebug
-    拡張モジュールがインストールされている場合にのみ使用可能となることに注意しましょう。
+    コードカバレッジ情報もそこに含めます。詳細は
+    :ref:`code-coverage-analysis` を参照ください。
 
 ``--coverage-crap4j``
 
     コードカバレッジレポートを Crap4j 形式で作成します。詳細は
     :ref:`code-coverage-analysis` を参照ください。
 
-    この機能は、tokenizer 拡張モジュールおよび Xdebug
-    拡張モジュールがインストールされている場合にのみ使用可能となることに注意しましょう。
-
 ``--coverage-html``
 
     コードカバレッジレポートを HTML 形式で作成します。詳細は
     :ref:`code-coverage-analysis` を参照ください。
 
-    この機能は、tokenizer 拡張モジュールおよび Xdebug
-    拡張モジュールがインストールされている場合にのみ使用可能となることに注意しましょう。
-
 ``--coverage-php``
 
     シリアライズした PHP_CodeCoverage オブジェクトを生成し、
     コードカバレッジ情報もそこに含めます。
 
-    この機能は、tokenizer 拡張モジュールおよび Xdebug
-    拡張モジュールがインストールされている場合にのみ使用可能となることに注意しましょう。
-
 ``--coverage-text``
 
     テストを実行したときに、ログファイルあるいはコマンドライン出力で
     可読形式のコードカバレッジ情報を生成します。
-    詳細は :ref:`logging` を参照ください。
-
-    この機能は、tokenizer 拡張モジュールおよび Xdebug
-    拡張モジュールがインストールされている場合にのみ使用可能となることに注意しましょう。
 
 ``--log-junit``
 
     JUnit XML フォーマットを使用して、テストの実行結果のログを作成します。
-    詳細は :ref:`logging` を参照ください。
 
 ``--testdox-html`` および ``--testdox-text``
 
@@ -281,10 +263,10 @@ PHPUnit は、*失敗 (failures)* と
             :name: textui.examples.TestCaseClass.php
 
             <?php
-            use PHPUnit\Framework\TestCase;
-
             namespace TestNamespace;
 
+            use PHPUnit\Framework\TestCase;
+
             class TestCaseClass extends TestCase
             {
                 /**
@@ -508,7 +490,7 @@ PHPUnit は、*失敗 (failures)* と
     :file:`phpunit.xml` あるいは
     :file:`phpunit.xml.dist` (この順番で使用します)
     が現在の作業ディレクトリに存在しており、かつ ``--configuration``
-    が使われて*いない*場合、設定が自動的にそのファイルから読み込まれます。
+    が使われて *いない* 場合、設定が自動的にそのファイルから読み込まれます。
 
     指定されているのがディレクトリで、
     :file:`phpunit.xml` あるいは
@@ -530,7 +512,9 @@ PHPUnit は、*失敗 (failures)* と
 
 .. admonition:: Note
 
-   PHPUnit 4.8 以降では、これらのオプションを引数の後にも指定できるようになりました。
+   これらのオプションは、引数の後に指定することもできます。
+
+.. _textui.testdox:
 
 TestDox
 #######
@@ -546,9 +530,9 @@ PHPUnit の TestDox 機能は、テストクラス内のすべてのテストメ
 
 ``BankAccount`` クラスのアジャイルな文書を見てみましょう。
 
-.. code-block:: bash
+.. parsed-literal::
 
-    $ phpunit --testdox BankAccountTest
+    $ phpunit --testdox BankAccountTest.php
     PHPUnit |version|.0 by Sebastian Bergmann and contributors.
 
     BankAccount