RFR: 8181825: Add tool and services information to module summary

Robert Field robert.field at oracle.com
Fri Jun 9 03:57:05 UTC 2017

In terms of the JShell module —

The changes include formatting references to the tool as:   <em>jshell</em> tool
Which is dandy.

However, because of another change, what was the first reference to the tool is now the second: the existing Java™ shell tool
Which makes no sense for a second reference.   This too should be:  <em>jshell</em> tool

What is now the first reference (on the line above) could become something like: including the Java™ shell tool — <em>{@index jshell jshell tool}</em> tool.
Or not.

A link is added for the new Tool Reference (“Tool Guides”), which great, though it should be “Tool Reference”.
There is a User Guide nearing completion, but there is no external link yet.


> On Jun 8, 2017, at 5:25 PM, Jonathan Gibbons <jonathan.gibbons at oracle.com> wrote:
> Please review minor doc updates to langtools modules to add info
> about tools and services.
> In addition, a previously missing package-info is provided for
> com.sun.tools.javac.
> This is the langtools equivalent of JDK-8181639.
> https://bugs.openjdk.java.net/browse/JDK-8181639
> http://mail.openjdk.java.net/pipermail/core-libs-dev/2017-June/048132.html
> JBS: https://bugs.openjdk.java.net/browse/JDK-8181825
> Webrev: http://cr.openjdk.java.net/~jjg/8181825/webrev.00
> -- Jon

More information about the compiler-dev mailing list