--- old/src/jdk.attach/share/classes/com/sun/tools/attach/spi/AttachProvider.java 2015-04-28 17:43:17.599600371 +0400 +++ new/src/jdk.attach/share/classes/com/sun/tools/attach/spi/AttachProvider.java 2015-04-28 17:43:17.331600371 +0400 @@ -41,7 +41,7 @@ * *
An attach provider is a concrete subclass of this class that has a * zero-argument constructor and implements the abstract methods specified - * below.
+ * below. * *An attach provider implementation is typically tied to a Java virtual * machine implementation, version, or even mode of operation. That is, a specific @@ -51,7 +51,7 @@ * Sun's HotSpot virtual machine. In general, if an environment * consists of Java virtual machines of different versions and from different * vendors then there will be an attach provider implementation for each - * family of implementations or versions.
+ * family of implementations or versions. * *An attach provider is identified by its {@link #name name} and * {@link #type type}. The name is typically, but not required to @@ -61,15 +61,15 @@ * implementation that uses the Doors inter-process communication mechanism * might use the type "doors". The purpose of the name and type is to * identify providers in environments where there are multiple providers - * installed.
+ * installed. * *AttachProvider implementations are loaded and instantiated at the first * invocation of the {@link #providers() providers} method. This method * attempts to load all provider implementations that are installed on the - * platform.
+ * platform. * *All of the methods in this class are safe for use by multiple - * concurrent threads.
+ * concurrent threads. * * @since 1.6 */ @@ -81,12 +81,12 @@ private static ListA Java virtual machine is identified by an abstract identifier. The * nature of this identifier is platform dependent but in many cases it will be the - * string representation of the process identifier (or pid).
+ * string representation of the process identifier (or pid). * * This method parses the identifier and maps the identifier to a Java
* virtual machine (in an implementation dependent manner). If the identifier
@@ -124,7 +124,7 @@
* that does not exist, or it corresponds to a Java virtual machine that does not support
* the attach mechanism implemented by this provider, or it detects that the
* Java virtual machine is a version to which this provider cannot attach, then
- * an AttachNotSupportedException
is thrown.
id
is null
+ * If {@code id} is {@code null}
*/
public abstract VirtualMachine attachVirtualMachine(String id)
throws AttachNotSupportedException, IOException;
@@ -170,7 +170,7 @@
* @throws SecurityException
* If a security manager has been installed and it denies
* {@link com.sun.tools.attach.AttachPermission AttachPermission}
- * ("attachVirtualMachine"), or other permission
+ * ("{@code attachVirtualMachine}"), or other permission
* required by the implementation.
*
* @throws AttachNotSupportedException
@@ -183,7 +183,7 @@
* If some other I/O error occurs
*
* @throws NullPointerException
- * If vmd
is null
+ * If {@code vmd} is {@code null}
*/
public VirtualMachine attachVirtualMachine(VirtualMachineDescriptor vmd)
throws AttachNotSupportedException, IOException
@@ -199,7 +199,7 @@
*
* This method returns a list of {@link
* com.sun.tools.attach.VirtualMachineDescriptor} elements. Each
- * VirtualMachineDescriptor
describes a Java virtual machine
+ * {@code VirtualMachineDescriptor} describes a Java virtual machine
* to which this provider can potentially attach. There isn't any
* guarantee that invoking {@link #attachVirtualMachine(VirtualMachineDescriptor)
* attachVirtualMachine} on each descriptor in the list will succeed.
@@ -216,31 +216,31 @@
*
An AttachProvider is installed on the platform if: * *
It is installed in a JAR file that is visible to the defining + *
The JAR file contains a provider configuration named - * com.sun.tools.attach.spi.AttachProvider in the resource directory - * META-INF/services.
The provider configuration file lists the full-qualified class - * name of the AttachProvider implementation.
The format of the provider configuration file is one fully-qualified * class name per line. Space and tab characters surrounding each class name, * as well as blank lines are ignored. The comment character is - * '#' (0x23), and on each line all characters following + * {@code '#'} ({@code 0x23}), and on each line all characters following * the first comment character are ignored. The file must be encoded in - * UTF-8.
+ * UTF-8. * *AttachProvider implementations are loaded and instantiated * (using the zero-arg constructor) at the first invocation of this method. * The list returned by the first invocation of this method is the list * of providers. Subsequent invocations of this method return a list of the same - * providers. The list is unmodifable.
+ * providers. The list is unmodifable. * * @return A list of the installed attach providers. */