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