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

[Alan Bateman]

On 21/01/2013 13:21, Alan Bateman wrote:
>
> 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
Just to say that there was additional feedback on the proposed wording. 
Attached is what I propose to push now. I don't think this requires any 
further reviews.

-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 interface. On implementations that do provide a way to 
start agents
+from the command-line interface, 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>