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

[Staffan Larsen]

Looks good.

/Staffan

On 21 jan 2013, at 14:21, Alan Bateman <Alan.Bateman at oracle.com> 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>