Author: bayard
Date: Sat Apr 3 05:03:06 2010
New Revision: 930473
URL: http://svn.apache.org/viewvc?rev=930473&view=rev
Log:
Performed some editing on the check class file format section
Modified:
commons/proper/commons-site/trunk/src/site/xdoc/releases/prepare.xml
Modified: commons/proper/commons-site/trunk/src/site/xdoc/releases/prepare.xml
URL:
http://svn.apache.org/viewvc/commons/proper/commons-site/trunk/src/site/xdoc/releases/prepare.xml?rev=930473&r1=930472&r2=930473&view=diff
==============================================================================
--- commons/proper/commons-site/trunk/src/site/xdoc/releases/prepare.xml
(original)
+++ commons/proper/commons-site/trunk/src/site/xdoc/releases/prepare.xml Sat
Apr 3 05:03:06 2010
@@ -138,8 +138,8 @@
files are specified in the goal or subgoals and should be verified
similarly to above.
</p>
<p>
- Test the "Ant dist" or "mvn assembly:assembly" goal and inspect the
tars/zips and jars produced.
- "Ant dist" or "mvn site" should succeed from the unpacked source
distribution. Make sure it does.
+ Test the "ant dist" or "mvn assembly:assembly" goal and inspect the
tars/zips and jars produced.
+ "ant dist" or "mvn site" should succeed from the unpacked source
distribution. Make sure it does.
Check the jar manifests per the guidelines below. Check the build using
the minimum supported JDK.
Check that "mvn site" generates the documentation correctly. Check that
all links are working.
Do not proceed with tagging or cutting RCs until you have a fully
working build that produces
@@ -147,30 +147,22 @@
</p>
</subsection>
<subsection name='Check Class File Format'>
- <p>
- Unless appropriate options are set, code compiled with more modern JVMs
- may fail on older JVMs. The minimum target JVM for the project should be
- documented. Check that compilation produces code that will execute
correctly
- on that JVM.
- </p>
- <p>
- If using maven, the <code>maven.compile.target</code> property in the
- <code>pom.xml</code> file should be set correctly.
- If using ant, the <code>javac</code> task should have the
<code>target</code>
- attribute set correctly.
- </p>
- <p>
- The maven build now adds entries to the jar's manifest to show the values
- of the <code>maven.compile.source</code> and
<code>maven.compile.target</code>
- properties used to generate the jar. For more details on this see sections
- <a href="#checkjarmanifest">Check The Jar Manifest</a> and
- <a href="#classfileformat">Class File Format</a> for more details.
- </p>
- <p>
- For Maven builds, the Commons parent POM specifies default values for
- <code>maven.compile.source</code> and <code>maven.compile.target</code>.
These
- values must be overridden in the project's POM if they're not appropriate
for it.
- </p>
+ <p>
+ Unless appropriate options are set, code compiled with more modern JVMs
+ may fail on older JVMs. The minimum target JVM for the project should be
+ documented. Check that compilation produces code that will execute
correctly
+ on that JVM.
+ </p>
+ <p>
+ If using maven, the <code>maven.compile.source</code> and
<code>maven.compile.target</code>
+ properties in the <code>pom.xml</code> file should be set correctly, if
the desired versions
+ differ from the default values in the Commons parent POM. Maven will add
entries to
+ the jar's manifest.
+ </p>
+ <p>
+ If using ant, the <code>javac</code> task should have the
<code>target</code> and <code>source</code>
+ attributes set correctly.
+ </p>
</subsection>
</section>
