May throw an unspecified error if initialization of the * {@link com.sun.jdi.VirtualMachineManager} fails or if * the virtual machine manager is unable to locate or create - * any {@link com.sun.jdi.connect.Connector Connectors}.
- *+ * any {@link com.sun.jdi.connect.Connector Connectors}. + * * @throws java.lang.SecurityException if a security manager has been * installed and it denies {@link JDIPermission} - * ("virtualMachineManager") or other unspecified + * ("{@code virtualMachineManager}") or other unspecified * permissions required by the implementation. - *
*/ static public synchronized VirtualMachineManager virtualMachineManager() { return com.sun.tools.jdi.VirtualMachineManagerImpl.virtualMachineManager(); --- old/src/jdk.jdi/share/classes/com/sun/jdi/Field.java 2015-04-24 19:20:47.003879547 +0400 +++ new/src/jdk.jdi/share/classes/com/sun/jdi/Field.java 2015-04-24 19:20:46.771879547 +0400 @@ -65,22 +65,22 @@ * short s; * Date d; * byte[] ba; - * And the JDI client defines theseField objects:
+ * And the JDI client defines these {@code Field} objects:
*
* Field sField = targetClass.fieldByName("s");
* Field dField = targetClass.fieldByName("d");
* Field baField = targetClass.fieldByName("ba");
- * to mirror the corresponding fields, then sField.type()
- * is a {@link ShortType}, dField.type() is the
- * {@link ReferenceType} for java.util.Date and
- * ((ArrayType)(baField.type())).componentType() is a
+ * to mirror the corresponding fields, then {@code sField.type()}
+ * is a {@link ShortType}, {@code dField.type()} is the
+ * {@link ReferenceType} for {@code java.util.Date} and
+ * {@code ((ArrayType)(baField.type())).componentType()} is a
* {@link ByteType}.
*
* Note: if the type of this field is a reference type (class,
* interface, or array) and it has not been created or loaded
* by the declaring type's class loader - that is,
- * {@link TypeComponent#declaringType declaringType()}
- * .classLoader(),
+ * {@link TypeComponent#declaringType declaringType()}
+ * {@code .classLoader()},
* then ClassNotLoadedException will be thrown.
* Also, a reference type may have been loaded but not yet prepared,
* in which case the type will be returned
@@ -100,28 +100,28 @@
/**
* Determine if this is a transient field.
*
- * @return true if this field is transient; false otherwise.
+ * @return {@code true} if this field is transient; {@code false} otherwise.
*/
boolean isTransient();
/**
* Determine if this is a volatile field.
*
- * @return true if this field is volatile; false otherwise.
+ * @return {@code true} if this field is volatile; {@code false} otherwise.
*/
boolean isVolatile();
/**
* Determine if this is a field that represents an enum constant.
- * @return true if this field represents an enum constant;
- * false otherwise.
+ * @return {@code true} if this field represents an enum constant;
+ * {@code false} otherwise.
*/
boolean isEnumConstant();
/**
* Compares the specified Object with this field for equality.
*
- * @return true if the Object is a Field and if both
+ * @return {@code true} if the Object is a Field and if both
* mirror the same field (declared in the same class or interface, in
* the same VM).
*/
@@ -130,7 +130,7 @@
/**
* Returns the hash code value for this Field.
*
- * @return the integer hash code
+ * @return the integer hash code.
*/
int hashCode();
}
--- old/src/jdk.jdi/share/classes/com/sun/jdi/JDIPermission.java 2015-04-24 19:20:47.575879547 +0400
+++ new/src/jdk.jdi/share/classes/com/sun/jdi/JDIPermission.java 2015-04-24 19:20:47.343879547 +0400
@@ -26,20 +26,20 @@
package com.sun.jdi;
/**
- * The JDIPermission class represents access rights to
- * the VirtualMachineManager. This is the permission
+ * The {@code JDIPermission} class represents access rights to
+ * the {@code VirtualMachineManager}. This is the permission
* which the SecurityManager will check when code that is running with
* a SecurityManager requests access to the VirtualMachineManager, as
* defined in the Java Debug Interface (JDI) for the Java platform.
*
- * A JDIPermission object contains a name (also referred
+ * A {@code JDIPermission} object contains a name (also referred
* to as a "target name") but no actions list; you either have the
* named permission or you don't.
*
* The following table provides a summary description of what the * permission allows, and discusses the risks of granting code the * permission. - *
+ * *
| virtualMachineManager | *Ability to inspect and modify the JDI objects in the
- * VirtualMachineManager
+ * {@code VirtualMachineManager}
* |
* This allows an attacker to control the
- * VirtualMachineManager and cause the system to
+ * {@code VirtualMachineManager} and cause the system to
* misbehave.
* |
* {@link Type} of value {@link #type() Value.type()} |
* ||||
|---|---|---|---|---|---|---|---|
| a boolean | - * true |
+ * {@code true} | *{@link BooleanValue} | *{@link BooleanType} | *|||
| a byte | - * (byte)4 |
+ * {@code (byte)4} | *{@link ByteValue} | *{@link ByteType} | *|||
| a char | - * 'a' |
+ * {@code 'a'} | *{@link CharValue} | *{@link CharType} | *|||
| a double | - * 3.1415926 |
+ * {@code 3.1415926} | *{@link DoubleValue} | *{@link DoubleType} | *|||
| a float | - * 2.5f |
+ * {@code 2.5f} | *{@link FloatValue} | *{@link FloatType} | *|||
| an int | - * 22 |
+ * {@code 22} | *{@link IntegerValue} | *{@link IntegerType} | *|||
| a long | - * 1024L |
+ * {@code 1024L} | *{@link LongValue} | *{@link LongType} | *|||
| a short | - * (short)12 |
+ * {@code (short)12} | *{@link ShortValue} | *{@link ShortType} | *|||
| a void | - * |
+ * * | {@link VoidValue} | *{@link VoidType} | *|||
| {@link Type} of value {@link #type() Value.type()} |
* |||||||
| a class instance | - * this |
+ * {@code this} | *{@link ObjectReference} | *{@link ClassType} | *|||
| an array | - * new int[5] |
+ * {@code new int[5]} | *{@link ArrayReference} | *{@link ArrayType} | *|||
| a string | - * "hello" |
+ * {@code "hello"} | *{@link StringReference} | *{@link ClassType} | *|||
| a thread | - * Thread.currentThread() |
+ * {@code Thread.currentThread()} | *{@link ThreadReference} | *{@link ClassType} | *|||
| a thread group | - * Thread.currentThread() |
+ * {@code Thread.currentThread()} {@code .getThreadGroup()} |
* {@link ThreadGroupReference} | *{@link ClassType} | *|||
a java.lang.Classinstance |
- * this.getClass() |
+ * a {@code java.lang.Class} instance |
+ * {@code this.getClass()} | *{@link ClassObjectReference} | *{@link ClassType} | *||
| a class loader | - * this.getClass() |
+ * {@code this.getClass()} {@code .getClassLoader()} |
* {@link ClassLoaderReference} | *{@link ClassType} | *|||
| Other | *|||||||
| Kind of value - * | For example - expression in target - * | Is mirrored as - * | {@link Type} of value + * | Kind of value | + *For example - expression in target |
+ * Is mirrored as | + *{@link Type} of value | *
| null | - * null |
- * null |
+ * {@code null} | + *{@code null} | *n/a | *||
+ * *
| Target VM attaches to previously-running debugger | *
+ *
|
* ||
| Target VM launches debugger (sometimes called "Just-In-Time" debugging) | *
+ *
|
*
A Connection is safe for access by multiple concurrent threads, * although at most one thread may be reading and at most one thread may - * be writing at any given time.
+ * be writing at any given time. * * @since 1.5 */ @@ -70,18 +70,18 @@ * *Reading a packet does not do any integrity checking on * the packet aside from a check that the length of the packet - * (as indicated by the value of the length field, the + * (as indicated by the value of the {@code length} field, the * first four bytes of the packet) is 11 or more bytes. - * If the value of the length value is less then 11 - * then an IOException is thrown. + * If the value of the {@code length} value is less then 11 + * then an {@code IOException} is thrown. * *
Returns a byte array of a length equal to the length * of the received packet, or a byte array of length 0 when an * end of stream is encountered. If end of stream is encountered * after some, but not all bytes of a packet, are read then it - * is considered an I/O error and an IOException is + * is considered an I/O error and an {@code IOException} is * thrown. The first byte of the packet is stored in element - * 0 of the byte array, the second in element 1, + * {@code 0} of the byte array, the second in element {@code 1}, * and so on. The bytes in the byte array are laid out as per the * * JDWP specification. That is, all fields in the packet @@ -90,7 +90,7 @@ *
This method may be invoked at any time. If another thread has * already initiated a {@link #readPacket readPacket} on this * connection then the invocation of this method will block until the - * first operation is complete.
+ * first operation is complete. * * @return the packet read from the target VM * @@ -123,21 +123,21 @@ * href="../../../../../../../../../technotes/guides/jpda/jdwp-spec.html"> * JDWP specification. That is, all fields in the packet * are in big endian order. The first byte, that is element - * pkt[0], is the first byte of the length field. - * pkt[1] is the second byte of the length field, + * {@code pkt[0]}, is the first byte of the {@code length} field. + * {@code pkt[1]} is the second byte of the {@code length} field, * and so on. * *Writing a packet does not do any integrity checking on * the packet aside from checking the packet length. Checking * the packet length requires checking that the value of the - * length field (as indicated by the first four bytes + * {@code length} field (as indicated by the first four bytes * of the packet) is 11 or greater. Consequently the length of * the byte array provided to this method, that is - * pkt.length, must be 11 or more, and must be equal - * or greater than the value of the length field. If the + * {@code pkt.length}, must be 11 or more, and must be equal + * or greater than the value of the {@code length} field. If the * length of the byte array is greater than the value of - * the length field then all bytes from element - * pkt[length] onwards are ignored. In other words, + * the {@code length} field then all bytes from element + * {@code pkt[length]} onwards are ignored. In other words, * any additional bytes that follow the packet in the byte * array are ignored and will not be transmitted to the target * VM. @@ -152,7 +152,7 @@ *
This method may be invoked at any time. If another thread has * already initiated a write operation upon this Connection then * a subsequent invocation of this method will block until the first - * operation is complete.
+ * operation is complete. * * @param pkt * The packet to write to the target VM. @@ -165,7 +165,7 @@ * If an I/O error occurs. * * @throws IllegalArgumentException - * If the value of the length field is invalid, + * If the value of the {@code length} field is invalid, * or the byte array is of insufficient length. */ public abstract void writePacket(byte pkt[]) throws IOException; @@ -185,7 +185,7 @@ *This method may be invoked at any time. If some other thread has * already invoked it, however, then another invocation will block until * the first invocation is complete, after which it will return without - * effect.
+ * effect. * * @throws java.io.IOException * If an I/O error occurs @@ -193,9 +193,9 @@ public abstract void close() throws IOException; /** - * Tells whether or not this connection is open. + * Tells whether or not this connection is open. * - * @return true if, and only if, this connection is open + * @return {@code true} if and only if this connection is open */ public abstract boolean isOpen(); } --- old/src/jdk.jdi/share/classes/com/sun/jdi/doc-files/signature.html 2015-04-24 19:20:50.447879544 +0400 +++ new/src/jdk.jdi/share/classes/com/sun/jdi/doc-files/signature.html 2015-04-24 19:20:50.215879545 +0400 @@ -7,7 +7,7 @@| Type Signature | Java Type |
|---|---|
| Z | boolean @@ -31,9 +31,9 @@ |
For example, the Java method: -
long f (int n, String s, int[] arr); +long f (int n, String s, int[] arr);has the following type signature: -(ILjava/lang/String;[I)J +(ILjava/lang/String;[I)J