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.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.

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 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.

Doxia: doxia-sink-api

interface org.apache.maven.doxia.sink.Sink (since 1.0-alpha-6, no API change until 1.0)

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)

Maven Components: maven-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-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

Maven Shared: maven-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 maven-reporting-api 3.0, to avoid Maven 3.0 as a prerequisite)
             #generate(org.apache.maven.doxia.sink.Sink, SinkFactory, Locale)

  • No labels