<html>

  <head>

    <meta content="text/html; charset=windows-1252"

      http-equiv="Content-Type">

  </head>

  <body bgcolor="#FFFFFF" text="#000000">

    <br>

    <br>

    <div class="moz-cite-prefix">On 5/29/15 2:02 PM, Cantor, Scott

      wrote:<br>

    </div>

    <blockquote cite="mid:D07DB581-F2C7-44D4-BFFC-760D305D4FB6@osu.edu"

      type="cite">

      <pre wrap="">

Please review and raise any concerns on the list, or identify anything you still think is overlooked.

</pre>

    </blockquote>

    <br>

    From the API section:<br>

    <br>

    <blockquote type="cite">

      <meta http-equiv="content-type" content="text/html;

        charset=windows-1252">

      <li>Public Java classes and methods exported from <strong>API

          Packages and Modules</strong> (this is defined subsequently)</li>

      <li>Public Java classes and methods in any 3rd-party library

        shipped with a product and available on the classpath</li>

    </blockquote>

    <br>

    <br>

    As I mentioned on the call once, I think we should be explicitly

    clear about what "Public" means here.  I noted that an API in

    (specifically) Java usually includes 'protected' methods and

    fields.  (I.e there's no meaningful distinction between "the API"

    and "the public API").<br>

    <br>

    IIRC Ian agreed, but noted that "Public API" might be construed as

    including those, depending on a particular language's access

    controls and terminology.<br>

    <br>

    Since we're talking specifically about Java here, I think it would

    be less confusing to a typical Java developer if we explicitly said

    Java 'protected' was included in the API, rather than leaving it

    implicit.<br>

  </body>

</html>