From raymond.gallardo at oracle.com  Tue Oct  7 21:55:53 2014
From: raymond.gallardo at oracle.com (raymond gallardo)
Date: Tue, 07 Oct 2014 17:55:53 -0400
Subject: OpenJDK 8u40 nroff files are up for review
Message-ID: <54346169.6050604@oracle.com>

Hello Reviewers,

As part of the OpenJDK review processes, and the next Java SE 8u40 
release, the OpenJDK 8 nroff files for Java tools are up for review, 
which is available here as a zip file:

http://cr.openjdk.java.net/~rgallard/openjdk_nroff_8u40.zip

You can obtain the webrev here:

http://cr.openjdk.java.net/~rgallard/openjdk_webrev_8u40.zip

Please provide your feedback by Friday, October 10, 2014.

The following sections describe what kinds of review comments we're 
looking for and what has changed for Java SE 8u40. Please contact us if 
you have any questions.

     Summary of Changes
     Scope of Review
     Provide Feedback
     How to View a Man Page

Summary of Changes

Technical content changes related to JDK 8 features have been made. 
These changes have already been reviewed by the engineer responsible for 
each feature.

HTML documentation for Java tools has also been generated, which has the 
same content as the nroff files up for review, and which will be 
available on download.java.net.

The following lists significant changes made to the Java tool nroff 
pages for this release as well as the engineer who reviewed the content.

java:

JDK-8054382 : (JDK-8054376 : Move RTM flags from Experimental to 
Product) Update RTM documentation, staffan.friberg at oracle.com and 
vladimir.kozlov at oracle.com.
JDK-8043965 : Xverify:remote description is wrong, David Buck
JDK-8040180 : Extend and improve documentation about Large pages, 
staffan.friberg at oracle.com and stefan.karlsson at oracle.com
JDK-8040176 : Document -XX:ObjectAlignmentInBytes flag, Vladimir Kozlov
JDK-8037590 : The name for PerfDataSaveToFile flag is incorrect in 
HotSpot VM Options document, masato.yoshida at oracle.com
JDK-8032725 : Description of default maximum heap size need correction, 
masato.yoshida at oracle.com

keytool:

JDK-8050813 : Option values are not italicized on JDK 8 keytool 
documentation page, Jason Uh

javapackager and javafxpackager (Note that changes to javapackager and 
javafxpackager will not appear in the webrev because they will be pushed 
to a different repository):

RT-37898, Danno Ferrin
RT-37876, Danno Ferrin

javac:

JDK-8016641 : Cross compilation not as documented, Maurizio Cimadamore

jjs:

JDK-8041730 : Nashorn documentation bug, Sundararajan Athijegannathan
JDK-8038292 : whitespace missing in examples in jjs tool doc page, 
Sundararajan Athijegannathan

policytool:

JDK-8059076 : Spacing bug in policytool.html

jstat:

JDK-8040079 : jstat documentation needs to be updated for metaspace, 
erik.helin at oracle.com

javadoc:

New -javafx option added


Scope of Review

Please provide a sanity check of content as opposed to reviewing the 
nroff markup itself.

A line-by-line comparison between the html and nroff versions is not needed.

Provide Feedback

Please indicate your approval and provide feedback by e-mail by October 
10, 2014.

All feedback will be triaged. Severe technical inaccuracies and other 
small bugs will be fixed. Due to Java SE 8u40 release plan deadlines, 
bugs will be filed for large scale changes and will most likely be 
handled in a future update release.

How To View A Man Page

1. Download the openjdk_nroff_8u40.zip file to a directory of your 
choice. (The exact zip file name will vary depending upon the exact man 
page bundle and creation date.)

2. Open a terminal window. Change to the directory that contains the zip 
file.

3. Extract the contents of the zip file as follows:

$ unzip openjdk_nroff_8u40.zip

This creates a sub-directory named openjdk_nroff_8u40 in the current 
directory.

4. Change directory to openjdk_nroff_8u40 as follows:

$ cd openjdk_nroff_8u40

View a man page with a command of the following form:

$ man -M man <page name>

For example, to view the javap man page, run the following command:

$ man -M man javap

Notes

(Linux and OS X only.) The -t option to the man command will generate 
typeset output in PostScript format and send it to stdout:

$ man -M man -t javap > javap.ps

PostScript can be displayed using Preview (on Mac) and by the Gnome 
Document Viewer (Linux/Gnome). (On Solaris, the man -t option will send 
the output to a printer, which might not be what you want.)

If bullets render as a funny character, set the remote character set to 
UTF-8. For example, if you are using PuTTY, an SSH and telnet client, 
you can specify the remote character set by selecting from the context 
menu Change Settings... > Window > Translation > Remote character set > 
UTF-8.

Thank you,
The Java SE 8 Documentation Team

From raymond.gallardo at oracle.com  Wed Oct  8 18:03:51 2014
From: raymond.gallardo at oracle.com (raymond gallardo)
Date: Wed, 08 Oct 2014 14:03:51 -0400
Subject: For review,
	JDK 8u40 documentation enhancement related to bug JDK-8042946
	JEP 196: Nashorn Optimistic Typing
Message-ID: <54357C87.706@oracle.com>

Hello reviewers,

Changes made to the following nroff file, jjs.1 are up for review:

http://cr.openjdk.java.net/~rgallard/jjs.1

The changes made to this file are related to bug JDK-8042946 JEP 196: 
Nashorn Optimistic Typing. A new option has been added to the jjs.1 file:

--optimistic-types=[true|false]
.br
Enables or disables optimistic type assumptions with deoptimizing 
recompilation\&. Running with optimistic types will yield higher final 
speed, but may increase warmup time\&. By default optimistic types are 
enabled\&.

Please review this addition and submit your feedback by Friday, October 
10th.

Note, the nroff files for OpenJDK 8u40 are up for review. See the e-mail 
with the subject "OpenJDK 8u40 nroff files are up for review" sent 
2014-10-07.

Thanks,
--The Java SE Documentation Team