This is a proposed release plan for Doxia and related pieces of Maven software.
Below you will find which version of Doxia (first column) is going to be used in other software.
Doxia |
Maven |
Maven Site Plugin |
maven-doxia-tools |
Maven PIR Plugin |
maven-reporting-impl |
---|---|---|---|---|---|
1.0.x |
2.0.8+ |
2.0.x |
1.0.2+ |
2.1.2+ |
2.0.4.2+ |
1.1.x |
2.1.x |
2.1.x |
1.1.x |
2.2.x |
2.1.x |
Precise Doxia and Doxia Tools version is determined by Maven Site Plugin used.
Any reporting plugin released with Doxia 1.0.x dependency is compatible with Doxia 1.1.x. When a reporting plugin upgrades to Doxia 1.1 to benefit from new features, it's not compatible with Doxia 1.0.x/Maven 2.0.x any more: its prerequisite section should be changed accordingly.
Action |
Developers |
Date completed |
Comments |
---|---|---|---|
Release Doxia 1.0-alpha-11, from the alpha branch |
dennisl |
2008-05-20 |
|
Update Maven Site Plugin to use Doxia 1.0-alpha-11 |
dennisl |
2008-05-20 |
|
Update Maven PIR Plugin to use Doxia 1.0-alpha-11 |
dennisl |
2008-05-20 |
|
Move the unresolved issues slated for 2.0-beta-7 to 2.0-beta-8 or later |
dennisl |
2008-05-20 |
|
Release maven-doxia-tools 1.0, a shared component |
vsiveton |
2008-05-29 |
|
Update Maven Site Plugin to use maven-doxia-tools 1.0 |
dennisl |
2008-05-29 |
|
Update Maven PIR Plugin to use maven-doxia-tools 1.0 |
vsiveton |
2008-05-29 |
|
Release maven-doxia-tools version 1.0.1 |
dennisl |
2008-06-14 |
|
Update Maven Site Plugin to use maven-doxia-tools 1.0.1 |
dennisl |
2008-06-14 |
|
Update Maven PIR Plugin to use maven-doxia-tools 1.0.1 |
dennisl |
2008-06-14 |
|
Release Maven Site Plugin 2.0-beta-7, to avoid having too large releases |
dennisl |
2008-07-02 |
|
Release Maven PIR Plugin 2.1 |
vsiveton |
2008-07-28 |
|
Release Doxia 1.0 |
dennisl |
2009-02-19 |
|
Update Maven Site Plugin to use Doxia 1.0 |
dennisl |
2009-02-20 |
|
Update Maven 2.0.x to use Doxia 1.0 |
dennisl |
2009-02-20 |
Done in 2.0.11: MNG-4046 |
Release Doxia-sitetools 1.0 |
dennisl |
2009-03-01 |
|
Update maven-doxia-tools to use Doxia-sitetools 1.0 |
dennisl |
2009-03-01 |
|
Update Maven Site Plugin to use Doxia-sitetools 1.0 |
dennisl |
2009-03-01 |
|
Release maven-doxia-tools 1.0.2 |
dennisl |
2009-03-04 |
|
Update Maven Site Plugin to use maven-doxia-tools 1.0.2 |
dennisl |
2009-03-04 |
|
Update Maven PIR Plugin to use Doxia 1.0 |
hboutemy |
2009-03-07 |
|
Release Doxia 1.1 |
vsiveton |
2009-03-08 |
|
Update Maven 2.1.x to use Doxia 1.1 |
vsiveton |
2009-03-08 |
Done in 2.1.0: MNG-3602 |
Release Maven Site Plugin 2.0 |
dennisl |
2009-03-11 |
|
Release Doxia 1.1.1 |
ltheussl |
2009-06-24 |
|
Update Maven Site Plugin (2.1-SNAPSHOT) to use Doxia 1.1.1 |
ltheussl |
2009-07-17 |
Done in MSITE-298 |
Release maven-reporting-impl 2.0.4.2 using Doxia 1.0 |
dennisl |
2009-07-23 |
|
Release Maven PIR Plugin 2.1.2 using Doxia 1.0 |
dennisl |
2009-07-23 |
|
Come up with a way to handle MNG-3402 |
n/a |
n/a |
Not relevant anymore. |
Release maven-doxia-tools 1.1 using Doxia 1.1.1 |
dennisl |
2009-11-24 |
|
Release doxia and doxia-site-tools 1.1.2 targeting issues of the site plugin |
vsiveton |
2009-12-07 |
|
Release Maven Site Plugin 2.1 using Doxia 1.1.2 |
dennisl |
2009-12-21 |
|
Release maven-reporting-impl 2.1 using Doxia 1.1.1 |
ltheussl |
|
|
Release Maven PIR Plugin 2.2 using Doxia 1.1.2 |
|
|
|
Start collecting a list of issues that blocks a Doxia 1.2 release |
ltheussl |
|
|
Push that list down to 0 |
ltheussl |
|
|
Release Doxia 1.2 |
vsiveton |
|
|
Feel free to attach your name to any of the actions above, if you are able to help with them.
As seen in MNG-3402, Maven 2 distributes a doxia-sink-api copy in its uber-jar: this is the main dependency between Maven and Doxia. Every API change in doxia-sink-api needs to be included in a Maven version before it can be used in a plugin (setting this Maven's version as prerequisite).
There are other more subtle dependencies in miscellaneous parts of Maven.
interface org.apache.maven.doxia.sink.Sink
(since 1.0-alpha-6, no API change until 1.0-alpha-11)
deprecated interface org.codehaus.doxia.sink.Sink extends o.a.m.d.s.Sink
(since 1.0-alpha-7)
interface org.apache.maven.doxia.sink.SinkFactory
(since 1.0-alpha-9)
interface org.apache.maven.doxia.sink.SinkEventAttributes
(since 1.1)
interface org.apache.maven.reporting.MavenReport#generate(org.codehaus.doxia.sink.Sink, Locale)
interface org.apache.maven.reporting.MavenMultiPageReport extends MavenReport
(since maven-reporting-api 3.0)
#generate(org.apache.maven.doxia.sink.Sink, SinkFactory, Locale)
maven-reporting-api is included in Maven 2.x releases, but has moved to Maven Shared Components for 3.0 release: it is not included in Maven 3 any more.
Maven \[2.0.2;2.0.7\] contains doxia-sink-api 1.0-alpha-7 Maven 2.0.8 contains doxia-sink-api 1.0-alpha-9 Maven 2.0.9 contains doxia-sink-api 1.0-alpha-10, equivalent to alpha-9 Maven 2.0.10 contains doxia-sink-api 1.0-alpha-11, equivalent to alpha-9 Maven 2.0.11 contains doxia-sink-api 1.0, equivalent to alpha-9 |
abstract class org.apache.maven.reporting.AbstractMavenReport implements MavenReport
#generate(org.apache.maven.doxia.sink.Sink, SinkFactory, Locale)
interface org.apache.maven.doxia.sink.SinkFactory
(same as doxia-sink-api 1.0-alpha-9, to avoid Maven 2.0.8 as a prerequisite: see MSITE-368)
interface org.apache.maven.reporting.MavenMultiPageReport extends MavenReport
(same as maven-reporting-api 3.0, to avoid Maven 3.0 as a prerequisite)
#generate(org.apache.maven.doxia.sink.Sink, SinkFactory, Locale)