8023216: Feedback on README-builds.html

Mon, 26 Aug 2013 13:43:27 +0200

author
erikj
date
Mon, 26 Aug 2013 13:43:27 +0200
changeset 774
f8405a0fa69c
parent 769
96c1b9b7524b
child 775
5166118c5917

8023216: Feedback on README-builds.html
Reviewed-by: anthony, robilad, tbell

README-builds.html file | annotate | diff | comparison | revisions
     1.1 --- a/README-builds.html	Tue Aug 20 15:42:14 2013 -0700
     1.2 +++ b/README-builds.html	Mon Aug 26 13:43:27 2013 +0200
     1.3 @@ -154,7 +154,7 @@
     1.4                      </code>
     1.5                  </blockquote>
     1.6                  Once you have all the repositories, keep in mind that each
     1.7 -                repository is it's own independent repository.
     1.8 +                repository is its own independent repository.
     1.9                  You can also re-run <code>./get_source.sh</code> anytime to
    1.10                  pull over all the latest changesets in all the repositories.
    1.11                  This set of nested repositories has been given the term
    1.12 @@ -241,6 +241,14 @@
    1.13                                  source code for the OpenJDK Corba functionality
    1.14                              </td>
    1.15                          </tr>
    1.16 +                        <tr>
    1.17 +                            <td>
    1.18 +                                nashorn
    1.19 +                            </td>
    1.20 +                            <td>
    1.21 +                                source code for the OpenJDK JavaScript implementation
    1.22 +                            </td>
    1.23 +                        </tr>
    1.24                      </tbody>
    1.25                  </table>
    1.26              </blockquote>
    1.27 @@ -386,7 +394,7 @@
    1.28                          <code>--with-boot-jdk</code>.
    1.29                      </li>
    1.30                      <li>
    1.31 -                        Insure that GNU make, the Bootstrap JDK,
    1.32 +                        Ensure that GNU make, the Bootstrap JDK,
    1.33                          and the compilers are all
    1.34                          in your PATH environment variable
    1.35                      </li>
    1.36 @@ -1307,9 +1315,9 @@
    1.37                      you will need to modify the makefiles. But for normal file
    1.38                      additions or removals, no changes are needed. There are certan
    1.39                      exceptions for some native libraries where the source files are spread
    1.40 -                    over many directories which also contain courses for other
    1.41 +                    over many directories which also contain sources for other
    1.42                      libraries. In these cases it was simply easier to create include lists
    1.43 -                    rather thane excludes.
    1.44 +                    rather than excludes.
    1.45                  </p>
    1.46  
    1.47                  <p>
    1.48 @@ -1327,14 +1335,14 @@
    1.49                  <p>
    1.50                      <b>Q:</b> 
    1.51                      <code>configure</code> provides OpenJDK-specific features such as
    1.52 -                    <code>--enable-jigsaw</code> or <code>--with-builddeps-server</code>
    1.53 -                    that are not described in this document. What about those?
    1.54 +                    <code>--with-builddeps-server</code> that are not
    1.55 +                    described in this document. What about those? 
    1.56                      <br>
    1.57                      <b>A:</b>
    1.58                      Try them out if you like! But be aware that most of these are 
    1.59                      experimental features. 
    1.60                      Many of them don't do anything at all at the moment; the option 
    1.61 -                    is just a placeholder. Other depends on
    1.62 +                    is just a placeholder. Others depend on
    1.63                      pieces of code or infrastructure that is currently 
    1.64                      not ready for prime time.
    1.65                  </p>
    1.66 @@ -1386,24 +1394,6 @@
    1.67                  </p>
    1.68  
    1.69                  <p>
    1.70 -                    <b>Q:</b> What is @GenerateNativeHeaders?
    1.71 -                    <br>
    1.72 -                    <b>A:</b> 
    1.73 -                    To speed up compilation, we added a flag to javac which makes it 
    1.74 -                    do the job of javah as well, as a by-product; that is, generating
    1.75 -                    native .h header files. These files are only generated 
    1.76 -                    if a class contains native methods. However, sometimes 
    1.77 -                    a class contains no native method,
    1.78 -                    but still contains constants that native code needs to use. 
    1.79 -                    The new GenerateNativeHeaders annotation tells javac to
    1.80 -                    force generation of a
    1.81 -                    header file in these cases. (We don't want to generate 
    1.82 -                    native headers for all classes that contains constants 
    1.83 -                    but no native methods, since
    1.84 -                    that would slow down the compilation process needlessly.)
    1.85 -                </p>
    1.86 -
    1.87 -                <p>
    1.88                      <b>Q:</b> 
    1.89                      Is anything able to use the results of the new build's default make target?
    1.90                      <br>
    1.91 @@ -1429,10 +1419,9 @@
    1.92                      What should I do?
    1.93                      <br>
    1.94                      <b>A:</b>
    1.95 -                    It might very well be that we have missed to add support for
    1.96 +                    It might very well be that we have neglected to add support for
    1.97                      an option that was actually used from outside the build system.
    1.98 -                    Email us and we will
    1.99 -                    add support for it!
   1.100 +                    Email us and we will add support for it!
   1.101                  </p>
   1.102  
   1.103              </blockquote>

mercurial