You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by st...@apache.org on 2011/06/27 13:44:36 UTC
svn commit: r1140118 - in
/maven/surefire/trunk/maven-surefire-plugin/src/site: apt/developing.apt.vm
apt/developingSurefire.apt.vm site.xml
Author: stephenc
Date: Mon Jun 27 11:44:36 2011
New Revision: 1140118
URL: http://svn.apache.org/viewvc?rev=1140118&view=rev
Log:
try to make the links not include "Surefire" in the URL (also fix the developing page and give it a link separate from the Overview and Examples sections
Added:
maven/surefire/trunk/maven-surefire-plugin/src/site/apt/developing.apt.vm (contents, props changed)
- copied, changed from r1140114, maven/surefire/trunk/maven-surefire-plugin/src/site/apt/developingSurefire.apt.vm
Removed:
maven/surefire/trunk/maven-surefire-plugin/src/site/apt/developingSurefire.apt.vm
Modified:
maven/surefire/trunk/maven-surefire-plugin/src/site/site.xml
Copied: maven/surefire/trunk/maven-surefire-plugin/src/site/apt/developing.apt.vm (from r1140114, maven/surefire/trunk/maven-surefire-plugin/src/site/apt/developingSurefire.apt.vm)
URL: http://svn.apache.org/viewvc/maven/surefire/trunk/maven-surefire-plugin/src/site/apt/developing.apt.vm?p2=maven/surefire/trunk/maven-surefire-plugin/src/site/apt/developing.apt.vm&p1=maven/surefire/trunk/maven-surefire-plugin/src/site/apt/developingSurefire.apt.vm&r1=1140114&r2=1140118&rev=1140118&view=diff
==============================================================================
--- maven/surefire/trunk/maven-surefire-plugin/src/site/apt/developingSurefire.apt.vm (original)
+++ maven/surefire/trunk/maven-surefire-plugin/src/site/apt/developing.apt.vm Mon Jun 27 11:44:36 2011
@@ -26,9 +26,12 @@
~~ NOTE: For help with the syntax of this file, see:
~~ http://maven.apache.org/doxia/references/apt-format.html
-When working with surefire, it is necessary to understand a few things:
+Developer Center
+
+ When working with surefire, it is necessary to understand a few things:
+
+* Multi-Module project
-Multi-Module project
The plugin is built as part of a multi-module plugin. The generated
'project information' will suggest that you check out (e.g.)
http://svn.apache.org/repos/asf/maven/surefire/trunk/${project.artifactId}.
@@ -36,32 +39,37 @@ Multi-Module project
http://svn.apache.org/repos/asf/maven/surefire/trunk and
build from there.
-JDK Versions
+* JDK Versions
+
The surefire booter is capable of booting all the way back to jdk1.3. Specifically
this means surefire-api, surefire-booter, common-junit3 and surefire-junit3 are
source/target 1.3. The plugin itself is 1.4 and several providers are 1.5.
-Provider Isolation
+* Provider Isolation
+
Classes in the SUT (Subject Under Test), override any classes within the
surefire providers. This means providers using any
third party dependencies (other than the test framework itself), should
shade these classes to a different package.
-Common provider modules
+* Common provider modules
+
The surefire-providers module contains common-junitXX modules. These modules
depend on the XX version of JUnit and can access the JUnit API's at the correct
JUnit version level. Unit tests can also be written that will run with the
correct JUnit version. At build time, all of the relevant parts of these "common"
modules are just shaded into the providers jar files.
-Shadefire
+* Shadefire
+
"Shadefire" is the first module to be run in the
surefire build. This creates as shaded version of the JUnit provider, and this provider
is thereafter used to build surefire itself (As of any release after 2.8). This is
because the SUT overrides the provider, and the shadefire provider has been
relocated to avoid this overriding when surefire is building itself.
-Deploying/releasing surefire
+* Deploying/releasing surefire
+
Surefire depends on a previous version of itself, which
is too advanced for maven 2.2.x dependency resolution, and maven 3.x is
required to build surefire. Until a 3.x site plugin is released the site
Propchange: maven/surefire/trunk/maven-surefire-plugin/src/site/apt/developing.apt.vm
------------------------------------------------------------------------------
svn:eol-style = native
Modified: maven/surefire/trunk/maven-surefire-plugin/src/site/site.xml
URL: http://svn.apache.org/viewvc/maven/surefire/trunk/maven-surefire-plugin/src/site/site.xml?rev=1140118&r1=1140117&r2=1140118&view=diff
==============================================================================
--- maven/surefire/trunk/maven-surefire-plugin/src/site/site.xml (original)
+++ maven/surefire/trunk/maven-surefire-plugin/src/site/site.xml Mon Jun 27 11:44:36 2011
@@ -42,5 +42,8 @@
<item name="Configuring the Classpath" href="examples/configuring-classpath.html"/>
<item name="Selecting providers" href="examples/providers.html"/>
</menu>
+ <menu name="Developer Center">
+ <item name="Developing" href="developing.html"/>
+ </menu>
</body>
</project>