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
