<?xml version="1.0"?>
<!--

   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.

-->
<!--
This file is also used by the maven-changes-plugin to generate the release notes.
Useful ways of finding items to add to this file are:

1.  Add items when you fix a bug or add a feature (this makes the 
release process easy :-).

2.  Do a JIRA search for tickets closed since the previous release.

3.  Use the report generated by the maven-changelog-plugin to see all
SVN commits. TBA how to use this with SVN.

To generate the release notes from this file:

mvn changes:announcement-generate
then tweak the formatting if necessary 
and commit

The <action> type attribute can be add,update,fix,remove.
-->

<document>
    <properties>
        <title>Changes</title>
        <author email="dev@commons.apache.org">Apache Commons devlopers</author>
    </properties>

    <!-- NOTE: 
    The description below is specially formatted so as to improve the layout of the generated release notes:
    The parsing process removes all line feeds, replacing them with a single space.
    The Velocity template in resources/templates has been enhanced to replace pairs of adjacent spaces
    with a new-line in the release notes. (These spaces are ignored when displaying HTML).
    If the output is not quite correct, check for invisible trailing spaces!
    
    N.B. The release notes template groups actions by type, and only extracts data for the current release.
    The changes report outputs actions in the order they appear in this file. 
     -->

    <body>
        <release version="22" date="TBA" description="
Starting with version 22, the RAT plugin has changed Maven group and id,
 so any existing configuration needs to be updated.
 To fix component POMs, please change any occurrences of:
  &lt;groupId>org.codehaus.mojo&lt;/groupId>
  &lt;artifactId>rat-maven-plugin&lt;/artifactId>
 to the new values:
  &lt;groupId>org.apache.rat&lt;/groupId>
  &lt;artifactId>apache-rat-plugin&lt;/artifactId>
">
            <action dev="sebb" type="add">
            Add commons.release.version and commons.rc.version for use in releasing commons parent
            </action>
            <action dev="sebb" type="add">
            Add release-notes profile to generate RELEASE-NOTES.txt from changes.xml.
            Added changes.xml and template release-notes.vm
            </action>
            <action dev="sebb" type="add">
            Add pom description
            </action>
            <action dev="sebb" type="fix">
            Added workround for bundle plugin 2.3.5 on Java 1.5 - replace embedded bndlib with previous version
            </action>
            <action dev="sebb" type="add">
            Add buildnumber plugin and put build details into manifests.
            </action>
            <action dev="sebb" type="add">
            Add Clirr report for all components
            </action>
            <action dev="sebb" type="update">
            Update to site plugin 3.0 (usable by Maven 2 and Maven 3)
            </action>
            <action dev="sebb" type="fix">
            Fix resources and testResource overrides to include the default directories.
            Components which redefine these may no longer need to do so.
            </action>
            <action type="update">
            Update to latest releases of plugins.
            </action>
            <action dev="sebb" type="remove">
            Remove Maven IDEA plugin.
            </action>
            <action dev="sebb" type="update">
            Update to Apache RAT plugin, and enable use as standalone goal.
            </action>
            <action dev="ggregory" type="add">
            Add Javadoc link to Java EE.
            </action>
            
        </release>

    </body>
</document>
