United StatesChange Country, Oracle Worldwide Web Sites Communities I am a... I want to...
Bug ID: JDK-6909563 Javadoc build warnings in rmi, security, management
JDK-6909563 : Javadoc build warnings in rmi, security, management

Details
Type:
Bug
Submit Date:
2009-12-11
Status:
Resolved
Updated Date:
2011-01-05
Project Name:
JDK
Resolved Date:
2010-01-08
Component:
core-libs
OS:
generic
Sub-Component:
java.rmi
CPU:
generic
Priority:
P4
Resolution:
Fixed
Affected Versions:
7
Fixed Versions:

Related Reports
Backport:

Sub Tasks

Description
There are various javadoc build warnings because of typos in the javadoc in rmi, security, and management.  These issues should be fixed.

                                    

Comments
EVALUATION

A fine idea.
                                     
2009-12-11
SUGGESTED FIX

# HG changeset patch
# User darcy
# Date 1260556814 28800
# Node ID 3267ca7afe95eedabbc0bb4553ee3f62c86acef5
# Parent aa0d374b40a5f9a41177d7900326e3647976ad95
6909563: Javadoc build warnings in rmi, security, management
Reviewed-by: mchung, mullan

--- a/src/share/classes/java/lang/management/PlatformManagedObject.java	Thu Dec 10 13:28:07 2009 -0800
+++ b/src/share/classes/java/lang/management/PlatformManagedObject.java	Fri Dec 11 10:40:14 2009 -0800
@@ -32,7 +32,7 @@ import javax.management.ObjectName;
  * for monitoring and managing a component in the Java platform.
  * Each platform managed object has a unique
  * <a href="ManagementFactory.html#MXBean">object name</a>
- * for the {@linkplain ManagementFactory.getPlatformMBeanServer
+ * for the {@linkplain ManagementFactory#getPlatformMBeanServer
  * platform MBeanServer} access.
  * All platform MXBeans will implement this interface.
  *
--- a/src/share/classes/java/rmi/activation/Activatable.java	Thu Dec 10 13:28:07 2009 -0800
+++ b/src/share/classes/java/rmi/activation/Activatable.java	Fri Dec 11 10:40:14 2009 -0800
@@ -73,7 +73,7 @@ public abstract class Activatable extend
      * can be handled properly.
      *
      * <p>This method invokes the {@link
-     * exportObject(Remote,String,MarshalledObject,boolean,port)
+     * #exportObject(Remote,String,MarshalledObject,boolean,int)
      * exportObject} method with this object, and the specified location,
      * data, restart mode, and port.  Subsequent calls to {@link #getID}
      * will return the activation identifier returned from the call to
@@ -120,7 +120,7 @@ public abstract class Activatable extend
      * can be handled properly.
      *
      * <p>This method invokes the {@link
-     * exportObject(Remote,String,MarshalledObject,boolean,port,RMIClientSocketFactory,RMIServerSocketFactory)
+     * #exportObject(Remote,String,MarshalledObject,boolean,int,RMIClientSocketFactory,RMIServerSocketFactory)
      * exportObject} method with this object, and the specified location,
      * data, restart mode, port, and client and server socket factories.
      * Subsequent calls to {@link #getID} will return the activation
@@ -312,7 +312,7 @@ public abstract class Activatable extend
      * separately, so that exceptions can be handled properly.
      *
      * <p>This method invokes the {@link
-     * exportObject(Remote,String,MarshalledObject,boolean,port,RMIClientSocketFactory,RMIServerSocketFactory)
+     * #exportObject(Remote,String,MarshalledObject,boolean,int,RMIClientSocketFactory,RMIServerSocketFactory)
      * exportObject} method with the specified object, location, data,
      * restart mode, and port, and <code>null</code> for both client and
      * server socket factories, and then returns the resulting activation
--- a/src/share/classes/java/rmi/registry/LocateRegistry.java	Thu Dec 10 13:28:07 2009 -0800
+++ b/src/share/classes/java/rmi/registry/LocateRegistry.java	Fri Dec 11 10:40:14 2009 -0800
@@ -187,7 +187,7 @@ public final class LocateRegistry {
      * host that accepts requests on the specified <code>port</code>.
      *
      * <p>The <code>Registry</code> instance is exported as if the static
-     * {@link UnicastRemoteObject.exportObject(Remote,int)
+     * {@link UnicastRemoteObject#exportObject(Remote,int)
      * UnicastRemoteObject.exportObject} method is invoked, passing the
      * <code>Registry</code> instance and the specified <code>port</code> as
      * arguments, except that the <code>Registry</code> instance is
@@ -213,7 +213,7 @@ public final class LocateRegistry {
      *
      * <p>The <code>Registry</code> instance is exported as if
      * the static {@link
-     * UnicastRemoteObject.exportObject(Remote,int,RMIClientSocketFactory,RMIServerSocketFactory)
+     * UnicastRemoteObject#exportObject(Remote,int,RMIClientSocketFactory,RMIServerSocketFactory)
      * UnicastRemoteObject.exportObject} method is invoked, passing the
      * <code>Registry</code> instance, the specified <code>port</code>, the
      * specified <code>RMIClientSocketFactory</code>, and the specified
--- a/src/share/classes/java/rmi/server/RemoteObjectInvocationHandler.java	Thu Dec 10 13:28:07 2009 -0800
+++ b/src/share/classes/java/rmi/server/RemoteObjectInvocationHandler.java	Fri Dec 11 10:40:14 2009 -0800
@@ -138,7 +138,6 @@ public class RemoteObjectInvocationHandl
      * instance
      * @throws  Throwable the exception to throw from the method invocation
      * on the proxy instance
-     * @see
      **/
     public Object invoke(Object proxy, Method method, Object[] args)
         throws Throwable
--- a/src/share/classes/java/security/cert/CertPathValidatorException.java	Thu Dec 10 13:28:07 2009 -0800
+++ b/src/share/classes/java/security/cert/CertPathValidatorException.java	Fri Dec 11 10:40:14 2009 -0800
@@ -216,7 +216,7 @@ public class CertPathValidatorException 
     /**
      * Returns the reason that the validation failed. The reason is
      * associated with the index of the certificate returned by
-     * {@link getIndex}.
+     * {@link #getIndex}.
      *
      * @return the reason that the validation failed, or
      *    <code>BasicReason.UNSPECIFIED</code> if a reason has not been
                                     
2009-12-11
PUBLIC COMMENTS

See
http://hg.openjdk.java.net/jdk7/tl/jdk/rev/3267ca7afe95
                                     
2009-12-11



Hardware and Software, Engineered to Work Together