> On Mar 27, 2017, at 1:38 AM, Erik Joelsson <erik.joels...@oracle.com> wrote: > > Looks ok to me. Not sure about adding a make variable as a parameter, but I > assume Magnus will fix that as part of JDK-8176785? >
Thanks. The make variable is temporary and should be removed with JDK-817678. Mandy > /Erik > > > On 2017-03-25 22:33, Mandy Chung wrote: >> I edited the module descriptions per your feedback. I also revised >> GenGraphs tool to take a properties file to customize the dot graphs >> for javadoc use. >> >> Updated webrev: >> http://cr.openjdk.java.net/~mchung/jdk9/webrevs/8173303/webrev.02/ >> >> Magnus, Erik, >> >> I modified Javadoc.gmk and Main.gmk to add a new target to generate >> .dot files for javadoc use. GenGraphs tool depends on the exploded >> image build. Javadoc.gmk temporarily takes ENABLE_MODULE_GRAPH make >> variable for us to enable @moduleGraph taglet until JDK-8176785 is >> resolved. >> >> thanks >> Mandy >> >>> On Mar 25, 2017, at 2:36 AM, Alan Bateman <alan.bate...@oracle.com> wrote: >>> >>> On 24/03/2017 21:50, Mandy Chung wrote: >>> >>>> Alan, >>>> >>>> I took another round of edits on the module descriptions: >>>> http://cr.openjdk.java.net/~mchung/jdk9/webrevs/8173303/webrev.01/ >>>> >>>> Once we have the unified docs, it will make it easier to review >>>> the module summary page for all modules where we will revise >>>> these module descriptions again. >>>> >>> I went through the updated module descriptions. >>> >>> Two more that seem to be missing "the" are jdk.net and jdk.sctp, I think >>> they will read okay once that is added. >>> >> Fixed. I missed that. >> >>> jdk.httpserver currently has "Defines the JDK-specific API for HTTP >>> server", it might be better to re-shuffle this to "Defines the API for the >>> JDK-specific HTTP server”. >>> >> This reads better. >> >>> I think the only one that needs re-examination is jdk.charsets. The >>> java.base module contains the standard charsets and all other charsets >>> needed to start the runtime on any of the supported configurations. It thus >>> varies by platform with jdk.charsets providing the charsets that aren't in >>> java.base. Finding the right description is difficult, maybe we should >>> start with "Charset provider for the charsets that are not in java.base >>> (mostly double byte and IBM charsets". I could imagine linking this to the >>> "Supported encodings" docs page in time. >>> >> Let’s start with this version. I expect we will refine the module >> description further next couple weeks. >> >>> Everything else looks good. >> >> Thanks >> Mandy >