You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@commons.apache.org by se...@apache.org on 2020/08/07 12:14:11 UTC
svn commit: r1064055 [1/4] - in /websites/staging/commons/trunk/content: ./
downloads/ gsoc/ gsoc/2010/ releases/
Author: sebb
Date: Fri Aug 7 12:14:11 2020
New Revision: 1064055
Log:
Manual deploy
Added:
websites/staging/commons/trunk/content/team.html (with props)
Removed:
websites/staging/commons/trunk/content/team-list.html
Modified:
websites/staging/commons/trunk/content/bugs.html
websites/staging/commons/trunk/content/building.html
websites/staging/commons/trunk/content/charter.html
websites/staging/commons/trunk/content/commons-parent-pom.html
websites/staging/commons/trunk/content/components.html
websites/staging/commons/trunk/content/dormant.html
websites/staging/commons/trunk/content/downloads/index.html
websites/staging/commons/trunk/content/gsoc/2010/index.html
websites/staging/commons/trunk/content/gsoc/index.html
websites/staging/commons/trunk/content/index.html
websites/staging/commons/trunk/content/mail-lists.html
websites/staging/commons/trunk/content/new-sandbox-component.html
websites/staging/commons/trunk/content/oldcharter.html
websites/staging/commons/trunk/content/patches.html
websites/staging/commons/trunk/content/project-info.html
websites/staging/commons/trunk/content/releases/index.html
websites/staging/commons/trunk/content/releases/moving-to-dormant.html
websites/staging/commons/trunk/content/releases/prepare.html
websites/staging/commons/trunk/content/releases/publish-site.html
websites/staging/commons/trunk/content/releases/release.html
websites/staging/commons/trunk/content/releases/versioning.html
websites/staging/commons/trunk/content/sandbox.html
websites/staging/commons/trunk/content/scminfo.html
websites/staging/commons/trunk/content/security.html
websites/staging/commons/trunk/content/site-publish.html
websites/staging/commons/trunk/content/volunteering.html
Modified: websites/staging/commons/trunk/content/bugs.html
==============================================================================
--- websites/staging/commons/trunk/content/bugs.html (original)
+++ websites/staging/commons/trunk/content/bugs.html Fri Aug 7 12:14:11 2020
@@ -1,6 +1,6 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia at 26 July 2020
+ | Generated by Apache Maven Doxia at 07 August 2020
| Rendered using Apache Maven Fluido Skin 1.3.0
-->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
@@ -8,7 +8,7 @@
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta name="author" content="The Apache Commons Team" />
- <meta name="Date-Revision-yyyymmdd" content="20200726" />
+ <meta name="Date-Revision-yyyymmdd" content="20200807" />
<meta http-equiv="Content-Language" content="en" />
<title>Apache Commons – On Reporting Bugs</title>
@@ -25,7 +25,7 @@
</head>
<body class="composite">
- <a href="./" id="bannerLeft" title="Apache Commons logo">
+ <a href="http://commons.apache.org/" id="bannerLeft" title="Apache Commons logo">
<img class="logo-left" src="images/commons-logo.png" alt="Apache Commons logo"/>
</a>
<div class="clear"></div>
@@ -33,11 +33,11 @@
<div class="navbar">
<div class="navbar-inner">
<div class="container-fluid">
- <a class="brand" href="http://commons.apache.org/">Apache Commons ™</a>
+ <a class="brand" href="https://commons.apache.org/">Apache Commons ™</a>
<ul class="nav">
- <li id="publishDate">Last Published: 26 July 2020</li>
- <li class="divider">|</li> <li id="projectVersion">Version: 19</li>
+ <li id="publishDate">Last Published: 07 August 2020</li>
+ <li class="divider">|</li> <li id="projectVersion">Version: 23</li>
</ul>
<div class="pull-right"> <ul class="nav">
<li>
@@ -86,7 +86,7 @@
Mailing Lists</a>
</li>
<li class="none">
- <a href="team-list.html" title="PMC">
+ <a href="team.html" title="PMC">
PMC</a>
</li>
<li class="collapsed">
@@ -205,22 +205,9 @@
</div>
</td>
<td class="content">
- <!-- $Id: bugs.xml 560088 2007-07-27 04:05:00Z bayard $ --><!-- Licensed to the Apache Software Foundation (ASF) under one or more
- contributor license agreements. See the NOTICE file distributed with
- this work for additional information regarding copyright ownership.
- The ASF licenses this file to You under the Apache License, Version 2.0
- (the "License"); you may not use this file except in compliance with
- the License. You may obtain a copy of the License at
-
- http://www.apache.org/licenses/LICENSE-2.0
-
- Unless required by applicable law or agreed to in writing, software
- distributed under the License is distributed on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- See the License for the specific language governing permissions and
- limitations under the License. -->
+
- <div class="section">
+ <section>
<h2><a name="On_Reporting_Bugs"></a>On Reporting Bugs</h2>
@@ -229,9 +216,8 @@
<p>The usual rules apply - please look to see if the bug already exists before reporting it; please only reports bugs and enhancements, if you have a question, please bring it to the mailing list. Including all your information will help the issue be dealt with quicker, however please use a little common sense and avoid those 50 page recursive stack traces. </p>
- </div>
-
-<div class="section">
+ </section>
+ <section>
<h2><a name="On_Making_Patches"></a>On Making Patches</h2>
@@ -255,7 +241,7 @@ fix a concurrency bug in the foo compone
for developers who need to apply a number of different patches.
</p>
- </div>
+ </section>
@@ -268,7 +254,7 @@ for developers who need to apply a numbe
<p>Copyright © 2020
<a href="https://www.apache.org/">The Apache Software Foundation</a>.
All Rights Reserved.</p>
-
+ <?xml version="1.0" encoding="UTF-8"?>
<div class="center">Apache Commons, Apache, the Apache feather logo, and the Apache Commons project logos are trademarks of The Apache Software Foundation.
All other marks mentioned may be trademarks or registered trademarks of their respective owners.</div>
</div>
Modified: websites/staging/commons/trunk/content/building.html
==============================================================================
--- websites/staging/commons/trunk/content/building.html (original)
+++ websites/staging/commons/trunk/content/building.html Fri Aug 7 12:14:11 2020
@@ -1,6 +1,6 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia at 26 July 2020
+ | Generated by Apache Maven Doxia at 07 August 2020
| Rendered using Apache Maven Fluido Skin 1.3.0
-->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
@@ -8,7 +8,7 @@
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta name="author" content="Apache Commons Documentation Team" />
- <meta name="Date-Revision-yyyymmdd" content="20200726" />
+ <meta name="Date-Revision-yyyymmdd" content="20200807" />
<meta http-equiv="Content-Language" content="en" />
<title>Apache Commons – Building Apache Commons Components</title>
@@ -25,7 +25,7 @@
</head>
<body class="composite">
- <a href="./" id="bannerLeft" title="Apache Commons logo">
+ <a href="http://commons.apache.org/" id="bannerLeft" title="Apache Commons logo">
<img class="logo-left" src="images/commons-logo.png" alt="Apache Commons logo"/>
</a>
<div class="clear"></div>
@@ -33,11 +33,11 @@
<div class="navbar">
<div class="navbar-inner">
<div class="container-fluid">
- <a class="brand" href="http://commons.apache.org/">Apache Commons ™</a>
+ <a class="brand" href="https://commons.apache.org/">Apache Commons ™</a>
<ul class="nav">
- <li id="publishDate">Last Published: 26 July 2020</li>
- <li class="divider">|</li> <li id="projectVersion">Version: 19</li>
+ <li id="publishDate">Last Published: 07 August 2020</li>
+ <li class="divider">|</li> <li id="projectVersion">Version: 23</li>
</ul>
<div class="pull-right"> <ul class="nav">
<li>
@@ -86,7 +86,7 @@
Mailing Lists</a>
</li>
<li class="none">
- <a href="team-list.html" title="PMC">
+ <a href="team.html" title="PMC">
PMC</a>
</li>
<li class="collapsed">
@@ -205,23 +205,10 @@
</div>
</td>
<td class="content">
- <!-- Licensed to the Apache Software Foundation (ASF) under one or more
- contributor license agreements. See the NOTICE file distributed with
- this work for additional information regarding copyright ownership.
- The ASF licenses this file to You under the Apache License, Version 2.0
- (the "License"); you may not use this file except in compliance with
- the License. You may obtain a copy of the License at
-
- http://www.apache.org/licenses/LICENSE-2.0
-
- Unless required by applicable law or agreed to in writing, software
- distributed under the License is distributed on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- See the License for the specific language governing permissions and
- limitations under the License. -->
+
- <div class="section">
+ <section>
<h2><a name="Introduction"></a>Introduction</h2>
<p>
@@ -246,10 +233,9 @@
for more information. Commons components now use version 3 of Maven,
so this is the Maven version assumed throughout this document.
</p>
- </div>
+ </section>
-
-<div class="section">
+ <section>
<h2><a name="Commons_Parent_POM"></a>Commons Parent POM</h2>
<p>
@@ -257,18 +243,16 @@
This contains common setup to reduce the setup needed in each component POM
and standardizes the builds across Commons components.
</p>
- </div>
+ </section>
-
-<div class="section">
+ <section>
<h2><a name="Local_environment_setup"></a>Local environment setup</h2>
<p>
To build Apache Commons components or web sites, you need to have Maven
installed and the project source files checked out locally.
</p>
-
-<div class="section">
+ <section>
<h3><a name="Getting_and_installing_Maven"></a>Getting and installing Maven</h3>
<p>
@@ -276,9 +260,8 @@
<a class="externalLink" href="http://maven.apache.org/download.html">
Maven download instructions</a> to download and install Maven.
</p>
- </div>
-
-<div class="section">
+ </section>
+ <section>
<h3><a name="Checking_out_the_Commons_sources"></a>Checking out the Commons sources</h3>
<p>
@@ -286,38 +269,35 @@
<a class="externalLink" href="http://commons.apache.org/scminfo.html">
Commons subversion instructions</a> to check out the Commons source
files. If you want to build Commons component web sites, you need to have
- the <tt>commons-build</tt> module checked out as a peer to whatever
+ the <code>commons-build</code> module checked out as a peer to whatever
component(s) you are trying to generate the site for. If you check out
the full set of "trunks" using the svn externals "trunks-proper" or
"trunks-sandbox" this will happen automatically.
</p>
- </div>
-
-<div class="section">
+ </section>
+ <section>
<h3><a name="Configuring_local_properties"></a>Configuring local properties</h3>
<p>
If you regularly want to build Commons components using a different version of Java
than that used to run Maven, you may wish to define the locations of the alternate
- JDKs in the Maven <tt>settings.xml</tt> file.
+ JDKs in the Maven <code>settings.xml</code> file.
See <a href="commons-parent-pom.html#Testing_with_different_Java_versions">testing with different Java versions</a>
for more details.
Alternatively, you can provide the location of the alternate JDK as a property on the Maven command-line, see below.
</p>
- </div>
- </div>
+ </section>
+ </section>
-
-<div class="section">
+ <section>
<h2><a name="Maven_Commands"></a>Maven Commands</h2>
-
-<div class="section">
+ <section>
<h3><a name="Compile_and_test_with_a_specific_JDK"></a>Compile and test with a specific JDK</h3>
<p>
To compile and run a component's tests with JDK 1.5.
- This assumes that the property JAVA_1_5_HOME has been defined in the Maven <tt>settings.xml</tt>
+ This assumes that the property JAVA_1_5_HOME has been defined in the Maven <code>settings.xml</code>
or has been defined as an OS environment variable (if both are defined, settings.xml takes precedence)
</p>
@@ -331,10 +311,9 @@
<div class="source">
<pre>mvn [clean] test-compile -Pjava-1.6 -DJAVA_1_6_HOME=path-to-jdk-home</pre></div>
- </div>
+ </section>
-
-<div class="section">
+ <section>
<h3><a name="Running_the_Tests"></a>Running the Tests</h3>
<p>
@@ -343,10 +322,9 @@
<div class="source">
<pre>mvn test</pre></div>
- </div>
+ </section>
-
-<div class="section">
+ <section>
<h3><a name="Creating_a_jar_file"></a>Creating a jar file</h3>
<p>
@@ -355,10 +333,9 @@
<div class="source">
<pre>mvn package</pre></div>
- </div>
+ </section>
-
-<div class="section">
+ <section>
<h3><a name="Installing"></a>Installing</h3>
<p>
@@ -367,10 +344,9 @@
<div class="source">
<pre>mvn install</pre></div>
- </div>
+ </section>
-
-<div class="section">
+ <section>
<h3><a name="Source_and_binary_distributions"></a>Source and binary distributions</h3>
<p>
@@ -380,10 +356,9 @@
<div class="source">
<pre>mvn -Prelease package</pre></div>
- </div>
+ </section>
-
-<div class="section">
+ <section>
<h3><a name="Generating_the_Site"></a>Generating the Site</h3>
<p>
@@ -392,9 +367,9 @@
<div class="source">
<pre>mvn site</pre></div>
- </div>
+ </section>
- </div>
+ </section>
@@ -407,7 +382,7 @@
<p>Copyright © 2020
<a href="https://www.apache.org/">The Apache Software Foundation</a>.
All Rights Reserved.</p>
-
+ <?xml version="1.0" encoding="UTF-8"?>
<div class="center">Apache Commons, Apache, the Apache feather logo, and the Apache Commons project logos are trademarks of The Apache Software Foundation.
All other marks mentioned may be trademarks or registered trademarks of their respective owners.</div>
</div>
Modified: websites/staging/commons/trunk/content/charter.html
==============================================================================
--- websites/staging/commons/trunk/content/charter.html (original)
+++ websites/staging/commons/trunk/content/charter.html Fri Aug 7 12:14:11 2020
@@ -1,6 +1,6 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia at 26 July 2020
+ | Generated by Apache Maven Doxia at 07 August 2020
| Rendered using Apache Maven Fluido Skin 1.3.0
-->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
@@ -8,7 +8,7 @@
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta name="author" content="Commons Documentation Team" />
- <meta name="Date-Revision-yyyymmdd" content="20200726" />
+ <meta name="Date-Revision-yyyymmdd" content="20200807" />
<meta http-equiv="Content-Language" content="en" />
<title>Apache Commons – Charter</title>
@@ -25,7 +25,7 @@
</head>
<body class="composite">
- <a href="./" id="bannerLeft" title="Apache Commons logo">
+ <a href="http://commons.apache.org/" id="bannerLeft" title="Apache Commons logo">
<img class="logo-left" src="images/commons-logo.png" alt="Apache Commons logo"/>
</a>
<div class="clear"></div>
@@ -33,11 +33,11 @@
<div class="navbar">
<div class="navbar-inner">
<div class="container-fluid">
- <a class="brand" href="http://commons.apache.org/">Apache Commons ™</a>
+ <a class="brand" href="https://commons.apache.org/">Apache Commons ™</a>
<ul class="nav">
- <li id="publishDate">Last Published: 26 July 2020</li>
- <li class="divider">|</li> <li id="projectVersion">Version: 19</li>
+ <li id="publishDate">Last Published: 07 August 2020</li>
+ <li class="divider">|</li> <li id="projectVersion">Version: 23</li>
</ul>
<div class="pull-right"> <ul class="nav">
<li>
@@ -86,7 +86,7 @@
Mailing Lists</a>
</li>
<li class="none">
- <a href="team-list.html" title="PMC">
+ <a href="team.html" title="PMC">
PMC</a>
</li>
<li class="collapsed">
@@ -205,24 +205,11 @@
</div>
</td>
<td class="content">
- <!-- Licensed to the Apache Software Foundation (ASF) under one or more
- contributor license agreements. See the NOTICE file distributed with
- this work for additional information regarding copyright ownership.
- The ASF licenses this file to You under the Apache License, Version 2.0
- (the "License"); you may not use this file except in compliance with
- the License. You may obtain a copy of the License at
-
- http://www.apache.org/licenses/LICENSE-2.0
-
- Unless required by applicable law or agreed to in writing, software
- distributed under the License is distributed on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- See the License for the specific language governing permissions and
- limitations under the License. -->
+
-<div class="section">
+<section>
<h2><a name="Scope_of_Apache_Commons"></a>Scope of Apache Commons</h2>
@@ -307,18 +294,17 @@ D. Establish the Apache Commons project
<p>This defines the scope of Apache Commons. </p>
-</div>
-
+</section>
-<div class="section">
-<h2><a name="Apache_Commons_Charter"></a>Apache Commons 'Charter'</h2>
+<section>
+<h2><a name="Apache_Commons_.27Charter.27"></a>Apache Commons 'Charter'</h2>
<p>The Apache Commons PMC may decide to focus the scope further via various policies, rules and guidelines that will
appear below. For posterity, the <a href="oldcharter.html">Jakarta Commons Charter</a> is kept as a part of this website. </p>
<p>Currently no such refinements apply. </p>
-</div>
+</section>
@@ -331,7 +317,7 @@ appear below. For posterity, the <a href
<p>Copyright © 2020
<a href="https://www.apache.org/">The Apache Software Foundation</a>.
All Rights Reserved.</p>
-
+ <?xml version="1.0" encoding="UTF-8"?>
<div class="center">Apache Commons, Apache, the Apache feather logo, and the Apache Commons project logos are trademarks of The Apache Software Foundation.
All other marks mentioned may be trademarks or registered trademarks of their respective owners.</div>
</div>
Modified: websites/staging/commons/trunk/content/commons-parent-pom.html
==============================================================================
--- websites/staging/commons/trunk/content/commons-parent-pom.html (original)
+++ websites/staging/commons/trunk/content/commons-parent-pom.html Fri Aug 7 12:14:11 2020
@@ -1,13 +1,13 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia at 26 July 2020
+ | Generated by Apache Maven Doxia at 07 August 2020
| Rendered using Apache Maven Fluido Skin 1.3.0
-->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <meta name="Date-Revision-yyyymmdd" content="20200726" />
+ <meta name="Date-Revision-yyyymmdd" content="20200807" />
<meta http-equiv="Content-Language" content="en" />
<title>Apache Commons – Apache Commons Parent pom.xml</title>
@@ -24,7 +24,7 @@
</head>
<body class="composite">
- <a href="./" id="bannerLeft" title="Apache Commons logo">
+ <a href="http://commons.apache.org/" id="bannerLeft" title="Apache Commons logo">
<img class="logo-left" src="images/commons-logo.png" alt="Apache Commons logo"/>
</a>
<div class="clear"></div>
@@ -32,11 +32,11 @@
<div class="navbar">
<div class="navbar-inner">
<div class="container-fluid">
- <a class="brand" href="http://commons.apache.org/">Apache Commons ™</a>
+ <a class="brand" href="https://commons.apache.org/">Apache Commons ™</a>
<ul class="nav">
- <li id="publishDate">Last Published: 26 July 2020</li>
- <li class="divider">|</li> <li id="projectVersion">Version: 19</li>
+ <li id="publishDate">Last Published: 07 August 2020</li>
+ <li class="divider">|</li> <li id="projectVersion">Version: 23</li>
</ul>
<div class="pull-right"> <ul class="nav">
<li>
@@ -85,7 +85,7 @@
Mailing Lists</a>
</li>
<li class="none">
- <a href="team-list.html" title="PMC">
+ <a href="team.html" title="PMC">
PMC</a>
</li>
<li class="collapsed">
@@ -204,31 +204,18 @@
</div>
</td>
<td class="content">
- <!-- Licensed to the Apache Software Foundation (ASF) under one or more
- contributor license agreements. See the NOTICE file distributed with
- this work for additional information regarding copyright ownership.
- The ASF licenses this file to You under the Apache License, Version 2.0
- (the "License"); you may not use this file except in compliance with
- the License. You may obtain a copy of the License at
-
- http://www.apache.org/licenses/LICENSE-2.0
-
- Unless required by applicable law or agreed to in writing, software
- distributed under the License is distributed on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- See the License for the specific language governing permissions and
- limitations under the License. -->
+
- <div class="section">
+ <section>
<h2><a name="commons-parent"></a>commons-parent</h2>
<p>
This page provides information about the
<a class="externalLink" href="https://github.com/apache/commons-parent/blob/master/pom.xml">commons-parent</a>
- <tt>pom.xml</tt>
+ <code>pom.xml</code>
<br />
It has been updated for version 46 of the pom (but some discrepancies may remain).
Please consult <a class="externalLink" href="https://github.com/apache/commons-parent/tree/commons-parent-46/">version 46 source</a>
@@ -250,8 +237,7 @@
component and <i>standardizes</i> the builds across Commons components.
</p>
-
-<div class="section">
+ <section>
<h3><a name="Build"></a>Build</h3>
<p>
@@ -266,45 +252,45 @@
and in order to achieve this with Maven the same <a class="externalLink" href="http://maven.apache.org/plugins/">Plugin</a>
versions need to be used each time.
<a class="externalLink" href="https://github.com/apache/commons-parent/blob/master/pom.xml">commons-parent</a>
- specifies the Plugin versions to be used in the <tt><pluginManagement></tt> section.
+ specifies the Plugin versions to be used in the <code><pluginManagement></code> section.
<ul>
<li>
- (<b>N.B.</b> the <tt><reporting></tt> section ignores anything specified in the
- <tt><pluginManagement></tt> section and component pom.xml's should specify the version of
+ (<b>N.B.</b> the <code><reporting></code> section ignores anything specified in the
+ <code><pluginManagement></code> section and component pom.xml's should specify the version of
any additional report plugins they specify).
</li>
</ul>
</li>
<li>
- <b><tt>LICENSE</tt> and <tt>NOTICE</tt> files</b> - automatically added to the jar files
+ <b><code>LICENSE</code> and <code>NOTICE</code> files</b> - automatically added to the jar files
produced by the build to conform with the <a class="externalLink" href="http://www.apache.org/dev/release.html#license">ASF License Policy</a>.
</li>
<li>
- <b><tt>MANIFEST.MF</tt> files</b> - The following information is automatically included in the componentjar's manifest file:
+ <b><code>MANIFEST.MF</code> files</b> - The following information is automatically included in the componentjar's manifest file:
<ul>
-<li><tt>Implementation-Title</tt> - set to the component's name</li>
+<li><code>Implementation-Title</code> - set to the component's name</li>
-<li><tt>Implementation-Vendor</tt> - set to <i>The Apache Software Foundation</i></li>
+<li><code>Implementation-Vendor</code> - set to <i>The Apache Software Foundation</i></li>
-<li><tt>Implementation-Vendor-Id</tt> - set to <tt>org.apache</tt></li>
+<li><code>Implementation-Vendor-Id</code> - set to <code>org.apache</code></li>
-<li><tt>Implementation-Version</tt> - set to the component version</li>
+<li><code>Implementation-Version</code> - set to the component version</li>
-<li><tt>Specification-Title</tt> - set to the component's name</li>
+<li><code>Specification-Title</code> - set to the component's name</li>
-<li><tt>Specification-Vendor</tt> - set to <i>The Apache Software Foundation</i></li>
+<li><code>Specification-Vendor</code> - set to <i>The Apache Software Foundation</i></li>
-<li><tt>Specification-Version</tt> - set to the component version</li>
+<li><code>Specification-Version</code> - set to the component version</li>
-<li><tt>X-Compile-Source-JDK</tt> - set to the <i>source</i> option used by the compiler</li>
+<li><code>X-Compile-Source-JDK</code> - set to the <i>source</i> option used by the compiler</li>
-<li><tt>X-Compile-Target-JDK</tt> - set to the <i>target</i> option used by the compiler</li>
+<li><code>X-Compile-Target-JDK</code> - set to the <i>target</i> option used by the compiler</li>
</ul>
</li>
@@ -316,30 +302,30 @@
<ul>
-<li><tt>Bundle-Name</tt> - set to the component's name</li>
+<li><code>Bundle-Name</code> - set to the component's name</li>
-<li><tt>Bundle-Vendor</tt> - set to <i>The Apache Software Foundation</i></li>
+<li><code>Bundle-Vendor</code> - set to <i>The Apache Software Foundation</i></li>
-<li><tt>Bundle-Version</tt> - set to the component version</li>
+<li><code>Bundle-Version</code> - set to the component version</li>
-<li><tt>Bundle-ManifestVersion</tt> - set to <b>2</b></li>
+<li><code>Bundle-ManifestVersion</code> - set to <b>2</b></li>
-<li><tt>Bundle-License</tt> - set to <tt>http://www.apache.org/licenses/LICENSE-2.0.txt</tt></li>
+<li><code>Bundle-License</code> - set to <code>http://www.apache.org/licenses/LICENSE-2.0.txt</code></li>
-<li><tt>Bundle-Description</tt> - set to the component's description</li>
+<li><code>Bundle-Description</code> - set to the component's description</li>
-<li><tt>Bundle-SymbolicName</tt> - set to the component's package name (e.g. <tt>org.apache.commons.beanutils</tt>)</li>
+<li><code>Bundle-SymbolicName</code> - set to the component's package name (e.g. <code>org.apache.commons.beanutils</code>)</li>
-<li><tt>Bundle-DocURL</tt> - set to the component's website URL</li>
+<li><code>Bundle-DocURL</code> - set to the component's website URL</li>
-<li><tt>Export-Package</tt> - set to the component's package names (can be overriden)</li>
+<li><code>Export-Package</code> - set to the component's package names (can be overriden)</li>
-<li><tt>Import-Package</tt> - set to the package names of the component's dependencies</li>
+<li><code>Import-Package</code> - set to the package names of the component's dependencies</li>
</ul>
</li>
<li>
- <b><a href="#Java_Version">Java Version</a></b> - <tt>source</tt> and <tt>target</tt>
+ <b><a href="#Java_Version">Java Version</a></b> - <code>source</code> and <code>target</code>
options can be configured through <i>properties</i>, and <i>profiles</i> are provided to test on
different Java versions.
Where necessary, plugin versions are down-graded to the latest version that runs on earlier JVMs. If later Java versions
@@ -347,19 +333,18 @@
</li>
<li>
- <b><a href="#Testing_Coverage">Testing Coverage</a></b> - both <tt>Jacoco</tt> and <tt>Cobertura</tt>
+ <b><a href="#Testing_Coverage">Testing Coverage</a></b> - both <code>Jacoco</code> and <code>Cobertura</code>
are supported. These can be independently enabled.
</li>
<li>
- <b><a href="#Source_Compatibility">Source Compatibility</a></b> - both <tt>japicmp</tt> and <tt>clirr</tt>
+ <b><a href="#Source_Compatibility">Source Compatibility</a></b> - both <code>japicmp</code> and <code>clirr</code>
are supported. These can be independently enabled.
</li>
</ul>
- </div>
+ </section>
-
-<div class="section">
+ <section>
<h3><a name="Release"></a>Release</h3>
<p>
@@ -406,26 +391,25 @@
<commons.release.isDistModule>true</commons.release.isDistModule>
<commons.distSvnStagingUrl>scm:svn:https://dist.apache.org/repos/dist/dev/commons/foo</commons.distSvnStagingUrl>
</properties></pre></div>
- where <tt>foo</tt> represents our component. Furthermore, during a release build, we ask that the svn
+ where <code>foo</code> represents our component. Furthermore, during a release build, we ask that the svn
folder be empty. We then generate our release build by runnning:
<div>
<pre>
mvn -Duser.name=${my_apache_id} -Prelease -Ptest-deploy clean package site deploy</pre></div>
to test our deployment. Note, all of the staged items end up in
- <tt>target/commons-release-plugin/scm</tt>. And, to perform a full release, we run:
+ <code>target/commons-release-plugin/scm</code>. And, to perform a full release, we run:
<div>
<pre>
mvn -Duser.name=${my_apache_id} -Prelease clean package site deploy</pre></div>
Using the release plugin should build and stage the non-assembly built artifacts to Nexus, and stage
- the assemblies to the svn location along with the site and the <tt>RELEASE-NOTES.txt</tt> from the
+ the assemblies to the svn location along with the site and the <code>RELEASE-NOTES.txt</code> from the
root of the project.
- </div>
+ </section>
-
-<div class="section">
+ <section>
<h3><a name="Site_Generation"></a>Site Generation</h3>
<p>
@@ -443,10 +427,10 @@ mvn -Duser.name=${my_apache_id} -Preleas
<ul>
<li><b>Menu/Navigation</b> - The menu and breadcrumb options specified in the commons-parent's
- <tt>site.xml</tt> are included in the component's site.
+ <code>site.xml</code> are included in the component's site.
</li>
-<li><b>Style</b> - The commons-parent's <tt>site.xml</tt> specifies the
+<li><b>Style</b> - The commons-parent's <code>site.xml</code> specifies the
<a class="externalLink" href="https://github.com/apache/commons-skin">commons-skin</a>
so that component's sites use a standard style and commons logo.
</li>
@@ -476,8 +460,8 @@ mvn -Duser.name=${my_apache_id} -Preleas
</li>
<li><b><a class="externalLink" href="https://siom79.github.io/japicmp/">Japicmp</a> Report</b> - reports are only generated when a jar file has been produced
- by the build, so <tt>mvn clean site</tt> will produce an empty japicmp report, whereas
- <tt>mvn clean package site</tt> will produce a full report. Furthermore, in building pom
+ by the build, so <code>mvn clean site</code> will produce an empty japicmp report, whereas
+ <code>mvn clean package site</code> will produce a full report. Furthermore, in building pom
only modules, japicmp has a tendency to print out a stacktrace under the pretense of a warning
because it does not understand how to properly skip such a module.
</li>
@@ -487,36 +471,36 @@ mvn -Duser.name=${my_apache_id} -Preleas
<li><b>Javadocs</b></li>
<li><b>Source Cross Reference</b></li>
- The pom excludes Maven defaults such as the <tt>license</tt> report which is against the ASF branding rules.
+ The pom excludes Maven defaults such as the <code>license</code> report which is against the ASF branding rules.
The following are currently included by default (components can add extra ones if they wish, but cannot remove them).
<ul>
-<li><tt>index</tt></li>
+<li><code>index</code></li>
-<li><tt>summary</tt></li>
+<li><code>summary</code></li>
-<li><tt>modules</tt></li>
+<li><code>modules</code></li>
-<li><tt>project-team</tt></li>
+<li><code>project-team</code></li>
-<li><tt>scm</tt></li>
+<li><code>scm</code></li>
-<li><tt>issue-tracking</tt></li>
+<li><code>issue-tracking</code></li>
-<li><tt>mailing-list</tt></li>
+<li><code>mailing-list</code></li>
-<li><tt>dependency-info</tt></li>
+<li><code>dependency-info</code></li>
-<li><tt>dependency-management</tt></li>
+<li><code>dependency-management</code></li>
-<li><tt>dependencies</tt></li>
+<li><code>dependencies</code></li>
-<li><tt>dependency-convergence</tt></li>
+<li><code>dependency-convergence</code></li>
-<li><tt>cim</tt></li>
+<li><code>cim</code></li>
-<li><tt>distribution-management</tt></li>
+<li><code>distribution-management</code></li>
</ul>
</ul>
</li>
@@ -537,29 +521,27 @@ mvn -Duser.name=${my_apache_id} -Preleas
for details of how to configure the component's pom and generate the page.
</li>
</ul>
- </div>
+ </section>
- </div>
+ </section>
-
-<div class="section">
+ <section>
<h2><a name="Java_Version"></a>Java Version</h2>
-
-<div class="section">
-<h3><a name="Configuring_the_Java_SourceTarget_options"></a>Configuring the Java Source/Target options</h3>
+ <section>
+<h3><a name="Configuring_the_Java_Source.2FTarget_options"></a>Configuring the Java Source/Target options</h3>
<p>
<a class="externalLink" href="https://github.com/apache/commons-parent/blob/master/pom.xml">commons-parent</a>
- configures the <tt>source</tt> and <tt>target</tt> options in the
+ configures the <code>source</code> and <code>target</code> options in the
<a class="externalLink" href="http://maven.apache.org/plugins/maven-compiler-plugin/">maven-compiler-plugin</a> to use the
- <tt>${maven.compiler.source}</tt> and <tt>${maven.compiler.target}</tt> properties
+ <code>${maven.compiler.source}</code> and <code>${maven.compiler.target}</code> properties
respectively.
</p>
<p>
So, for example, to configure a component to have <i>source/target</i> set to <i>1.4</i> add the following
- lines to the component's <tt>pom.xml</tt>:
+ lines to the component's <code>pom.xml</code>:
</p>
<div class="source">
@@ -570,22 +552,21 @@ mvn -Duser.name=${my_apache_id} -Preleas
</properties>
</pre></div>
<b>NOTE:</b> the Maven compiler plugin defaults to using the properties
- <tt>${maven.compiler.source}</tt> and <tt>${maven.compiler.target}</tt>; however the
+ <code>${maven.compiler.source}</code> and <code>${maven.compiler.target}</code>; however the
Commons Parent POM originally incorrectly used ".compile." rather than ".compiler."
This was fixed in version 31 of the Commons Parent pom.
See https://issues.apache.org/jira/browse/COMMONSSITE-69
- </div>
+ </section>
-
-<div class="section">
+ <section>
<h3><a name="MANIFEST.MF"></a>MANIFEST.MF</h3>
<p>
In order to help check what source/target options were used when building a release, the property values used to
configure the <i>source/target</i> options in the
<a class="externalLink" href="http://maven.apache.org/plugins/maven-compiler-plugin/">maven-compiler-plugin</a>
- (i.e. <tt>${maven.compiler.source}</tt> and <tt>${maven.compiler.target}</tt>) are also written
- out to the component jar's <tt>MANIFEST.MF</tt> file with the following header names:
+ (i.e. <code>${maven.compiler.source}</code> and <code>${maven.compiler.target}</code>) are also written
+ out to the component jar's <code>MANIFEST.MF</code> file with the following header names:
</p>
<div class="source">
@@ -593,14 +574,13 @@ mvn -Duser.name=${my_apache_id} -Preleas
X-Compile-Source-JDK:
X-Compile-Target-JDK:
</pre></div>
- </div>
+ </section>
-
-<div class="section">
+ <section>
<h3><a name="Testing_with_different_Java_versions"></a>Testing with different Java versions</h3>
<p>
- Using the <i>target</i> option ensures that the <tt>.class</tt> file format is compatible with
+ Using the <i>target</i> option ensures that the <code>.class</code> file format is compatible with
the required Java version - but it does not prevent/catch the use of methods/classes which were
introduced in later Java versions (this is because the build will use the current Java libraries by default).
One way to ensure that components don't accidentally use classes/methods from a later
@@ -616,39 +596,39 @@ mvn -Duser.name=${my_apache_id} -Preleas
<ul>
-<li><tt>java-1.3</tt> for compiling and testing using Java 1.3 (uses property JAVA_1_3_HOME)</li>
+<li><code>java-1.3</code> for compiling and testing using Java 1.3 (uses property JAVA_1_3_HOME)</li>
-<li><tt>java-1.4</tt> for compiling and testing using Java 1.4 (uses property JAVA_1_4_HOME)</li>
+<li><code>java-1.4</code> for compiling and testing using Java 1.4 (uses property JAVA_1_4_HOME)</li>
-<li><tt>java-1.5</tt> for compiling and testing using Java 1.5 (uses property JAVA_1_5_HOME)</li>
+<li><code>java-1.5</code> for compiling and testing using Java 1.5 (uses property JAVA_1_5_HOME)</li>
-<li><tt>java-1.6</tt> for compiling and testing using Java 1.6 (uses property JAVA_1_6_HOME)</li>
+<li><code>java-1.6</code> for compiling and testing using Java 1.6 (uses property JAVA_1_6_HOME)</li>
-<li><tt>java-1.7</tt> for compiling and testing using Java 1.7 (uses property JAVA_1_7_HOME)</li>
+<li><code>java-1.7</code> for compiling and testing using Java 1.7 (uses property JAVA_1_7_HOME)</li>
-<li><tt>java-1.8</tt> for compiling and testing using Java 1.8 (uses property JAVA_1_8_HOME)</li>
+<li><code>java-1.8</code> for compiling and testing using Java 1.8 (uses property JAVA_1_8_HOME)</li>
-<li><tt>java-1.9</tt> for compiling and testing using Java 1.9 (uses property JAVA_1_9_HOME)</li>
+<li><code>java-1.9</code> for compiling and testing using Java 1.9 (uses property JAVA_1_9_HOME)</li>
</ul>
<p>
- In order for these profiles to work, you need to configure the relevant <tt>JAVA_1_N_HOME</tt>
- properties in your <tt>settings.xml</tt> file.
+ In order for these profiles to work, you need to configure the relevant <code>JAVA_1_N_HOME</code>
+ properties in your <code>settings.xml</code> file.
[There is no need to configure properties for profiles you don't need.]
- Each property should be set to the <tt>directory</tt> where the relevant version of the JDK is installed.
+ Each property should be set to the <code>directory</code> where the relevant version of the JDK is installed.
Note: the Maven compiler plugin has
<a class="externalLink" href="http://maven.apache.org/plugins/maven-compiler-plugin/examples/compile-using-different-jdk.html">documentation on how this works</a>.
</p>
<p>
<b>Note:</b> the <a class="externalLink" href="http://felix.apache.org/site/apache-felix-maven-bundle-plugin-bnd.html">maven-bundle-plugin</a>
- outputs all property values which start with a capital letter as headers to the jar's <tt>MANIFEST.MF</tt> file.
+ outputs all property values which start with a capital letter as headers to the jar's <code>MANIFEST.MF</code> file.
The commons-parent pom uses the <_removeheaders> instruction to suppress the specific JAVA_* properties used by the pom.
</p>
<p>
To ensure that the properties are only present if they are actually needed, you can
- define the property in the relevant profile in your <tt>settings.xml</tt>, for example:
+ define the property in the relevant profile in your <code>settings.xml</code>, for example:
</p>
<div class="source">
@@ -714,34 +694,31 @@ mvn -Duser.name=${my_apache_id} -Preleas
<pre>
mvn clean test -Pjava-1.6 -DJAVA_1_6_HOME=/home/jenkins/tools/java/latest1.6
</pre></div>
- </div>
+ </section>
- </div>
+ </section>
-
-<div class="section">
+ <section>
<h2><a name="OSGi_Information"></a>OSGi Information</h2>
-
-<div class="section">
+ <section>
<h3><a name="OSGi_Metadata"></a>OSGi Metadata</h3>
<p>
In order to use a Commons component (or any libaray) in an
<a class="externalLink" href="http://www.osgi.org/">OSGi</a> container (for example
<a class="externalLink" href="http://felix.apache.org/">Apache Felix</a>) then OSGi
- <i>metadata</i> needs to be included in the <tt>MANIFEST.MF</tt>
+ <i>metadata</i> needs to be included in the <code>MANIFEST.MF</code>
file of the component's <i>jar</i>.
</p>
- </div>
+ </section>
-
-<div class="section">
+ <section>
<h3><a name="Generating_the_OSGi_Metadata"></a>Generating the OSGi Metadata</h3>
<p>
<a class="externalLink" href="https://github.com/apache/commons-parent/blob/master/pom.xml">commons-parent</a>
- is configured to automatically add the OSGi <i>metadata</i> to the component jar's <tt>MANIFEST.MF</tt>
+ is configured to automatically add the OSGi <i>metadata</i> to the component jar's <code>MANIFEST.MF</code>
using the <a class="externalLink" href="http://felix.apache.org/site/apache-felix-maven-bundle-plugin-bnd.html">
maven-bundle-plugin</a> when the <i>package</i> phase is executed:
</p>
@@ -752,8 +729,8 @@ mvn -Duser.name=${my_apache_id} -Preleas
<p>
- Most components only need to configure the <tt><commons.componentid></tt>
- property in their <tt>pom.xml</tt> in the following way:
+ Most components only need to configure the <code><commons.componentid></code>
+ property in their <code>pom.xml</code> in the following way:
</p>
@@ -764,46 +741,44 @@ mvn -Duser.name=${my_apache_id} -Preleas
</properties>
</pre></div>
- </div>
+ </section>
-
-<div class="section">
+ <section>
<h3><a name="Custom_OSGi_configuration"></a>Custom OSGi configuration</h3>
<p>
There are a number of other <i>OSGi</i> properties in the commons-parent
- <tt>pom.xml</tt> which are used to configure the <tt>maven-bundle-plugin</tt>.
+ <code>pom.xml</code> which are used to configure the <code>maven-bundle-plugin</code>.
These have sensible defaults, but can be <i>overriden</i> in a component's
- <tt>pom.xml</tt> if required. These are:
+ <code>pom.xml</code> if required. These are:
</p>
<ul>
-<li>The <b><tt><commons.osgi.symbolicName></tt></b> property configures the
- <b><tt><Bundle-SymbolicName></tt></b> instruction</li>
+<li>The <b><code><commons.osgi.symbolicName></code></b> property configures the
+ <b><code><Bundle-SymbolicName></code></b> instruction</li>
-<li>The <b><tt><commons.osgi.export></tt></b> property configures the
- <b><tt><Export-Package></tt></b> instruction</li>
+<li>The <b><code><commons.osgi.export></code></b> property configures the
+ <b><code><Export-Package></code></b> instruction</li>
-<li>The <b><tt><commons.osgi.private></tt></b> property configures the
- <b><tt><Private-Package></tt></b> instruction</li>
+<li>The <b><code><commons.osgi.private></code></b> property configures the
+ <b><code><Private-Package></code></b> instruction</li>
-<li>The <b><tt><commons.osgi.import></tt></b> property configures the
- <b><tt><Import-Package></tt></b> instruction</li>
+<li>The <b><code><commons.osgi.import></code></b> property configures the
+ <b><code><Import-Package></code></b> instruction</li>
-<li>The <b><tt><commons.osgi.dynamicImport></tt></b> property configures the
- <b><tt><DynamicImport-Package></tt></b> instruction</li>
+<li>The <b><code><commons.osgi.dynamicImport></code></b> property configures the
+ <b><code><DynamicImport-Package></code></b> instruction</li>
-<li>The <b><tt><commons.osgi.excludeDependencies></tt></b> should be set to
+<li>The <b><code><commons.osgi.excludeDependencies></code></b> should be set to
false if the bundle plugin should be able to scan dependency versions and the optional
attribute.</li>
</ul>
- </div>
+ </section>
- </div>
+ </section>
-
-<div class="section">
+ <section>
<h2><a name="Properties"></a>Properties</h2>
@@ -813,8 +788,7 @@ mvn -Duser.name=${my_apache_id} -Preleas
property - for example if a new version of a plugin has been released, and the parent POM has not yet been updated.
</p>
-
-<div class="section">
+ <section>
<h3><a name="Overriding_properties"></a>Overriding properties</h3>
<p>
@@ -825,10 +799,9 @@ mvn -Duser.name=${my_apache_id} -Preleas
This works best for temporary overrides. For more permanent overrides, just add the new property definition to the
component POM. Please ensure the override is commented, so it can be removed when no longer necessary.
- </div>
+ </section>
-
-<div class="section">
+ <section>
<h3><a name="Version_properties"></a>Version properties</h3>
<p>
@@ -836,10 +809,9 @@ mvn -Duser.name=${my_apache_id} -Preleas
For example, commons.rat.version defines the version of Apache RAT.
Please see the POM for the list. [The properties are currently located at the end of the POM.]
</p>
- </div>
+ </section>
-
-<div class="section">
+ <section>
<h3><a name="Configuration_properties"></a>Configuration properties</h3>
<p>
@@ -860,16 +832,14 @@ mvn -Duser.name=${my_apache_id} -Preleas
<li>commons.changes.runOnlyAtExecutionRoot - (default false) override this to cause the changes report to be run at execution root only</li>
</ul>
- </div>
+ </section>
- </div>
+ </section>
-
-<div class="section">
+ <section>
<h2><a name="Profiles"></a>Profiles</h2>
-
-<div class="section">
+ <section>
<h3><a name="Java_profiles"></a>Java profiles</h3>
<p>
@@ -877,36 +847,33 @@ mvn -Duser.name=${my_apache_id} -Preleas
contains some java profiles to compile/test using different versions of Java.
See <a href="#Testing_with_different_Java_versions">here</a> for details of using the Java profiles.
</p>
- </div>
+ </section>
-
-<div class="section">
+ <section>
<h3><a name="jacoco_profile"></a>jacoco profile</h3>
<p>
Enable this profile to run the Jacoco tool.
This requires at least Java 1.5.
The profile is not enabled by default.
- If the file <tt>src/site/resources/profile.jacoco</tt> exists then the profile is enabled.
+ If the file <code>src/site/resources/profile.jacoco</code> exists then the profile is enabled.
This allows components to always enable the profile
</p>
- </div>
+ </section>
-
-<div class="section">
+ <section>
<h3><a name="cobertura_profile"></a>cobertura profile</h3>
<p>
Enable this profile to run the Cobertura tool.
The profile is not enabled by default.
- If the file <tt>src/site/resources/profile.cobertura</tt> exists then the profile is enabled.
+ If the file <code>src/site/resources/profile.cobertura</code> exists then the profile is enabled.
This allows components to always enable the profile
</p>
- </div>
+ </section>
-
-<div class="section">
-<h3><a name="japicmp_profile_since_CP41"></a>japicmp profile (since CP41)</h3>
+ <section>
+<h3><a name="japicmp_profile_.28since_CP41.29"></a>japicmp profile (since CP41)</h3>
<p>
Enable this profile to run the japicmp cmp goal during the verify phase.
@@ -914,26 +881,24 @@ mvn -Duser.name=${my_apache_id} -Preleas
This profile will also generate a source compatibilty report during the site lifecycle.
This plugin requires building with at least Java 1.7. (source and target can be lower versions)
The profile is not enabled by default.
- If the file <tt>src/site/resources/profile.japicmp</tt> exists then the profile is enabled.
+ If the file <code>src/site/resources/profile.japicmp</code> exists then the profile is enabled.
This allows components to always enable the profile
</p>
- </div>
+ </section>
-
-<div class="section">
-<h3><a name="clirr_profile_since_CP41"></a>clirr profile (since CP41)</h3>
+ <section>
+<h3><a name="clirr_profile_.28since_CP41.29"></a>clirr profile (since CP41)</h3>
<p>
Enable this profile to generate the clirr report during the site lifecycle.
The profile is not enabled by default.
- If the file <tt>src/site/resources/profile.clirr</tt> exists then the profile is enabled.
+ If the file <code>src/site/resources/profile.clirr</code> exists then the profile is enabled.
This allows components to always enable the profile
</p>
- </div>
+ </section>
-
-<div class="section">
-<h3><a name="site-basic_profile_since_CP37"></a>site-basic profile (since CP37)</h3>
+ <section>
+<h3><a name="site-basic_profile_.28since_CP37.29"></a>site-basic profile (since CP37)</h3>
<p>
This profile disables as many of the optional reports as it can.
@@ -956,13 +921,12 @@ mvn -Duser.name=${my_apache_id} -Preleas
<p>
Individual reports can be re-enabled as follows:
- <tt>mvn site -Psite-basic -Dclirr.skip=false</tt>
+ <code>mvn site -Psite-basic -Dclirr.skip=false</code>
</p>
- </div>
+ </section>
-
-<div class="section">
-<h3><a name="animal-sniffer_profile_since_CP37"></a>animal-sniffer profile (since CP37)</h3>
+ <section>
+<h3><a name="animal-sniffer_profile_.28since_CP37.29"></a>animal-sniffer profile (since CP37)</h3>
<p>
This profile is enabled by default. It runs the Animal Sniffer plugin on the main code during the "process-classes" phase.
@@ -973,33 +937,32 @@ mvn -Duser.name=${my_apache_id} -Preleas
</p>
<p>
- The plugin can be temporarily disabled by using the command-line option <tt>-Danimal.sniffer.skip</tt>.
- It can be completely disabled for a component (not recommended) by creating an empty file: <tt>src/site/resources/profile.noanimal</tt>
+ The plugin can be temporarily disabled by using the command-line option <code>-Danimal.sniffer.skip</code>.
+ It can be completely disabled for a component (not recommended) by creating an empty file: <code>src/site/resources/profile.noanimal</code>
</p>
<p>
- The profile creates the property <tt>animal-sniffer.signature</tt> (e.g. java16)
- from the property <tt>maven.compiler.target</tt> (e.g. 1.6). For temporary testing purposes, the
- property <tt>animal-sniffer.signature</tt> can be overridden on the command-line.
- The configuration for the plugin defines the signature version using the property <tt>commons.animal-sniffer.signature.version</tt>.
- This is defined with the value of <tt>1.0</tt> as almost all signatures are released with that version.
+ The profile creates the property <code>animal-sniffer.signature</code> (e.g. java16)
+ from the property <code>maven.compiler.target</code> (e.g. 1.6). For temporary testing purposes, the
+ property <code>animal-sniffer.signature</code> can be overridden on the command-line.
+ The configuration for the plugin defines the signature version using the property <code>commons.animal-sniffer.signature.version</code>.
+ This is defined with the value of <code>1.0</code> as almost all signatures are released with that version.
If necessary, the property can be overridden on the command line or in the component POM.
[For example, the java16 signature comes in 2 versions].
The Codehaus website has documentation on the <a class="externalLink" href="http://mojo.codehaus.org/signatures/">available signatures</a>
</p>
<p>
- A simple way to run the check is as follows <tt>mvn process-classes</tt>
+ A simple way to run the check is as follows <code>mvn process-classes</code>
</p>
- </div>
+ </section>
-
-<div class="section">
+ <section>
<h3><a name="release_profile"></a>release profile</h3>
<p>
<a class="externalLink" href="https://github.com/apache/commons-parent/blob/master/pom.xml">commons-parent</a>
- contains a <tt>release</tt> profile for producing <i>releases</i>.
+ contains a <code>release</code> profile for producing <i>releases</i>.
</p>
@@ -1020,18 +983,17 @@ mvn -Duser.name=${my_apache_id} -Preleas
<p>
- You can also combine the <tt>-Prelease</tt> option with <tt>deploy</tt> target and the <tt>-Ptest-deploy</tt>
+ You can also combine the <code>-Prelease</code> option with <code>deploy</code> target and the <code>-Ptest-deploy</code>
profile to simulate staging to the repository.
</p>
- </div>
+ </section>
-
-<div class="section">
+ <section>
<h3><a name="release-notes_profile"></a>release-notes profile</h3>
<p>
- This uses the <tt>src/changes.xml</tt> file to generate the file <tt>RELEASE-NOTES.txt</tt>.
- Requires file <tt>src/changes/release-notes.vm</tt>.
+ This uses the <code>src/changes.xml</code> file to generate the file <code>RELEASE-NOTES.txt</code>.
+ Requires file <code>src/changes/release-notes.vm</code>.
A sample template is available from:
https://github.com/apache/commons-parent/blob/master/src/changes/release-notes.vm
</p>
@@ -1043,20 +1005,18 @@ mvn -Duser.name=${my_apache_id} -Preleas
<p>
Defining changes.version allows one to create the RN without first removing the SNAPSHOT suffix from the POM.
</p>
- </div>
+ </section>
-
-<div class="section">
+ <section>
<h3><a name="javasvn_profile"></a>javasvn profile</h3>
<p>
Optional profile to use javasvn instead of the SVN CLI for the buildNumber plugin
</p>
- </div>
+ </section>
-
-<div class="section">
-<h3><a name="Other_profiles_not_intended_for_direct_use"></a>Other profiles, not intended for direct use</h3>
+ <section>
+<h3><a name="Other_profiles.2C_not_intended_for_direct_use"></a>Other profiles, not intended for direct use</h3>
<p>
The pom also includes some helper profiles that are automatically enabled as needed
@@ -1064,17 +1024,17 @@ mvn -Duser.name=${my_apache_id} -Preleas
<ul>
-<li><tt>jdk7-plugin-fix-version</tt> - updates plugin versions for use under JDK7 (currently Findbugs and Animal Sniffer)</li>
+<li><code>jdk7-plugin-fix-version</code> - updates plugin versions for use under JDK7 (currently Findbugs and Animal Sniffer)</li>
-<li><tt>svn-buildnumber</tt> - adds the build number to the manifests; suppress with <tt>-Dbuildnumber.skip</tt></li>
+<li><code>svn-buildnumber</code> - adds the build number to the manifests; suppress with <code>-Dbuildnumber.skip</code></li>
-<li><tt>parse-target-version</tt> - parses maven.compiler.target into javaTarget.[majorVersion|minorVersion|etc]
+<li><code>parse-target-version</code> - parses maven.compiler.target into javaTarget.[majorVersion|minorVersion|etc]
using the <a class="externalLink" href="https://www.mojohaus.org/build-helper-maven-plugin/parse-version-mojo.html">build-helper:parse-version</a> goal</li>
</ul>
- </div>
+ </section>
- </div>
+ </section>
@@ -1087,7 +1047,7 @@ mvn -Duser.name=${my_apache_id} -Preleas
<p>Copyright © 2020
<a href="https://www.apache.org/">The Apache Software Foundation</a>.
All Rights Reserved.</p>
-
+ <?xml version="1.0" encoding="UTF-8"?>
<div class="center">Apache Commons, Apache, the Apache feather logo, and the Apache Commons project logos are trademarks of The Apache Software Foundation.
All other marks mentioned may be trademarks or registered trademarks of their respective owners.</div>
</div>
Modified: websites/staging/commons/trunk/content/components.html
==============================================================================
--- websites/staging/commons/trunk/content/components.html (original)
+++ websites/staging/commons/trunk/content/components.html Fri Aug 7 12:14:11 2020
@@ -1,6 +1,6 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia at 26 July 2020
+ | Generated by Apache Maven Doxia at 07 August 2020
| Rendered using Apache Maven Fluido Skin 1.3.0
-->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
@@ -8,7 +8,7 @@
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta name="author" content="Commons Documentation Team" />
- <meta name="Date-Revision-yyyymmdd" content="20200726" />
+ <meta name="Date-Revision-yyyymmdd" content="20200807" />
<meta http-equiv="Content-Language" content="en" />
<title>Apache Commons – Components</title>
@@ -25,7 +25,7 @@
</head>
<body class="composite">
- <a href="./" id="bannerLeft" title="Apache Commons logo">
+ <a href="http://commons.apache.org/" id="bannerLeft" title="Apache Commons logo">
<img class="logo-left" src="images/commons-logo.png" alt="Apache Commons logo"/>
</a>
<div class="clear"></div>
@@ -33,11 +33,11 @@
<div class="navbar">
<div class="navbar-inner">
<div class="container-fluid">
- <a class="brand" href="http://commons.apache.org/">Apache Commons ™</a>
+ <a class="brand" href="https://commons.apache.org/">Apache Commons ™</a>
<ul class="nav">
- <li id="publishDate">Last Published: 26 July 2020</li>
- <li class="divider">|</li> <li id="projectVersion">Version: 19</li>
+ <li id="publishDate">Last Published: 07 August 2020</li>
+ <li class="divider">|</li> <li id="projectVersion">Version: 23</li>
</ul>
<div class="pull-right"> <ul class="nav">
<li class="active">
@@ -86,7 +86,7 @@
Mailing Lists</a>
</li>
<li class="none">
- <a href="team-list.html" title="PMC">
+ <a href="team.html" title="PMC">
PMC</a>
</li>
<li class="expanded active">
@@ -375,23 +375,10 @@
</div>
</td>
<td class="content">
- <!-- Licensed to the Apache Software Foundation (ASF) under one or more
- contributor license agreements. See the NOTICE file distributed with
- this work for additional information regarding copyright ownership.
- The ASF licenses this file to You under the Apache License, Version 2.0
- (the "License"); you may not use this file except in compliance with
- the License. You may obtain a copy of the License at
-
- http://www.apache.org/licenses/LICENSE-2.0
-
- Unless required by applicable law or agreed to in writing, software
- distributed under the License is distributed on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- See the License for the specific language governing permissions and
- limitations under the License. -->
+
- <div class="section">
+ <section>
<h2><a name="Introduction"></a>Introduction</h2>
<p>
@@ -400,14 +387,13 @@
released packages. This page provides an overview of the
<i>Commons</i> components that are currently available.
</p>
- </div>
+ </section>
-
-<div class="section">
+ <section>
<h2><a name="Released_Components"></a>Released Components</h2>
<table border="0" class="bodyTable">
- <!-- This list should agree with ../site.xml and index.xml and downloads/index.xml -->
+
<tr class="a">
<th>Components</th>
@@ -623,10 +609,9 @@
<td>Provides an easy way to enhance (weave) compiled bytecode.</td></tr>
</table>
- </div>
+ </section>
-
-<div class="section">
+ <section>
<h2><a name="Elsewhere_at_Apache"></a>Elsewhere at Apache</h2>
<p>
@@ -664,7 +649,7 @@
</ul>
- </div>
+ </section>
@@ -677,7 +662,7 @@
<p>Copyright © 2020
<a href="https://www.apache.org/">The Apache Software Foundation</a>.
All Rights Reserved.</p>
-
+ <?xml version="1.0" encoding="UTF-8"?>
<div class="center">Apache Commons, Apache, the Apache feather logo, and the Apache Commons project logos are trademarks of The Apache Software Foundation.
All other marks mentioned may be trademarks or registered trademarks of their respective owners.</div>
</div>
Modified: websites/staging/commons/trunk/content/dormant.html
==============================================================================
--- websites/staging/commons/trunk/content/dormant.html (original)
+++ websites/staging/commons/trunk/content/dormant.html Fri Aug 7 12:14:11 2020
@@ -1,6 +1,6 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia at 26 July 2020
+ | Generated by Apache Maven Doxia at 07 August 2020
| Rendered using Apache Maven Fluido Skin 1.3.0
-->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
@@ -8,7 +8,7 @@
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta name="author" content="Commons Documentation Team" />
- <meta name="Date-Revision-yyyymmdd" content="20200726" />
+ <meta name="Date-Revision-yyyymmdd" content="20200807" />
<meta http-equiv="Content-Language" content="en" />
<title>Apache Commons – Dormant</title>
@@ -25,7 +25,7 @@
</head>
<body class="composite">
- <a href="./" id="bannerLeft" title="Apache Commons logo">
+ <a href="http://commons.apache.org/" id="bannerLeft" title="Apache Commons logo">
<img class="logo-left" src="images/commons-logo.png" alt="Apache Commons logo"/>
</a>
<div class="clear"></div>
@@ -33,11 +33,11 @@
<div class="navbar">
<div class="navbar-inner">
<div class="container-fluid">
- <a class="brand" href="http://commons.apache.org/">Apache Commons ™</a>
+ <a class="brand" href="https://commons.apache.org/">Apache Commons ™</a>
<ul class="nav">
- <li id="publishDate">Last Published: 26 July 2020</li>
- <li class="divider">|</li> <li id="projectVersion">Version: 19</li>
+ <li id="publishDate">Last Published: 07 August 2020</li>
+ <li class="divider">|</li> <li id="projectVersion">Version: 23</li>
</ul>
<div class="pull-right"> <ul class="nav">
<li>
@@ -86,7 +86,7 @@
Mailing Lists</a>
</li>
<li class="none">
- <a href="team-list.html" title="PMC">
+ <a href="team.html" title="PMC">
PMC</a>
</li>
<li class="collapsed">
@@ -299,22 +299,9 @@
</div>
</td>
<td class="content">
- <!-- Licensed to the Apache Software Foundation (ASF) under one or more
- contributor license agreements. See the NOTICE file distributed with
- this work for additional information regarding copyright ownership.
- The ASF licenses this file to You under the Apache License, Version 2.0
- (the "License"); you may not use this file except in compliance with
- the License. You may obtain a copy of the License at
-
- http://www.apache.org/licenses/LICENSE-2.0
-
- Unless required by applicable law or agreed to in writing, software
- distributed under the License is distributed on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- See the License for the specific language governing permissions and
- limitations under the License. -->
+
- <div class="section">
+ <section>
<h2><a name="The_Apache_Commons_Dormant"></a>The Apache Commons Dormant</h2>
<p>
@@ -332,7 +319,7 @@
<table border="0" class="bodyTable">
- <!-- This list should agree with ../../site.xml -->
+
<tr class="a">
<th>Dormant</th>
@@ -454,10 +441,9 @@
<td>Simple and fast importer for XML configuration or import files.</td></tr>
</table>
- </div>
+ </section>
-
-<div class="section">
+ <section>
<h2><a name="Revival_of_the_Dormant_Components"></a>Revival of the Dormant Components</h2>
<p>
@@ -474,7 +460,7 @@
developers mailing list</a>.
</p>
- </div>
+ </section>
@@ -487,7 +473,7 @@
<p>Copyright © 2020
<a href="https://www.apache.org/">The Apache Software Foundation</a>.
All Rights Reserved.</p>
-
+ <?xml version="1.0" encoding="UTF-8"?>
<div class="center">Apache Commons, Apache, the Apache feather logo, and the Apache Commons project logos are trademarks of The Apache Software Foundation.
All other marks mentioned may be trademarks or registered trademarks of their respective owners.</div>
</div>
Modified: websites/staging/commons/trunk/content/downloads/index.html
==============================================================================
--- websites/staging/commons/trunk/content/downloads/index.html (original)
+++ websites/staging/commons/trunk/content/downloads/index.html Fri Aug 7 12:14:11 2020
@@ -1,6 +1,6 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia at 26 July 2020
+ | Generated by Apache Maven Doxia at 07 August 2020
| Rendered using Apache Maven Fluido Skin 1.3.0
-->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
@@ -8,7 +8,7 @@
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta name="author" content="Commons Documentation Team" />
- <meta name="Date-Revision-yyyymmdd" content="20200726" />
+ <meta name="Date-Revision-yyyymmdd" content="20200807" />
<meta http-equiv="Content-Language" content="en" />
<title>Apache Commons – Apache Commons</title>
@@ -25,7 +25,7 @@
</head>
<body class="composite">
- <a href=".././" id="bannerLeft" title="Apache Commons logo">
+ <a href="http://commons.apache.org/" id="bannerLeft" title="Apache Commons logo">
<img class="logo-left" src="../images/commons-logo.png" alt="Apache Commons logo"/>
</a>
<div class="clear"></div>
@@ -33,11 +33,11 @@
<div class="navbar">
<div class="navbar-inner">
<div class="container-fluid">
- <a class="brand" href="http://commons.apache.org/">Apache Commons ™</a>
+ <a class="brand" href="https://commons.apache.org/">Apache Commons ™</a>
<ul class="nav">
- <li id="publishDate">Last Published: 26 July 2020</li>
- <li class="divider">|</li> <li id="projectVersion">Version: 19</li>
+ <li id="publishDate">Last Published: 07 August 2020</li>
+ <li class="divider">|</li> <li id="projectVersion">Version: 23</li>
</ul>
<div class="pull-right"> <ul class="nav">
<li>
@@ -86,7 +86,7 @@
Mailing Lists</a>
</li>
<li class="none">
- <a href="../team-list.html" title="PMC">
+ <a href="../team.html" title="PMC">
PMC</a>
</li>
<li class="collapsed">
@@ -205,21 +205,9 @@
</div>
</td>
<td class="content">
- <!-- Licensed to the Apache Software Foundation (ASF) under one or more
- contributor license agreements. See the NOTICE file distributed with
- this work for additional information regarding copyright ownership.
- The ASF licenses this file to You under the Apache License, Version
- 2.0 (the "License"); you may not use this file except in compliance
- with the License. You may obtain a copy of the License at
-
- http://www.apache.org/licenses/LICENSE-2.0 Unless required by
- applicable law or agreed to in writing, software distributed under
- the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES
- OR CONDITIONS OF ANY KIND, either express or implied. See the
- License for the specific language governing permissions and
- limitations under the License. -->
+
- <div class="section">
+ <section>
<h2><a name="Downloads"></a>Downloads</h2>
<p>
@@ -228,8 +216,7 @@
may be obtained by selecting a project below
</p>
-
-<div class="section">
+ <section>
<h3><a name="Release_Announcements"></a>Release Announcements</h3>
<p>
@@ -238,21 +225,14 @@
mailing list to be notified when releases are made by the Commons project.
Releases are also announced to the User and Developer lists.
</p>
- </div>
+ </section>
-
-<div class="section">
+ <section>
<h3><a name="Downloads"></a>Downloads</h3>
- <!-- Should agree with list in ../../site.xml and ../index.xml and ../components.xml -->
+
<ul>
- <!-- N.B. This list used to use URLs of the form "../csv/download_csv.cgi"
- These were then redirected to the actual location, i.e. "/proper/commons-csv/download_csv.cgi"
- Unfortunately the additional redirect that had to be put in place for the change to the LUA
- version of the mirrors CGI script causes page rendering to break.
- The list now uses the redirected locations.
- Note: the redirect issue only affects the rendering of the HTML pages that are associated with the CGI scripts.
- It does not affect other references -->
+
<li><a href="/proper/commons-bcel/download_bcel.cgi">BCEL</a></li>
@@ -328,9 +308,9 @@
<li><a href="/proper/commons-vfs/download_vfs.cgi">VFS</a></li>
</ul>
- </div>
+ </section>
- </div>
+ </section>
</td>
@@ -342,7 +322,7 @@
<p>Copyright © 2020
<a href="https://www.apache.org/">The Apache Software Foundation</a>.
All Rights Reserved.</p>
-
+ <?xml version="1.0" encoding="UTF-8"?>
<div class="center">Apache Commons, Apache, the Apache feather logo, and the Apache Commons project logos are trademarks of The Apache Software Foundation.
All other marks mentioned may be trademarks or registered trademarks of their respective owners.</div>
</div>
Modified: websites/staging/commons/trunk/content/gsoc/2010/index.html
==============================================================================
--- websites/staging/commons/trunk/content/gsoc/2010/index.html (original)
+++ websites/staging/commons/trunk/content/gsoc/2010/index.html Fri Aug 7 12:14:11 2020
@@ -1,6 +1,6 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia at 26 July 2020
+ | Generated by Apache Maven Doxia at 07 August 2020
| Rendered using Apache Maven Fluido Skin 1.3.0
-->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
@@ -8,7 +8,7 @@
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta name="author" content="Commons Documentation Team" />
- <meta name="Date-Revision-yyyymmdd" content="20200726" />
+ <meta name="Date-Revision-yyyymmdd" content="20200807" />
<meta http-equiv="Content-Language" content="en" />
<title>Apache Commons – 2010 GSoC projects in Commons Sandbox</title>
@@ -25,7 +25,7 @@
</head>
<body class="composite">
- <a href="../.././" id="bannerLeft" title="Apache Commons logo">
+ <a href="http://commons.apache.org/" id="bannerLeft" title="Apache Commons logo">
<img class="logo-left" src="../../images/commons-logo.png" alt="Apache Commons logo"/>
</a>
<div class="clear"></div>
@@ -33,11 +33,11 @@
<div class="navbar">
<div class="navbar-inner">
<div class="container-fluid">
- <a class="brand" href="http://commons.apache.org/">Apache Commons ™</a>
+ <a class="brand" href="https://commons.apache.org/">Apache Commons ™</a>
<ul class="nav">
- <li id="publishDate">Last Published: 26 July 2020</li>
- <li class="divider">|</li> <li id="projectVersion">Version: 19</li>
+ <li id="publishDate">Last Published: 07 August 2020</li>
+ <li class="divider">|</li> <li id="projectVersion">Version: 23</li>
</ul>
<div class="pull-right"> <ul class="nav">
<li>
@@ -86,7 +86,7 @@
Mailing Lists</a>
</li>
<li class="none">
- <a href="../../team-list.html" title="PMC">
+ <a href="../../team.html" title="PMC">
PMC</a>
</li>
<li class="collapsed">
@@ -205,23 +205,10 @@
</div>
</td>
<td class="content">
- <!-- Licensed to the Apache Software Foundation (ASF) under one or more
- contributor license agreements. See the NOTICE file distributed with
- this work for additional information regarding copyright ownership.
- The ASF licenses this file to You under the Apache License, Version 2.0
- (the "License"); you may not use this file except in compliance with
- the License. You may obtain a copy of the License at
-
- http://www.apache.org/licenses/LICENSE-2.0
-
- Unless required by applicable law or agreed to in writing, software
- distributed under the License is distributed on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- See the License for the specific language governing permissions and
- limitations under the License. -->
+
- <div class="section">
+ <section>
<h2><a name="The_Apache_Commons_Sandbox_-_Google_Summer_of_Code_Projects"></a>The Apache Commons Sandbox - Google Summer of Code Projects</h2>
@@ -243,10 +230,9 @@
and simulation.</li>
</ul>
- </div>
+ </section>
-
-<div class="section">
+ <section>
<h2><a name="Status_of_the_GSoC_Projects"></a>Status of the GSoC Projects</h2>
@@ -261,7 +247,7 @@
is no active development for a sustained period of time.
</p>
- </div>
+ </section>
@@ -274,7 +260,7 @@
<p>Copyright © 2020
<a href="https://www.apache.org/">The Apache Software Foundation</a>.
All Rights Reserved.</p>
-
+ <?xml version="1.0" encoding="UTF-8"?>
<div class="center">Apache Commons, Apache, the Apache feather logo, and the Apache Commons project logos are trademarks of The Apache Software Foundation.
All other marks mentioned may be trademarks or registered trademarks of their respective owners.</div>
</div>