# HG changeset patch # User jjg # Date 1502218862 25200 # Node ID 3abb2959292f0a8f390a633b9410b3ec12634347 # Parent 5196af7549571a80d6aed2f8f590b73a9c69640a 8185867: fix a11y and html issues in jdk.jdi docs Reviewed-by: alanb diff -r 5196af754957 -r 3abb2959292f jdk/src/jdk.jdi/share/classes/com/sun/jdi/InvalidModuleException.java --- a/jdk/src/jdk.jdi/share/classes/com/sun/jdi/InvalidModuleException.java Tue Aug 08 21:37:38 2017 +0800 +++ b/jdk/src/jdk.jdi/share/classes/com/sun/jdi/InvalidModuleException.java Tue Aug 08 12:01:02 2017 -0700 @@ -28,7 +28,6 @@ /** * Thrown to indicate that the requested module is invalid * or became invalid after the module was unloaded. - *

* * @since 9 */ diff -r 5196af754957 -r 3abb2959292f jdk/src/jdk.jdi/share/classes/com/sun/jdi/JDIPermission.java --- a/jdk/src/jdk.jdi/share/classes/com/sun/jdi/JDIPermission.java Tue Aug 08 21:37:38 2017 +0800 +++ b/jdk/src/jdk.jdi/share/classes/com/sun/jdi/JDIPermission.java Tue Aug 08 12:01:02 2017 -0700 @@ -40,17 +40,20 @@ * permission allows, and discusses the risks of granting code the * permission. * - * + *
* + * * - * - * - * + * + * + * * + * * + * * - * + * * @@ -59,6 +62,7 @@ * misbehave. * * + * * *
Table shows permission target name, what the * permission allows, and associated risks
Permission Target NameWhat the Permission AllowsRisks of Allowing this PermissionPermission Target NameWhat the Permission AllowsRisks of Allowing this Permission
virtualMachineManagervirtualMachineManagerAbility to inspect and modify the JDI objects in the * {@code VirtualMachineManager} *
* diff -r 5196af754957 -r 3abb2959292f jdk/src/jdk.jdi/share/classes/com/sun/jdi/Type.java --- a/jdk/src/jdk.jdi/share/classes/com/sun/jdi/Type.java Tue Aug 08 21:37:38 2017 +0800 +++ b/jdk/src/jdk.jdi/share/classes/com/sun/jdi/Type.java Tue Aug 08 12:01:02 2017 -0700 @@ -43,79 +43,86 @@ * {@link ArrayType#componentType()} * *

- * The following table illustrates which subinterfaces of Type + * The following tables illustrate which subinterfaces of Type * are used to mirror types in the target VM -- - * - * - * - * - * - * - * + *
Maps each type declared in target to a mirrored - * instance of a subinterface of PrimitiveType or ReferenceType"
Subinterfaces of {@link PrimitiveType}
Type declared in target asIs mirrored as an instance of
+ * + * * - * - * + * + * + * + * + * + * + * * - * - * + * + * * - * - * + * + * + * + * + * * - * - * + * + * * - * - * + * + * * - * - * + * + * * - * - * - * - * - * + * + * * - * - * - * - * - * - * - * - * + * + * + * + *
Subinterfaces of {@link PrimitiveType}
boolean {@link BooleanType}Type declared in target asIs mirrored as an instance of
boolean {@link BooleanType}
byte{@link ByteType}byte{@link ByteType}
char{@link CharType}char{@link CharType}
double{@link DoubleType}
double{@link DoubleType}float{@link FloatType}
float{@link FloatType}int{@link IntegerType}
int{@link IntegerType}long{@link LongType}
long{@link LongType}
short{@link ShortType}short{@link ShortType}
void{@link VoidType}
Subinterfaces of {@link ReferenceType}
Type declared in target asFor exampleIs mirrored as an instance ofvoid{@link VoidType}
+ * + * + * + * * - * - * - * + * + * + * + * + * * - * - * - * + * + * + * * - * - * - * + * + * + * * - * - * - * + * + * + * + * + * + * * - * - * - * + * * - * - * - * + * + * *
Subinterfaces of {@link ReferenceType}
a classDate{@link ClassType}Type declared in target asFor exampleIs mirrored as an instance of
an interfaceRunnable{@link InterfaceType}a classDate{@link ClassType}
an array {@link ArrayType}an interfaceRunnable{@link InterfaceType}
an arrayint[]{@link ArrayType} whose + * an array(any){@link ArrayType}
int[]{@link ArrayType} whose * {@link ArrayType#componentType() componentType()} is * {@link IntegerType}
an arrayDate[]{@link ArrayType} whose + * + * Date[]{@link ArrayType} whose * {@link ArrayType#componentType() componentType()} is * {@link ClassType}
an arrayRunnable[]{@link ArrayType} whose + * + * Runnable[]{@link ArrayType} whose * {@link ArrayType#componentType() componentType()} is * {@link InterfaceType}
* * @see PrimitiveType Subinterface PrimitiveType diff -r 5196af754957 -r 3abb2959292f jdk/src/jdk.jdi/share/classes/com/sun/jdi/Value.java --- a/jdk/src/jdk.jdi/share/classes/com/sun/jdi/Value.java Tue Aug 08 21:37:38 2017 +0800 +++ b/jdk/src/jdk.jdi/share/classes/com/sun/jdi/Value.java Tue Aug 08 12:01:02 2017 -0700 @@ -33,7 +33,7 @@ * value hierarchy encompassing primitive values and object values. *

* Some examples of where values may be accessed: - *

+ *
layout
* *
{@link ObjectReference#getValue(Field) * ObjectReference.getValue(Field)} @@ -52,117 +52,130 @@ * - returned with an event *
*

- * The following table illustrates which subinterfaces of Value + * The following tables illustrate which subinterfaces of Value * are used to mirror values in the target VM -- - * - * - * - * - * - * - * - * - * + *
Maps each kind of value to a mirrored - * instance of a subinterface of Value
Subinterfaces of {@link PrimitiveValue}
Kind of valueFor example -
expression in target		Is mirrored as an
instance of		{@link Type} of value
{@link #type() Value.type()}
+ * + * * - * - * - * - * + * + * + * + * + * + * * - * - * - * - * + * + * + * + * + * + * + * + * + * * - * - * - * - * + * + * + * + * * - * - * - * - * + * + * + * + * * - * - * - * - * + * + * + * + * * - * - * - * - * + * + * + * + * * - * - * - * - * + * + * + * + * * - * - * - * - * + * + * + * + * * - * - * - * - * - * - * - * - * - * - * - * + * + * + * + * + * + *
Subinterfaces of {@link PrimitiveValue}
a boolean {@code true} {@link BooleanValue} {@link BooleanType}Kind of valueFor example -
expression in target		Is mirrored as an
instance of		{@link Type} of value
{@link #type() Value.type()}
a byte {@code (byte)4} {@link ByteValue} {@link ByteType}a boolean{@code true}{@link BooleanValue}{@link BooleanType}
a byte{@code (byte)4}{@link ByteValue}{@link ByteType}
a char {@code 'a'} {@link CharValue} {@link CharType}a char{@code 'a'}{@link CharValue}{@link CharType}
a double {@code 3.1415926} {@link DoubleValue} {@link DoubleType}a double{@code 3.1415926}{@link DoubleValue}{@link DoubleType}
a float {@code 2.5f} {@link FloatValue} {@link FloatType}a float{@code 2.5f}{@link FloatValue}{@link FloatType}
an int {@code 22} {@link IntegerValue} {@link IntegerType}an int{@code 22}{@link IntegerValue}{@link IntegerType}
a long {@code 1024L} {@link LongValue} {@link LongType}a long{@code 1024L}{@link LongValue}{@link LongType}
a short {@code (short)12} {@link ShortValue} {@link ShortType}a short{@code (short)12}{@link ShortValue}{@link ShortType}
a void {@link VoidValue} {@link VoidType}
Subinterfaces of {@link ObjectReference}
Kind of valueFor example -
expression in target		Is mirrored as an
instance of		{@link Type} of value
{@link #type() Value.type()}		a void{@link VoidValue}{@link VoidType}
+ * + * + * + * * - * - * - * - * + * + * + * + * + * + * * - * - * - * - * + * + * + * + * * - * - * - * - * + * + * + * + * + * + * + * + * + * * - * - * - * - * + * + * + * + * * - * - * - * - * + * + * + * + * * - * - * - * - * + * + * + * + * * - * - * - * - * - * - * - * - * - * - * - * + * + * + * + * + * + *
Subinterfaces of {@link ObjectReference}
a class instance {@code this} {@link ObjectReference} {@link ClassType}Kind of valueFor example -
expression in target		Is mirrored as an
instance of		{@link Type} of value
{@link #type() Value.type()}
an array {@code new int[5]} {@link ArrayReference} {@link ArrayType}a class instance{@code this}{@link ObjectReference}{@link ClassType}
a string {@code "hello"} {@link StringReference} {@link ClassType}an array{@code new int[5]}{@link ArrayReference}{@link ArrayType}
a string{@code "hello"}{@link StringReference}{@link ClassType}
a thread {@code Thread.currentThread()} {@link ThreadReference} {@link ClassType}a thread{@code Thread.currentThread()}{@link ThreadReference}{@link ClassType}
a thread group {@code Thread.currentThread()}
  {@code .getThreadGroup()}		 {@link ThreadGroupReference} {@link ClassType}a thread group{@code Thread.currentThread()}
  {@code .getThreadGroup()}		{@link ThreadGroupReference}{@link ClassType}
a {@code java.lang.Class}
instance		 {@code this.getClass()} {@link ClassObjectReference} {@link ClassType}a {@code java.lang.Class}
instance		{@code this.getClass()}{@link ClassObjectReference}{@link ClassType}
a class loader {@code this.getClass()}
  {@code .getClassLoader()}		 {@link ClassLoaderReference} {@link ClassType}
Other
Kind of valueFor example -
expression in target		Is mirrored as{@link Type} of valuea class loader{@code this.getClass()}
  {@code .getClassLoader()}		{@link ClassLoaderReference}{@link ClassType}
+ * + * + * + * * - * - * - * - * + * + * + * + * + * + * + * + * + * + * + * + * *
Other values
null {@code null} {@code null} n/aKind of valueFor example -
expression in target		Is mirrored as{@link Type} of value
null{@code null}{@code null}n/a
* * @author Robert Field diff -r 5196af754957 -r 3abb2959292f jdk/src/jdk.jdi/share/classes/com/sun/jdi/VirtualMachineManager.java --- a/jdk/src/jdk.jdi/share/classes/com/sun/jdi/VirtualMachineManager.java Tue Aug 08 21:37:38 2017 +0800 +++ b/jdk/src/jdk.jdi/share/classes/com/sun/jdi/VirtualMachineManager.java Tue Aug 08 12:01:02 2017 -0700 @@ -59,13 +59,16 @@ * Some {@link Connector} implementations may require slightly * different handling than presented below. * - * + *
* + * * - * - * + * + * + * + * * - * + * * * * * - * + * * * * - * + * * * * - * + * *
Four scenarios for connecting a debugger to a virtual machine"
ScenarioDescriptionScenarioDescription
Debugger launches target VM (simplest, most-common scenario)Debugger launches target VM (simplest, most-common scenario)Debugger calls the {@link LaunchingConnector#launch(java.util.Map)} * method of the default connector, obtained with {@link #defaultConnector}. The @@ -86,7 +89,7 @@ *
Debugger attaches to previously-running VMDebugger attaches to previously-running VM *
    *
  • @@ -113,7 +116,7 @@ *
Target VM attaches to previously-running debuggerTarget VM attaches to previously-running debugger *
    *
  • @@ -146,7 +149,7 @@ *
Target VM launches debugger (sometimes called "Just-In-Time" debugging)Target VM launches debugger (sometimes called "Just-In-Time" debugging) *
    *
  • diff -r 5196af754957 -r 3abb2959292f jdk/src/jdk.jdi/share/classes/com/sun/jdi/doc-files/signature.html --- a/jdk/src/jdk.jdi/share/classes/com/sun/jdi/doc-files/signature.html Tue Aug 08 21:37:38 2017 +0800 +++ b/jdk/src/jdk.jdi/share/classes/com/sun/jdi/doc-files/signature.html Tue Aug 08 12:01:02 2017 -0700 @@ -1,34 +1,42 @@ - + JDI Type Signatures + +
    - - + + + +
    JDI Type Signatures
    Type Signature -Java Type -
    Zboolean -
    Bbyte -
    Cchar -
    Sshort -
    Iint -
    Jlong -
    Ffloat -
    Ddouble -
    L fully-qualified-class +
    JDI Type Signatures
    Type Signature +Java Type +
    Zboolean +
    Bbyte +
    Cchar +
    Sshort +
    Iint +
    Jlong +
    Ffloat +
    Ddouble +
    L fully-qualified-class ; fully-qualified-class -
    [ type +
    [ type type[] -
    +
    ( arg-types ) ret-type method type (including constructors) +

    For example, the Java method: