Mailing-List: contact dev-help@commons.apache.org; run by ezmlm
Precedence: bulk
Reply-To: "Commons Developers List" <dev@commons.apache.org>
Received-SPF: pass (athena.apache.org: domain of simone.tripodi@gmail.com
 designates 209.85.216.171 as permitted sender)
MIME-Version: 1.0
Sender: simone.tripodi@gmail.com
In-Reply-To: <4F59D9BA.9040409@apache.org>
References: <4F59D9BA.9040409@apache.org>
Date: Fri, 9 Mar 2012 12:12:45 +0100
Message-ID: 
 <CAAqLGLMtc9EPZrEzVm6upg7HQfY4fwaOSUd0zL+qEjxxL8=_XA@mail.gmail.com>
Subject: Re: Apache Commons Javadoc template?
From: Simone Tripodi <simonetripodi@apache.org>
To: Commons Developers List <dev@commons.apache.org>
Content-Type: text/plain; charset=UTF-8

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,
-Simo

[1] http://code.google.com/p/doclava/
[2] http://google-guice.googlecode.com/git/javadoc/packages.html

http://people.apache.org/~simonetripodi/
http://simonetripodi.livejournal.com/
http://twitter.com/simonetripodi
http://www.99soft.org/


On Fri, Mar 9, 2012 at 11:21 AM, Emmanuel Bourg <ebourg@apache.org> 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] http://docs.oracle.com/javase/7/docs/api
> [2] http://userscripts.org/scripts/show/108797
> [3] http://docs.jboss.org/hibernate/core/3.6/javadocs
>

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org