Easy-to-fix javadoc warning (original) (raw)
Chris Hegarty chris.hegarty at oracle.com
Mon Feb 13 11:12:56 UTC 2012
- Previous message: Easy-to-fix javadoc warning
- Next message: hg: jdk8/tl/langtools: 7144979: incorrect path separator in make/build.xml for Windows when running jtreg tests
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]
Thanks for reporting this Jon.
I filed CR 7145043: "HttpServerProvider.java:81: warning - @code("httpServerProvider") is an unknown tag"
You see quite a few of these type of RuntimePermission links through out the core area. The intent is to link to RuntimePermission and show the appropriate String arg "target name".
The simplest fix is to add a space after the @code tag. This generates the required javadoc, "RuntimePermission("httpServerProvider")", similar to how it appears in System.getenv [1].
src/share/classes/com/sun/net/httpserver/spi/HttpServerProvider.java @@ -76,7 +76,7 @@ public abstract class HttpServerProvider * * @throws SecurityException * If a security manager has been installed and it denies
* {@link RuntimePermission}{@code("httpServerProvider")}
* {@link RuntimePermission}{@code ("httpServerProvider")} */ protected HttpServerProvider() { SecurityManager sm = System.getSecurityManager();
Thanks, -Chris.
[1] http://download.java.net/jdk8/docs/api/java/lang/System.html#getenv%28java.lang.String%29
- Previous message: Easy-to-fix javadoc warning
- Next message: hg: jdk8/tl/langtools: 7144979: incorrect path separator in make/build.xml for Windows when running jtreg tests
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]