javadoc warning

[Joe Darcy]

We've been cleanup up warnings caught by using "-Xdoclint:all/protected" 
with *javac*. You can include this in your build step by doing something 
like

     make 
JAVAC_WARNINGS="-Xlint:-unchecked,-deprecation,-overrides,classfile,dep-ann,divzero,varargs 
-Werror -Xdoclint:all/protected"

(Current setting of JAVAC_WARNINGS done in makefiles/Setup.gmk in the 
jdk repo.)

HTH,

-Joe

On 9/19/2013 2:52 PM, John Rose wrote:
> I have a 292 cleanup bug I can roll this fix into, 8024438.
>
> FTR, I'm using this command to test for javadoc lint:
>    make docs-only GENERATE_DOCS=true CONF=release
>
> It gave this encouraging output:
>> javadoc: warning - Multiple sources of package comments found for package "javax.xml.ws.wsaddressing"
>> /Users/jrose/Projects/davinci/sources/jdk/src/share/classes/java/lang/invoke/MethodHandleInfo.java:207: warning - Tag @see: reference not found: reflectAs
>> /Users/jrose/Projects/davinci/sources/build/macosx-x86_64-normal-server-release/jdk/impsrc/javax/xml/bind/JAXBContext.java:262: warning - Tag @see: reference not found: S 7.4.1 "Named Packages" in Java Language Specification</a>
>> 3 warnings
> — John
>
> On Sep 19, 2013, at 2:33 PM, John Rose <john.r.rose at oracle.com> wrote:
>
>> On Sep 19, 2013, at 1:26 PM, Jonathan Gibbons <jonathan.gibbons at oracle.com> wrote:
>>
>>> .../tl/jdk/src/share/classes/java/lang/invoke/MethodHandleInfo.java:195:
>>> warning - Tag @see: reference not found: reflectAs
>> Oops.  Should be #reflectAs or MethodHandleInfo#reflectAs.  — John
>>
>