groovy-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From pa...@apache.org
Subject groovy git commit: slightly improved wording around bootstrapping gradle
Date Fri, 01 Sep 2017 10:42:16 GMT
Repository: groovy
Updated Branches:
  refs/heads/GROOVY_2_6_X 7d11a154c -> 80df65980


slightly improved wording around bootstrapping gradle


Project: http://git-wip-us.apache.org/repos/asf/groovy/repo
Commit: http://git-wip-us.apache.org/repos/asf/groovy/commit/80df6598
Tree: http://git-wip-us.apache.org/repos/asf/groovy/tree/80df6598
Diff: http://git-wip-us.apache.org/repos/asf/groovy/diff/80df6598

Branch: refs/heads/GROOVY_2_6_X
Commit: 80df65980bf8f17264ef681f940383f0cd4c2275
Parents: 7d11a15
Author: paulk <paulk@asert.com.au>
Authored: Fri Sep 1 20:39:26 2017 +1000
Committer: paulk <paulk@asert.com.au>
Committed: Fri Sep 1 20:42:04 2017 +1000

----------------------------------------------------------------------
 README.adoc | 26 ++++++++++++++++++++++----
 1 file changed, 22 insertions(+), 4 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/groovy/blob/80df6598/README.adoc
----------------------------------------------------------------------
diff --git a/README.adoc b/README.adoc
index 5583eec..bb8a402 100644
--- a/README.adoc
+++ b/README.adoc
@@ -70,13 +70,31 @@ Simply `git clone` the repo (or the repo you forked via the github website)
and
 
 Alternatively, you can download the source distribution and unpack it.
 
-If obtaining the source from this distribution and you intend to build from source,
-you also need to https://gradle.org/downloads/[download] and install http://gradle.org/[Gradle]
and execute one bootstrap step.
-At the top directory of your unpacked source, you need to run the command:
+If obtaining the source from the source distribution and you intend to build from source,
+you also need to https://gradle.org/downloads/[download] and install http://gradle.org/[Gradle]
and
+use the downloaded Gradle to execute one bootstrap step.
+
+==== Bootstrapping Gradle
+
+As mentioned in the previous paragraph, if you download the source distribution
+you need to bootstrap Gradle. This isn't needed if you clone from the Github repo.
+
+Each version of Groovy is built and tested using a specific version of Gradle.
+That version is specified by the `gradleVersion` property defined in the `build.gradle`
+file within the root directory. Luckily you shouldn't need to know that version and,
+after bootstrapping, you should use the `gradlew` command which will ensure the
+correct version is always used.
+
+The version of Gradle used for the bootstrap step has some flexibility though in general
+you might need to download a version similar to the version of Groovy the build is
+expecting.
+
+To bootstrap Gradle, at the top directory of your unpacked source, run the command:
 
     gradle wrapper
 
-This sets up the Gradle wrapper and from then on you just need the `gradlew` command instead
of `gradle`.
+*NOTE*: At this point, the Gradle wrapper should be set up and from now on you should use
+the `gradlew` command instead of `gradle`.
 
 == Building from Source
 


Mime
View raw message