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

[Robert Field]

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.

Robert



> 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
> 
> 
>