A DESCRIPTION OF THE PROBLEM :
The following methods are documented to take a fully qualified name an input. However, when called within the JDK, a binary name rather than a fully qualified name is provided.
Furthermore, the code does not require any particular string format: it operates correctly with any string. Therefore, the documentation of these methods should be changed either to indicate that the arguments are binary name or to indicate that the arguments are arbitrary strings.
We explain each of these locations in detail below. For convenience, the missing documentation is grouped by the .java file that contains it.
We explain each of these documentation bugs in detail below.
Attached to this bug report, we also include a patch file that offers one fix: changing 'fully qualified name' to 'binary name'.

  Bug #1:
Explanation : String java.lang.management.LockInfo.getClassName() is documented to return a fully qualified name, however it should be a binary name or an arbitrary name.
Reason : In the source code, the result of this method is assigned (in the package private constructor) to the result of java.lang.Class.getName(). Class.getName() is compatible with Class.forName(...), which requires a binary name (so Class.getName() returns a binary name).
More interestingly, the result of this method can be assigned to anything arbitrary by using the public constructor. Though documented to require a fully qualified name (which is wrong, see bug #2), the constructor does not do any checks for the passed String, so any arbitrary string can be passed to the public constructor.
Example program :
=================
package jdk7;

public class LockInfo
{
public static void main(String [] args)
{
String arbitraryName = "University of Washington";
java.lang.management.LockInfo lockInfo = new java.lang.management.LockInfo(arbitraryName, arbitraryName.hashCode());
System.out.println(lockInfo.getClassName());
}
}
=================
Expected output (documented behavior) : A fully qualified name (since documented as like that).
Actual output : University of Washington

  Bug #2:
Note : This bug is related to bug #1.
Explanation : java.lang.management.LockInfo.LockInfo(String, int) is documented to take a fully qualified name (as String argument), however it should be a binary name or an arbitrary string.
Reason : In the source code, the field 'className' is set to this String argument. However, if the package private constructor is used 'className' is assigned to the result of java.lang.Class.getName(), which returns a binary name (see discussion for bug #01).
Example program :
=================
package jdk7;

public class LockInfo
{
public static void main(String [] args)
{
String arbitraryName = "University of Washington";
java.lang.management.LockInfo lockInfo = new java.lang.management.LockInfo(arbitraryName, arbitraryName.hashCode());
}
}
=================
Expected output (documented behavior) : Some kind of error or warning since the constructor is called with an arbitrary String.
Actual output : Nothing, arbitrary string is accepted.

  Bug #03:
Note : This bug is related to bug #1 and very similar to #2.
Explanation : java.lang.management.MonitorInfo.MonitorInfo(String, int) is documented to take a fully qualified name (as String argument), however it should be a binary name or an arbitrary string.
Reason : In the source code, the field 'className' (of LockInfo, which is super class of MonitorInfo) is set to this String argument. However, if the package private constructor (of LockInfo) is used 'className' is assigned to the result of java.lang.Class.getName(), which returns a binary name (see discussion for bug #01).
Example program :
=================
package jdk7;

public class MonitorInfo
{
public static void main(String [] args)
{
String arbitraryName = "University of Washington";
java.lang.management.MonitorInfo monitorInfo = new java.lang.management.MonitorInfo(arbitraryName, arbitraryName.hashCode(), -1, null);
}
}
=================
Expected output (documented behavior) : Some kind of error or warning since the constructor is called with an arbitrary String.
Actual output : Nothing, arbitrary string is accepted.



EXPECTED VERSUS ACTUAL BEHAVIOR :
EXPECTED -
I provide a patch below that will fix the documentation bugs by replacing 'fully qualified name' usages to 'binary name'.

=== Patch starts here ===
diff -r -u -b Java7_b125_errors_missing_documentation/src/share/classes/java/lang/management/LockInfo.java Java7_b125_all/src/share/classes/java/lang/management/LockInfo.java
--- Java7_b125_errors_missing_documentation/src/share/classes/java/lang/management/LockInfo.java 2011-02-06 19:46:45.000000000 -0800
+++ Java7_b125_all/src/share/classes/java/lang/management/LockInfo.java 2011-02-06 19:58:34.000000000 -0800
@@ -63,7 +63,7 @@
     /**
      * Constructs a <tt>LockInfo</tt> object.
      *
- * @param className the fully qualified name of the class of the lock object.
+ * @param className the binary name of the class of the lock object.
      * @param identityHashCode the {@link System#identityHashCode
      * identity hash code} of the lock object.
      */
@@ -85,9 +85,9 @@
     }
 
     /**
- * Returns the fully qualified name of the class of the lock object.
+ * Returns the binary name of the class of the lock object.
      *
- * @return the fully qualified name of the class of the lock object.
+ * @return the binary name of the class of the lock object.
      */
     public String getClassName() {
         return className;
diff -r -u -b Java7_b125_errors_missing_documentation/src/share/classes/java/lang/management/MonitorInfo.java Java7_b125_all/src/share/classes/java/lang/management/MonitorInfo.java
--- Java7_b125_errors_missing_documentation/src/share/classes/java/lang/management/MonitorInfo.java 2011-02-06 19:34:28.000000000 -0800
+++ Java7_b125_all/src/share/classes/java/lang/management/MonitorInfo.java 2011-02-06 19:58:34.000000000 -0800
@@ -48,7 +48,7 @@
     /**
      * Construct a <tt>MonitorInfo</tt> object.
      *
- * @param className the fully qualified name of the class of the lock object.
+ * @param className the binary name of the class of the lock object.
      * @param identityHashCode the {@link System#identityHashCode
      * identity hash code} of the lock object.
      * @param stackDepth the depth in the stack trace where the object monitor

ACTUAL -
Actual text is provided in 'Expected' section (inside the patch).

URL OF FAULTY DOCUMENTATION :
http://download.java.net/jdk7/docs/api/