Proposed javadoc/doclet improvements for JDK7

[Andrew John Hughes]

2009/6/9 Martin Buchholz <martinrb at google.com>:
> 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.
>

Yes, that's why I narrowed it down to the jdk repo ;)

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



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