Proposed javadoc/doclet improvements for JDK7

[Andrew John Hughes]

2009/6/9  <Bhavesh.Patel at sun.com>:
> Hi Andrew,
>                    Regarding warning of OpenJDK doc builds, we get about 270
> warning on doc comments in source code currently. We definitely want to
> address this issue but it will be separate from the proposed improvements.
>
> Regards,
> Bhavesh.
>

No problem.  I should probably make clear that I'm not asking in order
to get you to do it, but to ascertain whether it is worth anyone
putting the work in to fix this stuff, including myself.

> On 06/09/09 14:47, Andrew John Hughes 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