RFR: 8263323: Debug Agent help output includes invalid URL

[Alan Bateman]

On Fri, 4 Jun 2021 03:36:26 GMT, Chris Plummer <cjplummer at openjdk.org> wrote:

> Rather than embed a URL in the help output, which needs to be updated if the location of docs ever changes, just include a description of the document so it can be looked up. The output now looks like:
> 
> 
> $ ./java -agentlib:jdwp=help
>                Java Debugger JDWP Agent Library
>                --------------------------------
> 
>   (See the "Oracle VM Invocation Options" section of the JPDA
>    "Connection and Invocation Details" document for more information.)
> 
> jdwp usage: java -agentlib:jdwp=[help]|[<option>=<value>, ...]
> 
> Option Name and Value            Description                       Default
> ---------------------            -----------                       -------
> suspend=y|n                      wait on startup?                  y
> transport=<name>                 transport spec                    none
> ...

src/jdk.jdwp.agent/share/native/libjdwp/debugInit.c line 862:

> 860:  "               --------------------------------\n"
> 861:  "\n"
> 862:  "  (See the \"Oracle VM Invocation Options\" section of the JPDA\n"

I think you can reduce to "Invocation Options" to avoid having "Oracle VM" in the usage output.

-------------

PR: https://git.openjdk.java.net/jdk/pull/4352