diff --git a/jdk/src/share/classes/java/lang/management/LockInfo.java b/jdk/src/share/classes/java/lang/management/LockInfo.java index 4c05ee84f0c..b08bc046c33 100644 --- a/jdk/src/share/classes/java/lang/management/LockInfo.java +++ b/jdk/src/share/classes/java/lang/management/LockInfo.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2012, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -42,7 +42,7 @@ import sun.management.LockInfoCompositeData; * {@link ReentrantReadWriteLock ReentrantReadWriteLock} are * two examples of ownable synchronizers provided by the platform. * - *
- *+ *
*
* Attribute Name *Type diff --git a/jdk/src/share/classes/java/lang/management/ManagementFactory.java b/jdk/src/share/classes/java/lang/management/ManagementFactory.java index 384cf4cda06..6e00706ccd0 100644 --- a/jdk/src/share/classes/java/lang/management/ManagementFactory.java +++ b/jdk/src/share/classes/java/lang/management/ManagementFactory.java @@ -61,7 +61,7 @@ import sun.management.ManagementFactoryHelper; * the management interface of a component of the Java virtual * machine. *- *
Platform MXBeans
+ *Platform MXBeans
** A platform MXBean is a managed bean that * conforms to the JMX @@ -87,7 +87,7 @@ import sun.management.ManagementFactoryHelper; * *
* An application can access a platform MXBean in the following ways: - *
1. Direct access to an MXBean interface
+ *1. Direct access to an MXBean interface
***
- *- Get an MXBean instance by calling the @@ -107,7 +107,7 @@ import sun.management.ManagementFactoryHelper; * an MXBean of another running virtual machine. *
*2. Indirect access to an MXBean interface via MBeanServer
+ *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 @@ -135,7 +135,7 @@ import sun.management.ManagementFactoryHelper; * interfaces: * *
- *+ *
*
* Management Interface *ObjectName @@ -178,7 +178,7 @@ import sun.management.ManagementFactoryHelper; * the following management interfaces. * *- *+ *
*
* Management Interface *ObjectName @@ -195,7 +195,7 @@ import sun.management.ManagementFactoryHelper; * A Java virtual machine may have one or more instances of the following * management interfaces. *- *+ *
*
* Management Interface *ObjectName @@ -561,6 +561,12 @@ public class ManagementFactory { * in the format of {@link ObjectName ObjectName}. * @param mxbeanInterface the MXBean interface to be implemented * by the proxy. + * @paraman {@code mxbeanInterface} type parameter + * + * @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. * * @throws IllegalArgumentException if * @@ -635,6 +641,7 @@ public class ManagementFactory { * @param mxbeanInterface a management interface for a platform * MXBean with one single instance in the Java virtual machine * if implemented. + * @param
an {@code mxbeanInterface} type parameter * * @return the platform MXBean that implements * {@code mxbeanInterface}, or {@code null} if not exist. @@ -670,6 +677,7 @@ public class ManagementFactory { * * @param mxbeanInterface a management interface for a platform * MXBean + * @param an {@code mxbeanInterface} type parameter * * @return the list of platform MXBeans that implement * {@code mxbeanInterface}. @@ -707,6 +715,7 @@ public class ManagementFactory { * @param mxbeanInterface a management interface for a platform * MXBean with one single instance in the Java virtual machine * being monitored, if implemented. + * @param an {@code mxbeanInterface} type parameter * * @return the platform MXBean proxy for * forwarding the method calls of the {@code mxbeanInterface} @@ -750,6 +759,7 @@ public class ManagementFactory { * @param connection the {@code MBeanServerConnection} to forward to. * @param mxbeanInterface a management interface for a platform * MXBean + * @param an {@code mxbeanInterface} type parameter * * @return the list of platform MXBean proxies for * forwarding the method calls of the {@code mxbeanInterface} diff --git a/jdk/src/share/classes/java/lang/management/MemoryMXBean.java b/jdk/src/share/classes/java/lang/management/MemoryMXBean.java index a18748991c1..356873d842c 100644 --- a/jdk/src/share/classes/java/lang/management/MemoryMXBean.java +++ b/jdk/src/share/classes/java/lang/management/MemoryMXBean.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003, 2008, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -49,11 +49,11 @@ import javax.management.openmbean.CompositeData; * It can be obtained by calling the * {@link PlatformManagedObject#getObjectName} method. * - * Memory
+ *Memory
* The memory system of the Java virtual machine manages * the following kinds of memory: * - *1. Heap
+ *1. Heap
* The Java virtual machine has a heap that is the runtime * data area from which memory for all class instances and arrays * are allocated. It is created at the Java virtual machine start-up. @@ -63,7 +63,7 @@ import javax.management.openmbean.CompositeData; *The heap may be of a fixed size or may be expanded and shrunk. * The memory for the heap does not need to be contiguous. * - *
2. Non-Heap Memory
+ *2. Non-Heap Memory
* The Java virtual machine manages memory other than the heap * (referred as non-heap memory). * @@ -87,7 +87,7 @@ import javax.management.openmbean.CompositeData; * machine code translated from the Java virtual machine code for * high performance. * - *Memory Pools and Memory Managers
+ *Memory Pools and Memory Managers
* {@link MemoryPoolMXBean Memory pools} and * {@link MemoryManagerMXBean memory managers} are the abstract entities * that monitor and manage the memory system @@ -105,7 +105,7 @@ import javax.management.openmbean.CompositeData; * add or remove memory managers during execution. * A memory pool can be managed by more than one memory manager. * - *Memory Usage Monitoring
+ *Memory Usage Monitoring
* * Memory usage is a very important monitoring attribute for the memory system. * The memory usage, for example, could indicate: @@ -131,7 +131,7 @@ import javax.management.openmbean.CompositeData; * certain threshold. It is not intended for an application to detect * and recover from a low memory condition. * - *Notifications
+ *Notifications
* *This MemoryMXBean is a * {@link javax.management.NotificationEmitter NotificationEmitter} @@ -169,7 +169,7 @@ import javax.management.openmbean.CompositeData; * MemoryNotificationInfo}. * *
- *NotificationEmitter
+ *NotificationEmitter
* The MemoryMXBean object returned by * {@link ManagementFactory#getMemoryMXBean} implements * the {@link javax.management.NotificationEmitter NotificationEmitter} diff --git a/jdk/src/share/classes/java/lang/management/MemoryNotificationInfo.java b/jdk/src/share/classes/java/lang/management/MemoryNotificationInfo.java index 3b0b156ee30..0c45555ee2e 100644 --- a/jdk/src/share/classes/java/lang/management/MemoryNotificationInfo.java +++ b/jdk/src/share/classes/java/lang/management/MemoryNotificationInfo.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003, 2006, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -212,7 +212,7 @@ public class MemoryNotificationInfo { * The given CompositeData must contain * the following attributes: *- *+ *
*
* Attribute Name *Type diff --git a/jdk/src/share/classes/java/lang/management/MemoryPoolMXBean.java b/jdk/src/share/classes/java/lang/management/MemoryPoolMXBean.java index bcd7c5559b0..82aa1fcda87 100644 --- a/jdk/src/share/classes/java/lang/management/MemoryPoolMXBean.java +++ b/jdk/src/share/classes/java/lang/management/MemoryPoolMXBean.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003, 2008, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -49,7 +49,7 @@ package java.lang.management; * It can be obtained by calling the * {@link PlatformManagedObject#getObjectName} method. * - *Memory Type
+ *Memory Type
*The Java virtual machine has a heap for object allocation and also * maintains non-heap memory for the method area and the Java virtual * machine execution. The Java virtual machine can have one or more @@ -60,7 +60,7 @@ package java.lang.management; *
- {@link MemoryType#NON_HEAP non-heap}
* * - *Memory Usage Monitoring
+ *Memory Usage Monitoring
* * A memory pool has the following attributes: *@@ -71,7 +71,7 @@ package java.lang.management; * (only supported by some garbage-collected memory pools) *
* - *1. Memory Usage
+ *1. Memory Usage
* * The {@link #getUsage} method provides an estimate * of the current usage of a memory pool. @@ -86,14 +86,14 @@ package java.lang.management; * the current memory usage. An implementation should document when * this is the case. * - *2. Peak Memory Usage
+ *2. Peak Memory Usage
* * The Java virtual machine maintains the peak memory usage of a memory * pool since the virtual machine was started or the peak was reset. * The peak memory usage is returned by the {@link #getPeakUsage} method * and reset by calling the {@link #resetPeakUsage} method. * - *3. Usage Threshold
+ *3. Usage Threshold
* * Each memory pool has a manageable attribute * called the usage threshold which has a default value supplied @@ -304,7 +304,7 @@ package java.lang.management; * * * - *4. Collection Usage Threshold
+ *4. Collection Usage Threshold
* * Collection usage threshold is a manageable attribute only applicable * to some garbage-collected memory pools. diff --git a/jdk/src/share/classes/java/lang/management/MemoryUsage.java b/jdk/src/share/classes/java/lang/management/MemoryUsage.java index 4dc23c0fe46..bbb75a26484 100644 --- a/jdk/src/share/classes/java/lang/management/MemoryUsage.java +++ b/jdk/src/share/classes/java/lang/management/MemoryUsage.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003, 2004, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -36,8 +36,7 @@ import sun.management.MemoryUsageCompositeData; * the heap or non-heap memory of the Java virtual machine as a whole. * *A MemoryUsage object contains four values: - *
- *
+ *
*
- * * * Below is a picture showing an example of a memory pool: ** *init *represents the initial amount of memory (in bytes) that @@ -78,7 +77,6 @@ import sun.management.MemoryUsageCompositeData; * *@@ -98,7 +96,7 @@ import sun.management.MemoryUsageCompositeData; * max * * - *
MXBean Mapping
+ *MXBean Mapping
* MemoryUsage is mapped to a {@link CompositeData CompositeData} * with attributes as specified in the {@link #from from} method. * @@ -254,7 +252,7 @@ public class MemoryUsage { * must contain the following attributes: **
- *+ *
*
* Attribute Name *Type diff --git a/jdk/src/share/classes/java/lang/management/MonitorInfo.java b/jdk/src/share/classes/java/lang/management/MonitorInfo.java index 658be133fda..e97a3173b9e 100644 --- a/jdk/src/share/classes/java/lang/management/MonitorInfo.java +++ b/jdk/src/share/classes/java/lang/management/MonitorInfo.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2006, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -32,7 +32,7 @@ import sun.management.MonitorInfoCompositeData; * Information about an object monitor lock. An object monitor is locked * when entering a synchronization block or method on that object. * - *MXBean Mapping
+ *MXBean Mapping
* MonitorInfo is mapped to a {@link CompositeData CompositeData} * with attributes as specified in * the {@link #from from} method. @@ -106,7 +106,7 @@ public class MonitorInfo extends LockInfo { * * mapped type for the {@link LockInfo} class: *- *+ *
*
* Attribute Name *Type diff --git a/jdk/src/share/classes/java/lang/management/RuntimeMXBean.java b/jdk/src/share/classes/java/lang/management/RuntimeMXBean.java index e4142d3e439..0e680fdf04e 100644 --- a/jdk/src/share/classes/java/lang/management/RuntimeMXBean.java +++ b/jdk/src/share/classes/java/lang/management/RuntimeMXBean.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003, 2008, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -272,7 +272,7 @@ public interface RuntimeMXBean extends PlatformManagedObject { * ** MBeanServer access:
- * The mapped type of Listis String[]. + * The mapped type of {@code List } is String[]. * * @return a list of String objects; each element * is an argument passed to the Java virtual machine. @@ -312,7 +312,7 @@ public interface RuntimeMXBean extends PlatformManagedObject { * {@link javax.management.openmbean.TabularData TabularData} * with two items in each row as follows: * - *+ *
*
* Item Name *Item Type diff --git a/jdk/src/share/classes/java/lang/management/ThreadInfo.java b/jdk/src/share/classes/java/lang/management/ThreadInfo.java index 676b698f5a2..e6f80b2eb23 100644 --- a/jdk/src/share/classes/java/lang/management/ThreadInfo.java +++ b/jdk/src/share/classes/java/lang/management/ThreadInfo.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003, 2012, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -33,13 +33,13 @@ import static java.lang.Thread.State.*; /** * Thread information. ThreadInfo contains the information * about a thread including: - *General thread information
+ *General thread information
**
* - *- Thread ID.
*- Name of the thread.
*Execution information
+ *Execution information
**
- Thread state.
*- The object upon which the thread is blocked due to: @@ -652,7 +652,7 @@ public class ThreadInfo { * The given CompositeData must contain the following attributes * unless otherwise specified below: *
- *+ *
*
* Attribute Name *Type @@ -722,7 +722,7 @@ public class ThreadInfo { * Each element is a CompositeData representing * StackTraceElement containing the following attributes: *- *+ *
*
* Attribute Name *Type diff --git a/jdk/src/share/classes/java/lang/management/ThreadMXBean.java b/jdk/src/share/classes/java/lang/management/ThreadMXBean.java index 30251d51f60..02a87dcf6d3 100644 --- a/jdk/src/share/classes/java/lang/management/ThreadMXBean.java +++ b/jdk/src/share/classes/java/lang/management/ThreadMXBean.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003, 2008, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -49,7 +49,7 @@ import java.util.Map; * It can be obtained by calling the * {@link PlatformManagedObject#getObjectName} method. * - *Thread ID
+ *Thread ID
* Thread ID is a positive long value returned by calling the * {@link java.lang.Thread#getId} method for a thread. * The thread ID is unique during its lifetime. When a thread @@ -58,7 +58,7 @@ import java.util.Map; *Some methods in this interface take a thread ID or an array * of thread IDs as the input parameter and return per-thread information. * - *
Thread CPU time
+ *Thread CPU time
* A Java virtual machine implementation may support measuring * the CPU time for the current thread, for any thread, or for no threads. * @@ -83,7 +83,7 @@ import java.util.Map; * Enabling thread CPU measurement could be expensive in some * Java virtual machine implementations. * - *Thread Contention Monitoring
+ *Thread Contention Monitoring
* Some Java virtual machines may support thread contention monitoring. * When thread contention monitoring is enabled, the accumulated elapsed * time that the thread has blocked for synchronization or waited for @@ -96,7 +96,7 @@ import java.util.Map; * {@link #setThreadContentionMonitoringEnabled} method can be used to enable * thread contention monitoring. * - *Synchronization Information and Deadlock Detection
+ *Synchronization Information and Deadlock Detection
* Some Java virtual machines may support monitoring of * {@linkplain #isObjectMonitorUsageSupported object monitor usage} and * {@linkplain #isSynchronizerUsageSupported ownable synchronizer usage}.