From raymond.gallardo at oracle.com  Tue May 27 14:36:08 2014
From: raymond.gallardo at oracle.com (raymond gallardo)
Date: Tue, 27 May 2014 10:36:08 -0400
Subject: Review of OpenJDK 8u20 Java tools nroff documentation
In-Reply-To: <53848FF9.6080406@oracle.com>
References: <53848FF9.6080406@oracle.com>
Message-ID: <5384A2D8.6040004@oracle.com>

Hello Reviewers,

As part of the OpenJDK review processes, and the next Java SE 8u20 
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_may_2014.zip

Please provide your feedback by *Thursday, May 29, 2014*.

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

  * Scope of Review
    <imap://raymond%2Egallardo%40oracle%2Ecom at stbeehive.oracle.com:993/fetch%3EUID%3E/Sent%3E4900?part=1.1.2.2&filename=External_review_november_11.html>
  * Provide Feedback
    <imap://raymond%2Egallardo%40oracle%2Ecom at stbeehive.oracle.com:993/fetch%3EUID%3E/Sent%3E4900?part=1.1.2.3&filename=External_review_november_11.html>
  * How to View a Man Page
    <imap://raymond%2Egallardo%40oracle%2Ecom at stbeehive.oracle.com:993/fetch%3EUID%3E/Sent%3E4900?part=1.1.2.4&filename=External_review_november_11.html>
  * What's Changed
    <imap://raymond%2Egallardo%40oracle%2Ecom at stbeehive.oracle.com:993/fetch%3EUID%3E/Sent%3E4900?part=1.1.2.5&filename=External_review_november_11.html>
  * Summary of Changes
    <imap://raymond%2Egallardo%40oracle%2Ecom at stbeehive.oracle.com:993/fetch%3EUID%3E/Sent%3E4900?part=1.1.2.6&filename=External_review_november_11.html>


    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 
*Thursday, May 29, 2014***.

All feedback will be triaged. Severe technical inaccuracies and other 
small bugs will be fixed. Due to Java SE 8u20 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_may_2014.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_may_2014.zip

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

 4.

    Change directory to |openjdk_nroff_may_2014| as follows:

    $ cd openjdk_nroff_may_2014

 5.

    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 Mac 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*.


    What's Changed

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


    Summary of Changes

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

javac
JDK-8042840 (opened by Omair Majid): Duplicated code in javac man page
JDK-8038427 (Erik Costlow): JDK 8's javac does not list -source 8 ... 
also made changes to the -target option

javafxpackager
JDK-8042342 Renamed to javapackager (Danno Ferrin)
JDK-8033610, Update info on packager for 8u20 (and other deployment 
information)

javapackager
New page (as a result of javafxpackager being renamed)

java
JDK-8033606: Experimental options related to Restricted Transactional 
Memory, (Vladimir Kozlov)
JDK-8033604: String deduplication, (Per Lid?n)
Additional information for UseAES hardware supportability.
JDK-8033103 (David Holmes), JDK-8042149 (Vladimir Kozlov): Various 
fixes. emoved the option UseBoundThreads, Better categorized options, in 
particular, HotSpot Server VM, Advanced JIT Compiler Options, and 
Advanced Runtime Options.
JDK-8039398 (opened by Staffan Friberg; verified by Filipp Zhinkin) 
Spelling errors in GC print flags
JDK-8032663 Retire some rarely-used GC combinations: Moved all 
CMSIncremental options to the Deprecated section
Changes to Java Man pages for AES flags.
Additional information for AESIntrinsics
Additional information for bug JDK-8034904

javap
Added a link to jdeps (Mandy Chung)

jmc
JDK-8037401: Minor changes

Thank you,

The Java SE 8 Documentation Team




From per.liden at oracle.com  Wed May 28 22:17:04 2014
From: per.liden at oracle.com (Per Liden)
Date: Thu, 29 May 2014 00:17:04 +0200
Subject: Review of OpenJDK 8u20 Java tools nroff documentation
In-Reply-To: <5384A2D8.6040004@oracle.com>
References: <53848FF9.6080406@oracle.com> <5384A2D8.6040004@oracle.com>
Message-ID: <7B2B250C-8B5E-4FFA-9E76-02A41C389425@oracle.com>

Hi Raymond,

I checked the additions related to string deduplication in the java(1) man page. Looks fine to me.

/Per

On 27 May 2014, at 16:36, raymond gallardo <raymond.gallardo at oracle.com> wrote:

> Hello Reviewers,
> 
> As part of the OpenJDK review processes, and the next Java SE 8u20 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_may_2014.zip
> 
> Please provide your feedback by *Thursday, May 29, 2014*.
> 
> The following sections describe what kinds of review comments we're looking for and what has changed for Java SE 8u20. Please contact us if you have any questions.
> 
> * Scope of Review
>   <imap://raymond%2Egallardo%40oracle%2Ecom at stbeehive.oracle.com:993/fetch%3EUID%3E/Sent%3E4900?part=1.1.2.2&filename=External_review_november_11.html>
> * Provide Feedback
>   <imap://raymond%2Egallardo%40oracle%2Ecom at stbeehive.oracle.com:993/fetch%3EUID%3E/Sent%3E4900?part=1.1.2.3&filename=External_review_november_11.html>
> * How to View a Man Page
>   <imap://raymond%2Egallardo%40oracle%2Ecom at stbeehive.oracle.com:993/fetch%3EUID%3E/Sent%3E4900?part=1.1.2.4&filename=External_review_november_11.html>
> * What's Changed
>   <imap://raymond%2Egallardo%40oracle%2Ecom at stbeehive.oracle.com:993/fetch%3EUID%3E/Sent%3E4900?part=1.1.2.5&filename=External_review_november_11.html>
> * Summary of Changes
>   <imap://raymond%2Egallardo%40oracle%2Ecom at stbeehive.oracle.com:993/fetch%3EUID%3E/Sent%3E4900?part=1.1.2.6&filename=External_review_november_11.html>
> 
> 
>   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 *Thursday, May 29, 2014***.
> 
> All feedback will be triaged. Severe technical inaccuracies and other small bugs will be fixed. Due to Java SE 8u20 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_may_2014.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_may_2014.zip
> 
>   This creates a sub-directory named openjdk_nroff_may_2014 in the
>   current directory.
> 
> 4.
> 
>   Change directory to |openjdk_nroff_may_2014| as follows:
> 
>   $ cd openjdk_nroff_may_2014
> 
> 5.
> 
>   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 Mac 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*.
> 
> 
>   What's Changed
> 
> * 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.
> 
> 
>   Summary of Changes
> 
> The following lists significant changes made to the Java tool nroff pages for this release as well as the engineer who reviewed the content.
> 
> javac
> JDK-8042840 (opened by Omair Majid): Duplicated code in javac man page
> JDK-8038427 (Erik Costlow): JDK 8's javac does not list -source 8 ... also made changes to the -target option
> 
> javafxpackager
> JDK-8042342 Renamed to javapackager (Danno Ferrin)
> JDK-8033610, Update info on packager for 8u20 (and other deployment information)
> 
> javapackager
> New page (as a result of javafxpackager being renamed)
> 
> java
> JDK-8033606: Experimental options related to Restricted Transactional Memory, (Vladimir Kozlov)
> JDK-8033604: String deduplication, (Per Lid?n)
> Additional information for UseAES hardware supportability.
> JDK-8033103 (David Holmes), JDK-8042149 (Vladimir Kozlov): Various fixes. emoved the option UseBoundThreads, Better categorized options, in particular, HotSpot Server VM, Advanced JIT Compiler Options, and Advanced Runtime Options.
> JDK-8039398 (opened by Staffan Friberg; verified by Filipp Zhinkin) Spelling errors in GC print flags
> JDK-8032663 Retire some rarely-used GC combinations: Moved all CMSIncremental options to the Deprecated section
> Changes to Java Man pages for AES flags.
> Additional information for AESIntrinsics
> Additional information for bug JDK-8034904
> 
> javap
> Added a link to jdeps (Mandy Chung)
> 
> jmc
> JDK-8037401: Minor changes
> 
> Thank you,
> 
> The Java SE 8 Documentation Team
> 
> 
> 


From mandy.chung at oracle.com  Thu May 29 00:46:56 2014
From: mandy.chung at oracle.com (Mandy Chung)
Date: Wed, 28 May 2014 17:46:56 -0700
Subject: Review of OpenJDk 8u20 Java tools nroff documentation
In-Reply-To: <53848F78.9040608@oracle.com>
References: <53848F78.9040608@oracle.com>
Message-ID: <53868380.3050908@oracle.com>

Raymond,

javap and jdeps man page looks fine to me.

thanks
Mandy

On 5/27/2014 6:13 AM, raymond gallardo wrote:
>
> Hello Reviewers,
>
> As part of the OpenJDK review processes, and the next Java SE 8u20 
> release, the OpenJDK 8 nroff files for Java tools are up for review, 
> which is attached as a zip file.
>
> Please provide your feedback by *Thursday, May 29, 2014*.
>
> The following sections describe what kinds of review comments we're 
> looking for and what has changed for Java SE 8u20. Please contact us 
> if you have any questions.
>
>   * Scope of Review
>     <imap://raymond%2Egallardo%40oracle%2Ecom at stbeehive.oracle.com:993/fetch%3EUID%3E/Sent%3E4900?part=1.1.2.2&filename=External_review_november_11.html>
>   * Provide Feedback
>     <imap://raymond%2Egallardo%40oracle%2Ecom at stbeehive.oracle.com:993/fetch%3EUID%3E/Sent%3E4900?part=1.1.2.3&filename=External_review_november_11.html>
>   * How to View a Man Page
>     <imap://raymond%2Egallardo%40oracle%2Ecom at stbeehive.oracle.com:993/fetch%3EUID%3E/Sent%3E4900?part=1.1.2.4&filename=External_review_november_11.html>
>   * What's Changed
>     <imap://raymond%2Egallardo%40oracle%2Ecom at stbeehive.oracle.com:993/fetch%3EUID%3E/Sent%3E4900?part=1.1.2.5&filename=External_review_november_11.html>
>   * Summary of Changes
>     <imap://raymond%2Egallardo%40oracle%2Ecom at stbeehive.oracle.com:993/fetch%3EUID%3E/Sent%3E4900?part=1.1.2.6&filename=External_review_november_11.html>
>
>
>     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 
> *Thursday, May 29, 2014***.
>
> All feedback will be triaged. Severe technical inaccuracies and other 
> small bugs will be fixed. Due to Java SE 8u20 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_may_2014.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_may_2014.zip
>
>     This creates a sub-directory named openjdk_nroff_may_2014 in the
>     current directory.
>
> 4.
>
>     Change directory to |openjdk_nroff_may_2014| as follows:
>
>     $ cd openjdk_nroff_may_2014
> 5.
>
>     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 Mac 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*.
>
>
>     What's Changed
>
>   * 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.
>
>
>     Summary of Changes
>
> The following lists significant changes made to the Java tool nroff 
> pages for this release as well as the engineer who reviewed the content.
>
> javac
> JDK-8042840 (opened by Omair Majid): Duplicated code in javac man page
> JDK-8038427 (Erik Costlow): JDK 8's javac does not list -source 8 ... 
> also made changes to the -target option
>
> javafxpackager
> JDK-8042342 Renamed to javapackager (Danno Ferrin)
> JDK-8033610, Update info on packager for 8u20 (and other deployment 
> information)
>
> javapackager
> New page (as a result of javafxpackager being renamed)
>
> java
> JDK-8033606: Experimental options related to Restricted Transactional 
> Memory, (Vladimir Kozlov)
> JDK-8033604: String deduplication, (Per Lid?n)
> Additional information for UseAES hardware supportability.
> JDK-8033103 (David Holmes), JDK-8042149 (Vladimir Kozlov): Various 
> fixes. emoved the option UseBoundThreads, Better categorized options, 
> in particular, HotSpot Server VM, Advanced JIT Compiler Options, and 
> Advanced Runtime Options.
> JDK-8039398 (opened by Staffan Friberg; verified by Filipp Zhinkin) 
> Spelling errors in GC print flags
> JDK-8032663 Retire some rarely-used GC combinations: Moved all 
> CMSIncremental options to the Deprecated section
> Changes to Java Man pages for AES flags.
> Additional information for AESIntrinsics
> Additional information for bug JDK-8034904
>
> javap
> Added a link to jdeps (Mandy Chung)
>
> jmc
> JDK-8037401: Minor changes
>
> Thank you,
>
> The Java SE 8 Documentation Team