Proposed javadoc/doclet improvements for JDK7

Bhavesh.Patel at Sun.COM Bhavesh.Patel at Sun.COM
Tue Jun 9 14:58:45 PDT 2009


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.

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




More information about the jdk7-dev mailing list