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>
