commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Simone Tripodi <>
Subject Re: Apache Commons Javadoc template?
Date Fri, 09 Mar 2012 11:12:45 GMT
Salut Manu,

I can do something, it is a matter of implementing a doclet for
javadoc - the Maven plugin already supports it, unfortunately I don't
have so much spare time to follow all these activities ATM :(

On 2010/2011 I helped Google Doclava[1] team on releasing the Doclava
Doclet to Mvn central repo, it looks like the Google Guice one[2].

I think forking a Doclet we all like to start implementing our own
would be a good starting point.

All the best,


On Fri, Mar 9, 2012 at 11:21 AM, Emmanuel Bourg <> wrote:
> Hi all,
> I noticed that Commons Math 3.0 has been released with the new Javadoc
> template introduced with Java 7 [1]. While this template looks more polished
> at first glance, it's actually less readable than the old one for a variety
> of reasons (changes in alignment, lack of indentation and emphasis). This
> led me to publish some time ago a GreaseMonkey script that restore important
> aspects of the old template [2].
> I'm pondering if we could agree on a Javadoc template, derived from the one
> in Java 7 and with an improved readability, that would be applied to all
> Commons components. The visual aspect of this template could also be adapted
> to the Apache branding, for example by replacing the blue gradient with a
> purple/violet gradient referring to the Apache feather.
> The Hibernate project uses a custom Javadoc template and it looks pretty
> good [3].
> I haven't investigated how this could be implemented with Maven and if it's
> possible to tweak the template in the parent pom. If anyone knows how it
> works, please speak up! If it works well we could even share it at the ASF
> level.
> Emmanuel Bourg
> [1]
> [2]
> [3]

To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message