JavaDoc and doclint

Maurizio Cimadamore maurizio.cimadamore at oracle.com
Wed May 29 03:15:10 PDT 2013


On 29/05/13 10:00, Sven Reimers wrote:
> Hi Maurizio,
>
> so if I understand correctly, the doclint feature cannot be used 
> during javadoc run, just with javac?
My first response was partially incorrect; I looked at the Javadoc 
sources and there is indeed support for Doclint there; I think that for 
technical reasons the Xdoclint is treated as a doclet options - for that 
reason the option is not exposed through normal 'help' message when you 
do 'javadoc -X'. The support is there nevertheless as the same options 
that can be passed to javac should be accepted by javadoc (in fact, 
doclint support is up and running in our JDK builds [1]).

Jon will certainly give you more info about this and tell whether the 
fact that doclint option are not shown in the javadoc help is a bug or 
not (I think it looks like one).

Thanks
Maurizio

[1] - http://hg.openjdk.java.net/jdk8/tl/rev/1129fb75f611
>
> Thanks for clarification.
>
> -Sven
>
>
> On Wed, May 29, 2013 at 9:49 AM, Maurizio Cimadamore 
> <maurizio.cimadamore at oracle.com 
> <mailto:maurizio.cimadamore at oracle.com>> wrote:
>
>     On 29/05/13 08:05, Sven Reimers wrote:
>
>         Hi,
>
>         I hope this is the correct place to ask. With ea b91 installed
>         from JDK8 I
>         wanted to use the doclint feature. It seems that is is
>         available from javac
>         but not from javadoc at the moment, if I look at the help
>         output from javac
>         -X vs. javadoc -X.
>
>         Hope anyone can clarify.
>
>         Thanks
>
>         Sven
>
>     Hi Sven,
>     yes, doclint is a javac option - you can use the compiler-dev
>     mailing list (CC'ed) for questions about the doclint feaure.
>
>     Maurizio
>
>
>
>
> -- 
> Sven Reimers
>
> * Senior Expert Software Architect
> * NetBeans Dream Team Member: http://dreamteam.netbeans.org
> * Community Leader  NetBeans: http://community.java.net/netbeans
>                               Desktop Java: 
> http://community.java.net/javadesktop
> * Duke's Choice Award Winner 2009
> * Blog: http://nbguru.blogspot.com
>
> * XING: https://www.xing.com/profile/Sven_Reimers8
> * LinkedIn: http://www.linkedin.com/in/svenreimers
>
> Join the NetBeans Groups:
> * XING: http://www.xing.com/group-20148.82db20
> * NUGM: http://haug-server.dyndns.org/display/NUGM/Home
> * LinkedIn: http://www.linkedin.com/groups?gid=1860468
> http://www.linkedin.com/groups?gid=107402
> http://www.linkedin.com/groups?gid=1684717
> * Oracle: https://mix.oracle.com/groups/18497

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://mail.openjdk.java.net/pipermail/compiler-dev/attachments/20130529/eccb6892/attachment.html 


More information about the compiler-dev mailing list