[PATCH] JDK-8167368 Leftover: get_source.sh in build documentation (original) (raw)

Erik Joelsson erik.joelsson at oracle.com
Mon Nov 19 16🔞57 UTC 2018

I can sponsor it.

/Erik

On 2018-11-17 09:55, Sergey wrote:

Hi David,

s/repositorys/repositories/ Thanks, David

I've fixed that one and double checked the rest of the diff. Hope it is fine now. That also would be great if anyone could sponsor that patch. Thanks, Sergei diff --git a/doc/building.md b/doc/building.md --- a/doc/building.md +++ b/doc/building.md @@ -48,7 +48,7 @@  Make sure you are getting the correct version. As of JDK 10, the source is no  longer split into separate repositories so you only need to clone one single  repository. At the OpenJDK Mercurial_ _server you -can see a list of all available forests. If you want to build an older version, +can see a list of all available repositories. If you want to build an older version,  e.g. JDK 8, it is recommended that you get the jdk8u forest, which contains  incremental updates, instead of the jdk8 forest, which was frozen at JDK 8 GA. @@ -1301,17 +1301,15 @@  affected parts get rebuilt. While this works great in most cases, and  significantly speed up the development process, from time to time complex  interdependencies will result in an incorrect build result. This is the most -common cause for unexpected build problems, together with inconsistencies -between the different Mercurial repositories in the forest. +common cause for unexpected build problems.  Here are a suggested list of things to try if you are having unexpected build  problems. Each step requires more time than the one before, so try them in  order. Most issues will be solved at step 1 or 2. - 1. Make sure your forest is up-to-date + 1. Make sure your repository is up-to-date -    Run bash getsource.sh to make sure you have the latest version of all -    repositories. +    Run hg pull -u to make sure you have the latest changes. 2. Clean build results @@ -1336,13 +1334,13 @@  make  _ _- 4. Re-clone the Mercurial forest_ _+ 4. Re-clone the Mercurial repository_ _-    Sometimes the Mercurial repositories themselves gets in a state_ _that causes_ _-    the product to be un-buildable. In such a case, the simplest_ _solution is_ _-    often the "sledgehammer approach": delete the entire forest, and_ _re-clone_ _-    it. If you have local changes, save them first to a different_ _location_ _-    using `hg export`._ _+    Sometimes the Mercurial repository gets in a state that causes_ _the product_ _+    to be un-buildable. In such a case, the simplest solution is_ _often the_ _+    "sledgehammer approach": delete the entire repository, and_ _re-clone it._ _+    If you have local changes, save them first to a different_ _location using_ _+    `hg export`._  _### Specific Build Issues_ _@@ -1393,7 +1391,7 @@_  _## Hints and Suggestions for Advanced Users_ _-### Setting Up a Forest for Pushing Changes (defpath)_ _+### Setting Up a Repository for Pushing Changes (defpath)_  _To help you prepare a proper push path for a Mercurial repository,_ _there exists_  _a useful tool known as [defpath](_ _@@ -1420,11 +1418,6 @@_  _hg defpath -d -u <your OpenJDK username>_  _ -If you also have the trees extension installed in Mercurial, you will -automatically get a tdefpath command, which is even more useful. By running -hg tdefpath -du <username> in the top repository of your forest, all repos -will get setup automatically. This is the recommended usage. -  ### Bash Completion  The configure and make commands tries to play nice with bash command-line @@ -1459,7 +1452,7 @@  ### Using Multiple Configurations -You can have multiple configurations for a single source forest. When you +You can have multiple configurations for a single source repository. When you  create a new configuration, run configure --with-conf-name=<name> to create a  configuration with the name <name>. Alternatively, you can create a directory  under build and run configure from there, e.g. mkdir_ _build/<name> && cd_ _@@ -1474,7 +1467,7 @@_  _### Handling Reconfigurations_ _-If you update the forest and part of the configure script has_ _changed, the_ _+If you update the repository and part of the configure script has_ _changed, the_  _build system will force you to re-run configure._  _Most of the time, you will be fine by running configure` again with the same

More information about the build-dev mailing list