[SUREFIRE-580] updated documentation
Project: http://git-wip-us.apache.org/repos/asf/maven-surefire/repo Commit: http://git-wip-us.apache.org/repos/asf/maven-surefire/commit/605708ca Tree: http://git-wip-us.apache.org/repos/asf/maven-surefire/tree/605708ca Diff: http://git-wip-us.apache.org/repos/asf/maven-surefire/diff/605708ca Branch: refs/heads/master Commit: 605708cabb584078beac02ff4f941081b37840fd Parents: 3eb6fa7 Author: Tibor17 <tibo...@lycos.com> Authored: Thu Sep 3 16:56:59 2015 +0200 Committer: Tibor17 <tibo...@lycos.com> Committed: Sun Sep 6 22:58:00 2015 +0200 ---------------------------------------------------------------------- .../site/apt/examples/skip-after-failure.apt.vm | 22 +++++++++++++------- 1 file changed, 14 insertions(+), 8 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/maven-surefire/blob/605708ca/maven-surefire-plugin/src/site/apt/examples/skip-after-failure.apt.vm ---------------------------------------------------------------------- diff --git a/maven-surefire-plugin/src/site/apt/examples/skip-after-failure.apt.vm b/maven-surefire-plugin/src/site/apt/examples/skip-after-failure.apt.vm index 9e7af97..0fc1fc0 100644 --- a/maven-surefire-plugin/src/site/apt/examples/skip-after-failure.apt.vm +++ b/maven-surefire-plugin/src/site/apt/examples/skip-after-failure.apt.vm @@ -31,28 +31,34 @@ Skipping Tests After First Failure To skip remaining tests after first failure or error has happened set configuration parameter <<<skipAfterFailureCount>>> to <<<1>>>. - Prerequisite: use ${project.artifactId} 2.19 or higher, JUnit 4.0 - or higher, or TestNG 5.10 or higher. - - Limitations: Although this feature works in forking modes as well, the - functionality cannot be fully guaranteed (real first failure) in concurrent - mode due to race conditions. - If version of TestNG is lover than 5.10 while the parameter <<<skipAfterFailureCount>>> is set, the plugin fails with error: <<<[ERROR] org.apache.maven.surefire.util.SurefireReflectionException: java.lang.NoClassDefFoundError: org/testng/IInvokedMethodListener>>> -Skipping after the Nth failure or error +Skipping Tests After the Nth Failure or Error To skip remaining tests after the Nth failure or error has happened set configuration parameter <<<skipAfterFailureCount>>> to N, where N is number greater than zero. +Prerequisite + + Use ${project.artifactId} 2.19 or higher, JUnit 4.0 or higher, or + TestNG 5.10 or higher. + + Notices TestNG reports skipped methods however JUnit reports skipped classes. Preferably use JUnit 4.12 or higher version which fixed thread safety issues. + + +Limitations + + Although this feature works in forking modes as well, the functionality + cannot be fully guaranteed (real first failure) in concurrent mode + due to race conditions. \ No newline at end of file