Final signoff and review for OpenJDK 8u40 nroff files

Wed Oct 15 05:27:10 UTC 2014

Hi all,

We're requesting signoff for the OpenJDK 8u40 files that were up for 
review last week.

Here's the webrev:

http://cr.openjdk.java.net/~rgallard/webrev_8u40/

The following have been changed for this signoff release:

* java.1 issues found by Vladimir Kozlov, which he verified on 2014-10-14
* Changes to jjs.1 related to bug JDK-8042946 JEP 196: Nashorn 
Optimistic Typing

The following have reviewed the nroff:
* Masato Yoshida: Verified java.1 with respect to JDK-8037590 and 
JDK-8032725
* Erik Helin: Verified jstat
* Kalra Ward: Verified JDK-8057621 but opened bug JDK-8060180, which 
will be fixed in a later release
* Vladimir Kozlov as mentioned previously

Please send us your sign-off to this alias by end-of-day, Wednesday, 
October 15th.

Thanks,
The Java SE Documentation Team

On 2014-10-10 2:53 PM, raymond gallardo wrote:
> Hi all,
>
> Just a reminder that the nroff files for 8u40 are up for review. 
> Please send us your feedback by the end of the day today, Friday, 
> October, 10.
>
> Thanks,
> --The Java SE Documentation team
>
> On 2014-10-08 2:12 PM, raymond gallardo wrote:
>>
>>
>> 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
>>
>>
>>
>