Re: RFR 8167227: Simplify the JDK 9 API-specification overview page (docs only)

[John Rose]

On Jun 18, 2017, at 3:47 AM, mark.reinh...@oracle.com wrote:
> 
> Current output, for reference:
> http://download.java.net/java/jdk9/docs/api/overview-summary.html 
> 

Yes, the language changes are good.  (From a non-legal English major POV.)

I also reviewed the makefile mechanics; those look good AFAICT.

— John

Re: RFR 8167227: Simplify the JDK 9 API-specification overview page (docs only)

[mark . reinhold]

2017/6/19 10:41:09 +0200, erik.joels...@oracle.com:
> Looks good to me.
> 
> The change to the log message is a bit weird. Was this meant as a 
> temporary way for finding the output file?

Good catch -- yes, that was temporary.  I'll remove it.

Thanks,
- Mark

Re: RFR 8167227: Simplify the JDK 9 API-specification overview page (docs only)

[Erik Joelsson]

Looks good to me.

The change to the log message is a bit weird. Was this meant as a 
temporary way for finding the output file?


/Erik


On 2017-06-18 12:47, mark.reinh...@oracle.com wrote:

http://cr.openjdk.java.net/~mr/rev/8182408/
https://bugs.openjdk.java.net/browse/JDK-8182408

This is a follow-on to Magnus's changes for 8175824.

Oracle's legal department has recently advised that the liberal use of
trademark symbols on the API-specification overview page is not required.
We should, rather, just include a registered-trademark symbol (®)
after the first prominent instance of "Java". The warnings about the
provisional nature of the API can also be simplified.

The webrev page contains links to example Javadoc output for different
variants: GA vs. ad-hoc, and SE + JDK + FX vs. SE + JDK vs. just SE.

Current output, for reference:
http://download.java.net/java/jdk9/docs/api/overview-summary.html

Thanks,
- Mark

Re: RFR 8167227: Simplify the JDK 9 API-specification overview page (docs only)

[Mandy Chung]

Looks good to me.

Mandy

> On Jun 18, 2017, at 3:47 AM, mark.reinh...@oracle.com wrote:
> 
> http://cr.openjdk.java.net/~mr/rev/8182408/
> https://bugs.openjdk.java.net/browse/JDK-8182408
> 
> This is a follow-on to Magnus's changes for 8175824.
> 
> Oracle's legal department has recently advised that the liberal use of
> trademark symbols on the API-specification overview page is not required.
> We should, rather, just include a registered-trademark symbol (®)
> after the first prominent instance of "Java". The warnings about the
> provisional nature of the API can also be simplified.
> 
> The webrev page contains links to example Javadoc output for different
> variants: GA vs. ad-hoc, and SE + JDK + FX vs. SE + JDK vs. just SE.
> 
> Current output, for reference:
> http://download.java.net/java/jdk9/docs/api/overview-summary.html
> 
> Thanks,
> - Mark