Proposed javadoc/doclet improvements for JDK7

[Martin Buchholz]

Historical note:

During the JDK6 timeframe, most of the javadoc warnings in the core jdk were
fixed.
Finding maintainers for review is usually harder than the actual fixing.
OpenJDK has upstream projects as well.

Martin

On Tue, Jun 9, 2009 at 14:47, Andrew John Hughes
<gnu_andrew at member.fsf.org>wrote:

> 2009/6/9  <Bhavesh.Patel at sun.com>:
> > Hi All,
> >        We are proposing improvements to javadoc/doclet for JDK7. The
> project
> > wiki page is located at http://wikis.sun.com/display/Javadoc/Home. As a
> part
> > of the proposed improvements, the UI of the javadoc output will be
> revamped.
> > The new design screenshots are uploaded to the project wiki. The javadoc
> > output markup will be modified to be valid HTML and WCAG 2.0 compliant.
> >         Please start discussing any suggestions or concerns you have
> about
> > the proposed improvements.
> >
> > Regards,
> > Bhavesh.
> >
>
> These sound like very welcome improvements.  I hope those in the
> community who are outside Sun will also be able to get involved, as
> this seems a good area where contributions can be made without a high
> barrier to entry.
>
> Will work also be done on the existing Javadoc comments in the JDK
> sources? I've noticed some warnings as docs are built with OpenJDK at
> the moment, and presumably there are more issues that aren't being
> flagged.
>
> Regards,
> --
> Andrew :-)
>
> Free Java Software Engineer
> Red Hat, Inc. (http://www.redhat.com)
>
> Support Free Java!
> Contribute to GNU Classpath and the OpenJDK
> http://www.gnu.org/software/classpath
> http://openjdk.java.net
>
> PGP Key: 94EFD9D8 (http://subkeys.pgp.net)
> Fingerprint: F8EF F1EA 401E 2E60 15FA  7927 142C 2591 94EF D9D8
>