8182482: Module System spec updates

[Rony G. Flatscher]

Just a side-note: when printing with the latest Firefox the headers cover part of the text, which
makes printing of such Javadocs somewhat useless. Not sure where to report this, so posting it here.

The printout of the generated javadoc is enclosed or if the attachment gets stripped can be fetched
from this location:
<https://www.dropbox.com/s/kzp4wfyl13peccf/ServiceLoader%20%28Java%20SE%209%20%26%20JDK%209%20%5Bad-hoc%20build%5D%29.pdf?dl=0>

---rony

On 20.06.2017 12:20, Alan Bateman wrote:
> We have two javadoc/spec updates that I'd like to get into the JDK 9 Initial Release Candidate
> that is scheduled for this week.
>
> The spec updates are for two issues:
>
> 1. ServiceLoader: The API spec has been updated significantly to support modules but it needs
> another round of update to do clean-up to get it more readable and consistent, and also to align
> it with the JLS.  Most of reorganization and re-wording has been proposed by Alex. Joe Darcy has
> also proposed a few adjustments.
>
> 2. Upgradable modules aren't specified anywhere. Java SE will designate a number of standard
> modules as upgradeable but we don't have anywhere in the docs to link to that or describe how the
> upgraded versions are used in preference to the modules built into the environment.
>
> The webrev with the proposed (docs only, no implementation) changes is here:
>   http://cr.openjdk.java.net/~alanb/8182482/webrev/index.html
>
> The ServiceLoader diffs are hard to read. It might be easier to read the generated javadoc:
> http://cr.openjdk.java.net/~alanb/8182482/docs/java/util/ServiceLoader.html
>
> -Alan