8006565: java.lang.instrument specification should make it clear that -javaagent is optional

[Alan Bateman]

The optionally of JVM TI is clear in its specification, the status of 
java.lang.management, or more specifically the -javaagent option is less 
clear. The change proposed here is to make it very clear that -javaagent 
is not required to be supported. The motive is small environments where 
it should not be necessary to have a way to start tool agents even 
though there may be command-line support.

Thanks,

-Alan


diff --git a/src/share/classes/java/lang/instrument/package.html 
b/src/share/classes/java/lang/instrument/package.html
--- a/src/share/classes/java/lang/instrument/package.html
+++ b/src/share/classes/java/lang/instrument/package.html
@@ -53,8 +53,10 @@
<h3>Command-Line Interface</h3>

<P>
-On implementations with a command-line interface, an agent is started by
-adding this option to the command-line:
+An implementation is not required to provide a way to start agents from the
+command-line. Where an implementation does provide a way to start 
agents from
+the command-line, then an agent is started by adding this option to the
+command-line:
<blockquote>
<code><b>-javaagent:</b></code><i>jarpath[</i><code><b>=</b></code><i>options]</i>
</blockquote>