diff -r bf24e33c7919 -r 05676cfd40b5 jdk/src/java.management/share/classes/java/lang/management/ManagementFactory.java
--- a/jdk/src/java.management/share/classes/java/lang/management/ManagementFactory.java Thu Aug 06 13:20:13 2015 +0300
+++ b/jdk/src/java.management/share/classes/java/lang/management/ManagementFactory.java Thu Aug 06 13:59:10 2015 +0300
@@ -116,7 +116,7 @@
*
2. Indirect access to an MXBean interface via MBeanServer
*
* - Go through the platform {@code MBeanServer} to access MXBeans
- * locally or a specific MBeanServerConnection to access
+ * locally or a specific {@code MBeanServerConnection} to access
* MXBeans remotely.
* The attributes and operations of an MXBean use only
* JMX open types which include basic data types,
@@ -209,17 +209,17 @@
*
* {@link GarbageCollectorMXBean} |
* {@link #GARBAGE_COLLECTOR_MXBEAN_DOMAIN_TYPE
- * java.lang:type=GarbageCollector},name=collector's name |
+ * java.lang:type=GarbageCollector}{@code ,name=}collector's name
*
*
* {@link MemoryManagerMXBean} |
* {@link #MEMORY_MANAGER_MXBEAN_DOMAIN_TYPE
- * java.lang:type=MemoryManager},name=manager's name |
+ * java.lang:type=MemoryManager}{@code ,name=}manager's name
*
*
* {@link MemoryPoolMXBean} |
* {@link #MEMORY_POOL_MXBEAN_DOMAIN_TYPE
- * java.lang:type=MemoryPool},name=pool's name |
+ * java.lang:type=MemoryPool}{@code ,name=}pool's name
*
*
* {@link BufferPoolMXBean} |
@@ -243,72 +243,72 @@
/**
* String representation of the
- * ObjectName for the {@link ClassLoadingMXBean}.
+ * {@code ObjectName} for the {@link ClassLoadingMXBean}.
*/
public final static String CLASS_LOADING_MXBEAN_NAME =
"java.lang:type=ClassLoading";
/**
* String representation of the
- * ObjectName for the {@link CompilationMXBean}.
+ * {@code ObjectName} for the {@link CompilationMXBean}.
*/
public final static String COMPILATION_MXBEAN_NAME =
"java.lang:type=Compilation";
/**
* String representation of the
- * ObjectName for the {@link MemoryMXBean}.
+ * {@code ObjectName} for the {@link MemoryMXBean}.
*/
public final static String MEMORY_MXBEAN_NAME =
"java.lang:type=Memory";
/**
* String representation of the
- * ObjectName for the {@link OperatingSystemMXBean}.
+ * {@code ObjectName} for the {@link OperatingSystemMXBean}.
*/
public final static String OPERATING_SYSTEM_MXBEAN_NAME =
"java.lang:type=OperatingSystem";
/**
* String representation of the
- * ObjectName for the {@link RuntimeMXBean}.
+ * {@code ObjectName} for the {@link RuntimeMXBean}.
*/
public final static String RUNTIME_MXBEAN_NAME =
"java.lang:type=Runtime";
/**
* String representation of the
- * ObjectName for the {@link ThreadMXBean}.
+ * {@code ObjectName} for the {@link ThreadMXBean}.
*/
public final static String THREAD_MXBEAN_NAME =
"java.lang:type=Threading";
/**
* The domain name and the type key property in
- * the ObjectName for a {@link GarbageCollectorMXBean}.
- * The unique ObjectName for a GarbageCollectorMXBean
+ * the {@code ObjectName} for a {@link GarbageCollectorMXBean}.
+ * The unique {@code ObjectName} for a {@code GarbageCollectorMXBean}
* can be formed by appending this string with
- * ",name=collector's name".
+ * "{@code ,name=}collector's name".
*/
public final static String GARBAGE_COLLECTOR_MXBEAN_DOMAIN_TYPE =
"java.lang:type=GarbageCollector";
/**
* The domain name and the type key property in
- * the ObjectName for a {@link MemoryManagerMXBean}.
- * The unique ObjectName for a MemoryManagerMXBean
+ * the {@code ObjectName} for a {@link MemoryManagerMXBean}.
+ * The unique {@code ObjectName} for a {@code MemoryManagerMXBean}
* can be formed by appending this string with
- * ",name=manager's name".
+ * "{@code ,name=}manager's name".
*/
public final static String MEMORY_MANAGER_MXBEAN_DOMAIN_TYPE=
"java.lang:type=MemoryManager";
/**
* The domain name and the type key property in
- * the ObjectName for a {@link MemoryPoolMXBean}.
- * The unique ObjectName for a MemoryPoolMXBean
+ * the {@code ObjectName} for a {@link MemoryPoolMXBean}.
+ * The unique {@code ObjectName} for a {@code MemoryPoolMXBean}
* can be formed by appending this string with
- * ,name=pool's name.
+ * {@code ,name=}pool's name.
*/
public final static String MEMORY_POOL_MXBEAN_DOMAIN_TYPE=
"java.lang:type=MemoryPool";
@@ -357,11 +357,11 @@
/**
* Returns the managed bean for the compilation system of
- * the Java virtual machine. This method returns null
+ * the Java virtual machine. This method returns {@code null}
* if the Java virtual machine has no compilation system.
*
* @return a {@link CompilationMXBean} object for the Java virtual
- * machine or null if the Java virtual machine has
+ * machine or {@code null} if the Java virtual machine has
* no compilation system.
*/
public static CompilationMXBean getCompilationMXBean() {
@@ -385,7 +385,7 @@
* The Java virtual machine can have one or more memory pools.
* It may add or remove memory pools during execution.
*
- * @return a list of MemoryPoolMXBean objects.
+ * @return a list of {@code MemoryPoolMXBean} objects.
*
*/
public static List getMemoryPoolMXBeans() {
@@ -398,7 +398,7 @@
* The Java virtual machine can have one or more memory managers.
* It may add or remove memory managers during execution.
*
- * @return a list of MemoryManagerMXBean objects.
+ * @return a list of {@code MemoryManagerMXBean} objects.
*
*/
public static List getMemoryManagerMXBeans() {
@@ -410,11 +410,11 @@
* Returns a list of {@link GarbageCollectorMXBean} objects
* in the Java virtual machine.
* The Java virtual machine may have one or more
- * GarbageCollectorMXBean objects.
- * It may add or remove GarbageCollectorMXBean
+ * {@code GarbageCollectorMXBean} objects.
+ * It may add or remove {@code GarbageCollectorMXBean}
* during execution.
*
- * @return a list of GarbageCollectorMXBean objects.
+ * @return a list of {@code GarbageCollectorMXBean} objects.
*
*/
public static List getGarbageCollectorMXBeans() {
@@ -485,21 +485,21 @@
* Returns a proxy for a platform MXBean interface of a
* given MXBean name
* that forwards its method calls through the given
- * MBeanServerConnection.
+ * {@code MBeanServerConnection}.
*
* This method is equivalent to:
*
* {@link java.lang.reflect.Proxy#newProxyInstance
- * Proxy.newProxyInstance}(mxbeanInterface.getClassLoader(),
- * new Class[] { mxbeanInterface }, handler)
+ * Proxy.newProxyInstance}{@code (mxbeanInterface.getClassLoader(),
+ * new Class[] { mxbeanInterface }, handler)}
*
*
- * where handler is an {@link java.lang.reflect.InvocationHandler
+ * where {@code handler} is an {@link java.lang.reflect.InvocationHandler
* InvocationHandler} to which method invocations to the MXBean interface
- * are dispatched. This handler converts an input parameter
+ * are dispatched. This {@code handler} converts an input parameter
* from an MXBean data type to its mapped open type before forwarding
- * to the MBeanServer and converts a return value from
- * an MXBean method call through the MBeanServer
+ * to the {@code MBeanServer} and converts a return value from
+ * an MXBean method call through the {@code MBeanServer}
* from an open type to the corresponding return type declared in
* the MXBean interface.
*
@@ -507,7 +507,7 @@
* If the MXBean is a notification emitter (i.e.,
* it implements
* {@link javax.management.NotificationEmitter NotificationEmitter}),
- * both the mxbeanInterface and NotificationEmitter
+ * both the {@code mxbeanInterface} and {@code NotificationEmitter}
* will be implemented by this proxy.
*
*
@@ -516,12 +516,12 @@
*
- Using an MXBean proxy is a convenience remote access to
* a platform MXBean of a running virtual machine. All method
* calls to the MXBean proxy are forwarded to an
- * MBeanServerConnection where
+ * {@code MBeanServerConnection} where
* {@link java.io.IOException IOException} may be thrown
* when the communication problem occurs with the connector server.
* An application remotely accesses the platform MXBeans using
- * proxy should prepare to catch IOException as if
- * accessing with the MBeanServerConnector interface.
+ * proxy should prepare to catch {@code IOException} as if
+ * accessing with the {@code MBeanServerConnector} interface.
*
* - When a client application is designed to remotely access MXBeans
* for a running virtual machine whose version is different than
@@ -537,15 +537,15 @@
* {@link javax.management.MBeanServerInvocationHandler#newProxyInstance
* newProxyInstance} method cannot be used to create
* a proxy for a platform MXBean. The proxy object created
- * by MBeanServerInvocationHandler does not handle
+ * by {@code MBeanServerInvocationHandler} does not handle
* the properties of the platform MXBeans described in
* the class specification.
*
*
*
- * @param connection the MBeanServerConnection to forward to.
+ * @param connection the {@code MBeanServerConnection} to forward to.
* @param mxbeanName the name of a platform MXBean within
- * connection to forward to. mxbeanName must be
+ * {@code connection} to forward to. {@code mxbeanName} must be
* in the format of {@link ObjectName ObjectName}.
* @param mxbeanInterface the MXBean interface to be implemented
* by the proxy.
@@ -554,22 +554,22 @@
* @return a proxy for a platform MXBean interface of a
* given MXBean name
* that forwards its method calls through the given
- * MBeanServerConnection, or {@code null} if not exist.
+ * {@code MBeanServerConnection}, or {@code null} if not exist.
*
* @throws IllegalArgumentException if
*
- * - mxbeanName is not with a valid
+ *
- {@code mxbeanName} is not with a valid
* {@link ObjectName ObjectName} format, or
- * - the named MXBean in the connection is
+ *
- the named MXBean in the {@code connection} is
* not a MXBean provided by the platform, or
* - the named MXBean is not registered in the
- * MBeanServerConnection, or
+ * {@code MBeanServerConnection}, or
* - the named MXBean is not an instance of the given
- * mxbeanInterface
+ * {@code mxbeanInterface}
*
*
* @throws java.io.IOException if a communication problem
- * occurred when accessing the MBeanServerConnection.
+ * occurred when accessing the {@code MBeanServerConnection}.
*/
public static T
newPlatformMXBeanProxy(MBeanServerConnection connection,