This is a proposed release plan for Doxia and related pieces of Maven software.
Road map
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.11+ | 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 |
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.
Actions
| 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. Doxia dep in maven 2.1/2.2 has been set to 1.1. Doxia dep in maven 3 has been removed. |
| Release maven-doxia-tools 1.1 using Doxia 1.1.1 | dennisl | 2009-11-24 | MSHARED-115 |
| 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 | MSITE-419 |
| 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.
sorting out Maven dependencies on Doxia
As seen in MNG-3402, Maven 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.
Doxia: doxia-sink-api
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)
Maven Components: reporting-api
interface org.apache.maven.reporting.MavenReport#generate(org.codehaus.doxia.sink.Sink, Locale)
interface org.apache.maven.reporting.MavenMultiPageReport extends MavenReport (since Maven 3.0)
#generate(org.apache.maven.doxia.sink.Sink, SinkFactory, Locale)
Maven [2.0.2;2.0.7] depends on doxia-sink-api 1.0-alpha-7
Maven 2.0.8 depends on doxia-sink-api 1.0-alpha-9
Maven 2.0.9 depends on doxia-sink-api 1.0-alpha-10, equivalent to alpha-9
Maven 2.0.10 depends on doxia-sink-api 1.0-alpha-11, equivalent to alpha-9
Maven Shared: reporting-impl
abstract class org.apache.maven.reporting.AbstractMavenReport implements MavenReport
#generate(org.apache.maven.doxia.sink.Sink, SinkFactory, Locale)
Maven Plugins: maven-site-plugin
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 reporting-api 3.0, to avoid Maven 3.0 as a prerequisite)
#generate(org.apache.maven.doxia.sink.Sink, SinkFactory, Locale)
