--- 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 List providers = null; /** - * Initializes a new instance of this class.

+ * Initializes a new instance of this class. * * @throws SecurityException * If a security manager has been installed and it denies * {@link com.sun.tools.attach.AttachPermission AttachPermission} - * ("createAttachProvider") + * ("{@code createAttachProvider}") */ protected AttachProvider() { SecurityManager sm = System.getSecurityManager(); @@ -95,14 +95,14 @@ } /** - * Return this provider's name.

+ * Return this provider's name. * * @return The name of this provider */ public abstract String name(); /** - * Return this provider's type.

+ * Return this provider's type. * * @return The type of this provider */ @@ -113,7 +113,7 @@ * *

A 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.

+ * an {@code AttachNotSupportedException} is thrown. * * @param id * The abstract identifier that identifies the Java virtual machine. @@ -134,7 +134,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 @@ -147,7 +147,7 @@ * If some other I/O error occurs * * @throws NullPointerException - * If 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: * *

* *

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. */