You are viewing a plain text version of this content. The canonical link for it is here.
Posted to surefire-commits@maven.apache.org by be...@apache.org on 2008/04/27 22:51:14 UTC
svn commit: r652013 - in
/maven/surefire/trunk/maven-surefire-plugin/src/site/apt: ./ examples/
Author: bentmann
Date: Sun Apr 27 13:50:57 2008
New Revision: 652013
URL: http://svn.apache.org/viewvc?rev=652013&view=rev
Log:
o Polished site
Removed:
maven/surefire/trunk/maven-surefire-plugin/src/site/apt/introduction.apt
maven/surefire/trunk/maven-surefire-plugin/src/site/apt/testng.apt
Modified:
maven/surefire/trunk/maven-surefire-plugin/src/site/apt/examples/class-loading.apt
maven/surefire/trunk/maven-surefire-plugin/src/site/apt/examples/forking.apt
maven/surefire/trunk/maven-surefire-plugin/src/site/apt/examples/inclusion-exclusion.apt
maven/surefire/trunk/maven-surefire-plugin/src/site/apt/examples/skipping-test.apt
maven/surefire/trunk/maven-surefire-plugin/src/site/apt/examples/system-properties.apt
maven/surefire/trunk/maven-surefire-plugin/src/site/apt/examples/testng.apt
maven/surefire/trunk/maven-surefire-plugin/src/site/apt/index.apt
maven/surefire/trunk/maven-surefire-plugin/src/site/apt/usage.apt
Modified: maven/surefire/trunk/maven-surefire-plugin/src/site/apt/examples/class-loading.apt
URL: http://svn.apache.org/viewvc/maven/surefire/trunk/maven-surefire-plugin/src/site/apt/examples/class-loading.apt?rev=652013&r1=652012&r2=652013&view=diff
==============================================================================
--- maven/surefire/trunk/maven-surefire-plugin/src/site/apt/examples/class-loading.apt (original)
+++ maven/surefire/trunk/maven-surefire-plugin/src/site/apt/examples/class-loading.apt Sun Apr 27 13:50:57 2008
@@ -29,6 +29,7 @@
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
+ <version>2.4.2</version>
<configuration>
<childDelegation>true</childDelegation>
</configuration>
Modified: maven/surefire/trunk/maven-surefire-plugin/src/site/apt/examples/forking.apt
URL: http://svn.apache.org/viewvc/maven/surefire/trunk/maven-surefire-plugin/src/site/apt/examples/forking.apt?rev=652013&r1=652012&r2=652013&view=diff
==============================================================================
--- maven/surefire/trunk/maven-surefire-plugin/src/site/apt/examples/forking.apt (original)
+++ maven/surefire/trunk/maven-surefire-plugin/src/site/apt/examples/forking.apt Sun Apr 27 13:50:57 2008
@@ -21,6 +21,7 @@
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
+ <version>2.4.2</version>
<configuration>
<forkMode>pertest</forkMode>
<argLine>-enableassertions</argLine>
Modified: maven/surefire/trunk/maven-surefire-plugin/src/site/apt/examples/inclusion-exclusion.apt
URL: http://svn.apache.org/viewvc/maven/surefire/trunk/maven-surefire-plugin/src/site/apt/examples/inclusion-exclusion.apt?rev=652013&r1=652012&r2=652013&view=diff
==============================================================================
--- maven/surefire/trunk/maven-surefire-plugin/src/site/apt/examples/inclusion-exclusion.apt (original)
+++ maven/surefire/trunk/maven-surefire-plugin/src/site/apt/examples/inclusion-exclusion.apt Sun Apr 27 13:50:57 2008
@@ -10,7 +10,7 @@
* Inclusions
- By default, the surefire plugin will automatically include all test classes
+ By default, the Surefire Plugin will automatically include all test classes
with the following wildcard patterns:
* <"**/Test*.java"> - includes all of its subdirectory and all java
@@ -25,7 +25,7 @@
[]
If the test classes does not go with the naming convention, then configure
- surefire plugin and specify the tests you want to include.
+ Surefire Plugin and specify the tests you want to include.
+---+
<project>
@@ -35,6 +35,7 @@
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
+ <version>2.4.2</version>
<configuration>
<includes>
<include>Sample.java</include>
@@ -62,6 +63,7 @@
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
+ <version>2.4.2</version>
<configuration>
<excludes>
<exclude>**/TestCircle.java</exclude>
Modified: maven/surefire/trunk/maven-surefire-plugin/src/site/apt/examples/skipping-test.apt
URL: http://svn.apache.org/viewvc/maven/surefire/trunk/maven-surefire-plugin/src/site/apt/examples/skipping-test.apt?rev=652013&r1=652012&r2=652013&view=diff
==============================================================================
--- maven/surefire/trunk/maven-surefire-plugin/src/site/apt/examples/skipping-test.apt (original)
+++ maven/surefire/trunk/maven-surefire-plugin/src/site/apt/examples/skipping-test.apt Sun Apr 27 13:50:57 2008
@@ -21,6 +21,7 @@
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
+ <version>2.4.2</version>
<configuration>
<skipTests>true</skipTests>
</configuration>
@@ -37,7 +38,8 @@
mvn install -DskipTests
+---+
- If you absolutely must, you can also use the maven.test.skip property to skip compiling the tests. maven.test.skip is honored by Surefire and the compiler plugin.
+ If you absolutely must, you can also use the <<<maven.test.skip>>> property to skip compiling the tests.
+ <<<maven.test.skip>>> is honored by Surefire and the Compiler Plugin.
+---+
mvn install -Dmaven.test.skip=true
Modified: maven/surefire/trunk/maven-surefire-plugin/src/site/apt/examples/system-properties.apt
URL: http://svn.apache.org/viewvc/maven/surefire/trunk/maven-surefire-plugin/src/site/apt/examples/system-properties.apt?rev=652013&r1=652012&r2=652013&view=diff
==============================================================================
--- maven/surefire/trunk/maven-surefire-plugin/src/site/apt/examples/system-properties.apt (original)
+++ maven/surefire/trunk/maven-surefire-plugin/src/site/apt/examples/system-properties.apt Sun Apr 27 13:50:57 2008
@@ -8,7 +8,7 @@
Using System Properties
- To add a System property, use the following configuration:
+ To add a system property, use the following configuration:
+---+
<project>
@@ -18,6 +18,7 @@
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
+ <version>2.4.2</version>
<configuration>
<systemProperties>
<property>
@@ -34,8 +35,8 @@
+---+
Take note that <<String valued>> properties can only be passed as system
- properties. Any attempt to pass any other maven variable type (i.e. List
- or a URL variable) will cause the variable expression to be passed
+ properties. Any attempt to pass any other Maven variable type (i.e. <<<List>>>
+ or a <<<URL>>> variable) will cause the variable expression to be passed
literally (unevaluated). So having an example below:
+---+
@@ -46,6 +47,7 @@
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
+ <version>2.4.2</version>
<configuration>
<systemProperties>
<property>
@@ -61,5 +63,5 @@
</project>
+---+
- will literally pass <<${project.build.outputDirectory}>> because the value
- of that expression is a File, not a String.
\ No newline at end of file
+ will literally pass <<$\{project.build.outputDirectory\}>> because the value
+ of that expression is a <<<File>>>, not a <<<String>>>.
Modified: maven/surefire/trunk/maven-surefire-plugin/src/site/apt/examples/testng.apt
URL: http://svn.apache.org/viewvc/maven/surefire/trunk/maven-surefire-plugin/src/site/apt/examples/testng.apt?rev=652013&r1=652012&r2=652013&view=diff
==============================================================================
--- maven/surefire/trunk/maven-surefire-plugin/src/site/apt/examples/testng.apt (original)
+++ maven/surefire/trunk/maven-surefire-plugin/src/site/apt/examples/testng.apt Sun Apr 27 13:50:57 2008
@@ -17,7 +17,7 @@
<dependency>
<groupId>org.testng</groupId>
<artifactId>testng</artifactId>
- <version>4.7</version>
+ <version>5.7</version>
<scope>test</scope>
<classifier>jdk15</classifier>
</dependency>
@@ -35,14 +35,15 @@
* Using Suite XML Files
- Another alternative is to use test NG suite XML files. This allows flexible configuration of the tests to be run.
- These files are created as normal, and then added to the Surefire plugin configuration:
+ Another alternative is to use TestNG suite XML files. This allows flexible configuration of the tests to be run.
+ These files are created as normal, and then added to the Surefire Plugin configuration:
+---+
[...]
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
+ <version>2.4.2</version>
<configuration>
<suiteXmlFiles>
<suiteXmlFile>testng.xml</suiteXmlFile>
@@ -64,6 +65,7 @@
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
+ <version>2.4.2</version>
<configuration>
<groups>functest,perftest</groups>
</configuration>
@@ -84,6 +86,7 @@
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
+ <version>2.4.2</version>
<configuration>
<parallel>true</parallel>
<threadCount>10</threadCount>
@@ -95,6 +98,6 @@
This is particularly useful for slow tests that can have high concurrency, or to quickly and roughly assess the independance
and thread safety of your tests and code.
- For more information on TestNG, see the project {{{http://www.testng.org} web site}}.
+ For more information on TestNG, see the {{{http://www.testng.org}TestNG web site}}.
Modified: maven/surefire/trunk/maven-surefire-plugin/src/site/apt/index.apt
URL: http://svn.apache.org/viewvc/maven/surefire/trunk/maven-surefire-plugin/src/site/apt/index.apt?rev=652013&r1=652012&r2=652013&view=diff
==============================================================================
--- maven/surefire/trunk/maven-surefire-plugin/src/site/apt/index.apt (original)
+++ maven/surefire/trunk/maven-surefire-plugin/src/site/apt/index.apt Sun Apr 27 13:50:57 2008
@@ -8,24 +8,24 @@
Maven Surefire Plugin
- The surefire plugin is used during the <<<test>>> phase of the build
+ The Surefire Plugin is used during the <<<test>>> phase of the build
lifecycle to execute the unit tests of an application. It generates reports
in 2 different file formats:
* Plain text files (*.txt)
- * Xml files (*.xml)
+ * XML files (*.xml)
[]
- By default, these files are generated at <<<${basedir}/target/surefire-reports>>>.
+ By default, these files are generated at <<<$\{basedir\}/target/surefire-reports>>>.
- For an html format of the report, please see the
- {{{http://maven.apache.org/plugins/maven-surefire-report-plugin/}maven-surefire-report-plugin}}.
+ For an HTML format of the report, please see the
+ {{{http://maven.apache.org/plugins/maven-surefire-report-plugin/}Maven Surefire Report Plugin}}.
* Goals Overview
- The surefire plugin has only 1 goal:
+ The Surefire Plugin has only 1 goal:
* {{{test-mojo.html}surefire:test}} runs the unit tests of an application.
@@ -33,11 +33,11 @@
* Usage
- Instructions on how to use the surefire plugin can be found {{{usage.html}here}}.
+ Instructions on how to use the Surefire Plugin can be found on the {{{usage.html}usage page}}.
* Examples
- The following examples show how to use the surefire plugin in more advanced use-cases:
+ The following examples show how to use the Surefire Plugin in more advanced use-cases:
* {{{examples/skipping-test.html}Skipping Tests}}
Modified: maven/surefire/trunk/maven-surefire-plugin/src/site/apt/usage.apt
URL: http://svn.apache.org/viewvc/maven/surefire/trunk/maven-surefire-plugin/src/site/apt/usage.apt?rev=652013&r1=652012&r2=652013&view=diff
==============================================================================
--- maven/surefire/trunk/maven-surefire-plugin/src/site/apt/usage.apt (original)
+++ maven/surefire/trunk/maven-surefire-plugin/src/site/apt/usage.apt Sun Apr 27 13:50:57 2008
@@ -9,7 +9,7 @@
Usage
- The surefire plugin can be invoked by calling the <<<test>>> phase of the
+ The Surefire Plugin can be invoked by calling the <<<test>>> phase of the
build lifecycle.
+---+
@@ -42,7 +42,7 @@
assertions, the JDK 1.4 <<<assert>>> keyword can be used, or you can use
<<<org.apache.maven.surefire.assertion.Assert>>>.
- All of the providers support the surefire plugin parameter configurations.
+ All of the providers support the Surefire Plugin parameter configurations.
However, there are additional options available if you are running TestNG
tests (including if you are using TestNG to execute your JUnit tests, which
occurs by default if both are present in Surefire).