You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@groovy.apache.org by pa...@apache.org on 2021/08/29 01:09:39 UTC
[groovy] branch GROOVY_2_5_X updated: GROOVY-9958: update doco for
jcenter/bintray sunset (port to 2_5_X)
This is an automated email from the ASF dual-hosted git repository.
paulk pushed a commit to branch GROOVY_2_5_X
in repository https://gitbox.apache.org/repos/asf/groovy.git
The following commit(s) were added to refs/heads/GROOVY_2_5_X by this push:
new 3b2afbd GROOVY-9958: update doco for jcenter/bintray sunset (port to 2_5_X)
3b2afbd is described below
commit 3b2afbdcfc596302a7f316261df843d92bf58e2b
Author: Paul King <pa...@asert.com.au>
AuthorDate: Wed Apr 14 15:03:14 2021 +1000
GROOVY-9958: update doco for jcenter/bintray sunset (port to 2_5_X)
---
README.adoc | 23 +++++------
src/spec/doc/core-getting-started.adoc | 70 +++++++++++-----------------------
src/spec/doc/grape.adoc | 2 +-
src/spec/doc/tools-groovyc.adoc | 2 +-
4 files changed, 34 insertions(+), 63 deletions(-)
diff --git a/README.adoc b/README.adoc
index ec9498a..81a6512 100644
--- a/README.adoc
+++ b/README.adoc
@@ -29,17 +29,14 @@ The Groovy development team
:groovy-ci: https://ci.groovy-lang.org?guest=1
:travis-ci: https://travis-ci.com/apache/groovy
:jdk: https://www.oracle.com/technetwork/java/javase/downloads
-:bintray-latest-version-image: https://api.bintray.com/packages/groovy/maven/groovy/images/download.png
-:bintray-latest-version-link: https://bintray.com/groovy/maven/groovy/_latestVersion
-:bintray-watch-image: https://www.bintray.com/docs/images/bintray_badge_color.png
-:bintray-watch-link: https://bintray.com/groovy/maven/groovy/view?source=watch
+//:bintray-latest-version-image: https://api.bintray.com/packages/groovy/maven/groovy/images/download.png
+//:bintray-latest-version-link: https://bintray.com/groovy/maven/groovy/_latestVersion
:apache-license-icon: https://img.shields.io/badge/license-APL2-blue.svg
:apache-license-link: http://www.apache.org/licenses/LICENSE-2.0.txt
:apache-groovy-twitter-icon: https://img.shields.io/twitter/follow/ApacheGroovy.svg?style=social
:apache-groovy-twitter-link: https://twitter.com/intent/follow?screen_name=ApacheGroovy
:jdk-icon: https://img.shields.io/badge/java-7+-4c7e9f.svg
-:bintray-download-icon: https://api.bintray.com/packages/groovy/maven/groovy/images/download.svg
-
+//:bintray-download-icon: https://api.bintray.com/packages/groovy/maven/groovy/images/download.svg
[.left.text-left]
image::https://raw.githubusercontent.com/groovy/artwork/master/medium.png[]
@@ -47,7 +44,7 @@ image:{jdk-icon}[jdk, link={jdk}]
image:{apache-license-icon}[Apache License 2, link={apache-license-link}]
image:{build-icon}[teamcity build status, link={groovy-ci}]
image:{travis-build-icon}[travis build status, link={travis-ci}]
-image:{bintray-download-icon}[bintray download, link={bintray-latest-version-link}]
+//image:{bintray-download-icon}[bintray download, link={bintray-latest-version-link}]
image:{apache-groovy-twitter-icon}[follow on Twitter, link={apache-groovy-twitter-link}]
{groovy-www}[Groovy] is a powerful multi-faceted programming language for the JVM platform.
@@ -60,17 +57,14 @@ including scripting support, Domain-Specific Language authoring, runtime and com
== Downloading
-Latest Groovy version is available on Bintray image:{bintray-latest-version-image}[Bintray latest version, link={bintray-latest-version-link}]
-
-Binary distribution links are on the package page.
+Distribution links are on the https://groovy.apache.org/download.html[download] page.
Maven, Gradle and Ivy dependency declaration snippets are available on specific files of a particular module.
-image:{bintray-watch-image}[Get automatic notifications about new "groovy" versions link={bintray-watch-link}]
-
== Obtaining the Source
-You don't need the source code to use Apache Groovy but if you wish to explore its inner workings or build it for yourself there are two ways to obtain the source files.
+You don't need the source code to use Apache Groovy but if you wish to explore its inner workings or build it for yourself
+there are two ways to obtain the source files.
=== Checking out from Version Control
@@ -82,7 +76,8 @@ And a mirror is hosted on Github:
https://github.com/apache/groovy
-The Github mirror is read-only and provides convenience to users and developers to explore the code and for the community to accept contributions via Github pull requests.
+The Github mirror is read-only and provides convenience to users and developers to explore the code and for the
+community to accept contributions via Github Pull Requests.
Simply `git clone` the repo (or the repo you forked via the github website) and you will have the complete source.
diff --git a/src/spec/doc/core-getting-started.adoc b/src/spec/doc/core-getting-started.adoc
index 2dcab4d..af7dd99 100644
--- a/src/spec/doc/core-getting-started.adoc
+++ b/src/spec/doc/core-getting-started.adoc
@@ -23,15 +23,19 @@
== Download
-In this download area, you will be able to download the distribution (binary and source), the Windows installer and the documentation for **Groovy**.
+From the https://groovy.apache.org/download.html[download] page,
+you will be able to download the distribution (binary and source),
+the Windows installer (a community artifact) and the documentation for **Groovy**.
-For a quick and effortless start on Mac OSX, Linux or Cygwin, you can use http://sdkman.io/[SDKMAN!] (The Software Development Kit Manager) to download and configure any **Groovy** version of your choice. Basic <<SDKMAN,instructions>> can be found below.
+For a quick and effortless start on Mac OSX, Linux, WSL2 or Cygwin, you can use https://sdkman.io/[SDKMAN!]
+(The Software Development Kit Manager) to download and configure any **Groovy** version of your choice.
+Basic <<SDKMAN,instructions>> can be found below.
=== Stable
-- **Download zip**: https://bintray.com/artifact/download/groovy/maven/apache-groovy-binary-{groovy-full-version}.zip[**Binary Release**] | https://bintray.com/artifact/download/groovy/maven/groovy-src-{groovy-full-version}.zip[Source Release]
-- **Download documentation**: https://bintray.com/artifact/download/groovy/maven/apache-groovy-docs-{groovy-full-version}.zip[**JavaDoc and zipped online documentation**]
-- **Combined binary / source / documentation bundle**: https://bintray.com/artifact/download/groovy/maven/apache-groovy-sdk-{groovy-full-version}.zip[**Distribution bundle**]
+- **Download zip**: https://groovy.jfrog.io/artifactory/dist-release-local/groovy-zips/apache-groovy-binary-{groovy-full-version}.zip[**Binary Release**] | https://groovy.jfrog.io/artifactory/dist-release-local/groovy-zips/apache-groovy-src-{groovy-full-version}.zip[Source Release]
+- **Download documentation**: https://groovy.jfrog.io/artifactory/dist-release-local/groovy-zips/apache-groovy-docs-{groovy-full-version}.zip[**JavaDoc and zipped online documentation**]
+- **Combined binary / source / documentation bundle**: https://groovy.jfrog.io/artifactory/dist-release-local/groovy-zips/apache-groovy-sdk-{groovy-full-version}.zip[**Distribution bundle**]
You can learn more about this version in the http://groovy-lang.org/releasenotes/groovy-{groovy-short-version}.html[release notes] or in the http://groovy-lang.org/changelogs/changelog-{groovy-full-version}.html[changelog].
@@ -43,47 +47,16 @@ For those who want to test the very latest versions of Groovy and live on the bl
=== Prerequisites
-Groovy {groovy-short-version} requires Java 6+ with full support up to Java 8.
-There are currently some known issues for some aspects when using Java 9 snapshots.
-The `groovy-nio` module requires Java 7+.
-Using Groovy's invokeDynamic features require Java 7+ but we recommend Java 8.
+Groovy {groovy-short-version} requires Java 8+ with support for up to Groovy 16.
-The Groovy CI server is also useful to look at to confirm supported Java versions for different Groovy releases.
-The test suite (getting close to 10000 tests) runs for the currently supported streams of Groovy across
-all the main versions of Java each stream supports.
+Various Groovy CI servers run the test suite (with more than 10000 tests) across numerous versions of Java.
+Those servers are also useful to look at to confirm supported Java versions for different Groovy releases.
== Maven Repository
-If you wish to embed Groovy in your application, you may just prefer to point to your favourite maven repositories or the https://oss.jfrog.org/oss-release-local/org/codehaus/groovy[JCenter maven repository].
-
-=== Stable Release
-
-[cols="1,1,2" options="header"]
-|===
-|Gradle
-|Maven
-|Explanation
-
-|'org.codehaus.groovy:groovy:{groovy-full-version}'
-|<groupId>org.codehaus.groovy</groupId>
-<artifactId>groovy</artifactId>
-<version>{groovy-full-version}</version>
-|Just the core of groovy without the modules (see below).
-
-|'org.codehaus.groovy:groovy-$module:{groovy-full-version}'
-|<groupId>org.codehaus.groovy</groupId>
-<artifactId>groovy-$module</artifactId>
-<version>{groovy-full-version}</version>
-|"$module" stands for the different optional groovy modules "ant", "bsf", "console", "docgenerator", "groovydoc", "groovysh", "jmx", "json", "jsr223", "servlet", "sql", "swing", "test", "testng" and "xml". Example: <artifactId>groovy-sql</artifactId>
-
-|'org.codehaus.groovy:groovy-all:{groovy-full-version}'
-|<groupId>org.codehaus.groovy</groupId>
-<artifactId>groovy-all</artifactId>
-<version>{groovy-full-version}</version>
-|The core plus all the modules. Optional dependencies are marked as optional. You may need to include some of the optional dependencies to use some features of Groovy, e.g. AntBuilder, GroovyMBeans, etc.
-|===
-
-To use the link:invokedynamic-support.html[InvokeDynamic] version of the jars just append ':indy' for Gradle or <classifier>indy</classifier> for Maven.
+If you wish to embed Groovy in your application, you may just prefer to point your build
+to your favourite maven repository or the Groovy https://groovy.jfrog.io/artifactory/libs-release-local/[artifactory instance].
+Please see the https://groovy.apache.org/download.html#buildtools[download page] for available modules for each Groovy version.
[[SDKMAN]]
== SDKMAN! (The Software Development Kit Manager)
@@ -146,11 +119,14 @@ brew install groovy
=== Installation on Windows
-If you're on Windows, you can also use the https://bintray.com/groovy/Distributions/Windows-Installer[Windows installer].
+If you're on Windows, you can also use the https://groovy.jfrog.io/artifactory/dist-release-local/groovy-windows-installer/[Windows installer].
=== Other Distributions
-You may download other distributions of Groovy from https://bintray.com/groovy/maven[this site].
+You may download other distributions of Groovy from the ASF
+https://archive.apache.org/dist/groovy/[archive repository]
+or from the Groovy
+https://groovy.jfrog.io/artifactory/dist-release-local/groovy-zips/[artifactory instance] (also includes pre-ASF versions).
=== Source Code
@@ -162,10 +138,10 @@ If you are an IDE user, you can just grab the latest link:tools-ide.html[IDE plu
== Install Binary
-These instructions describe how to install a binary distribution of **Groovy**.
+These instructions describe how to install a binary distribution of **Groovy**:
-* First, <<download-groovy,Download>> a binary distribution of Groovy and unpack it into some file on your local file system.
-* Set your `GROOVY_HOME` environment variable to the directory you unpacked the distribution.
+* https://groovy.apache.org/download.html[Download] a binary distribution of Groovy and unpack it into some folder on your local file system.
+* Set your `GROOVY_HOME` environment variable to the directory where you unpacked the distribution.
* Add `GROOVY_HOME/bin` to your `PATH` environment variable.
* Set your `JAVA_HOME` environment variable to point to your JDK. On OS X this is `/Library/Java/Home`, on other unixes its often `/usr/java` etc. If you've already installed tools like Ant or Maven you've probably already done this step.
diff --git a/src/spec/doc/grape.adoc b/src/spec/doc/grape.adoc
index 4aef8ea..a005186 100644
--- a/src/spec/doc/grape.adoc
+++ b/src/spec/doc/grape.adoc
@@ -150,7 +150,7 @@ module system for Groovy. This allows a developer to write a script with
an essentially arbitrary library requirement, and ship just the script.
Grape will, at runtime, download as needed and link the named libraries
and all dependencies forming a transitive closure when the script is run
-from existing repositories such as JCenter, Ibiblio and java.net.
+from existing repositories such as Maven Central.
Grape follows the Ivy conventions for module version identification,
with naming change.
diff --git a/src/spec/doc/tools-groovyc.adoc b/src/spec/doc/tools-groovyc.adoc
index 6d81049..a63b0e4 100644
--- a/src/spec/doc/tools-groovyc.adoc
+++ b/src/spec/doc/tools-groovyc.adoc
@@ -451,7 +451,7 @@ The plugin can be applied like this:
buildscript {
repositories {
- jcenter()
+ mavenCentral()
}
dependencies {
classpath 'com.android.tools.build:gradle:2.1.2'