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

[Daniel D. Daugherty]

Thumbs up!

Dan


On 1/21/13 6:21 AM, 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
>
>
> 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>