Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Deprecate alternative JVM plugins #11598

Merged
merged 4 commits into from
Dec 10, 2019

Conversation

jjohannes
Copy link
Contributor

@jjohannes jjohannes commented Dec 5, 2019

See #9837

Notes:

  • I added @Deprecated to all API types that are exclusively used by the deprecated plugins. In particular, I checked everything that was still incubating in the corresponding projects, because a type that has been around since Gradle 2.x/3.x should either be deprecated or be de-incubated. There is one type, JavadocArtifact, which I left incubating but did not deprecate (yet) because it is also used in the artifact query API (which we will probably also deprecate soonish).
  • I did not add any docs here. I think mentioning this in the release notes / upgrade guide is only confusing, since these should have been deprecated for a long time. I don't want users to get confuesed. The names are all so similar: java, java-library, java-lang, ...

@@ -31,7 +30,6 @@
/**
* Options for Scala platform compilation.
*/
@Incubating
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This type is also used by the "normal" scala plugin and is thus not deprecated. It should not be incubating.

@jjohannes jjohannes added this to the 6.1 RC1 milestone Dec 5, 2019
@adammurdoch
Copy link
Member

I think we should document this in some form. We will just need to be careful about the wording.

@jjohannes jjohannes force-pushed the jjohannes/deprecate-alternative-jvm-plugins branch 3 times, most recently from 1aa9473 to 435cc83 Compare December 6, 2019 12:38
@jjohannes
Copy link
Contributor Author

Thanks for the feedback @adammurdoch .

I added a section to the upgrading guide: 9ebe8e4

Before I adjust all tests, I would like to decide on a deprecation warning. Proposal (would add the same message for all deprecations):

SingleMessageLogger.nagUserOfDeprecatedPlugin("java-lang", "Consult the upgrading guide for further information: " +
            new DocumentationRegistry().getDocumentationFor("upgrading_version_6", "upgrading_jvm_plugins"));

Renders to:

The java-lang plugin has been deprecated. This is scheduled to be removed in Gradle 7.0. Consult the upgrading guide for further information: https://docs.gradle.org/6.1/userguide/upgrading_version_6.html#upgrading_jvm_plugins

@jjohannes jjohannes force-pushed the jjohannes/deprecate-alternative-jvm-plugins branch 4 times, most recently from 5943ad5 to fad870e Compare December 9, 2019 20:37
@jjohannes jjohannes force-pushed the jjohannes/deprecate-alternative-jvm-plugins branch from fad870e to 17485f5 Compare December 9, 2019 20:49
@jjohannes jjohannes merged commit 6d36d28 into master Dec 10, 2019
@jjohannes jjohannes deleted the jjohannes/deprecate-alternative-jvm-plugins branch December 10, 2019 14:00
jjohannes added a commit that referenced this pull request Feb 19, 2020
This was deprecated as part of #11598. We missed that it can also be
used in artifact resolution queries which are not (yet) deprecated.

For example:

dependencies {
  createArtifactResolutionQuery().withArtifacts(JvmLibrary, ...)
}
jjohannes added a commit that referenced this pull request Feb 22, 2020
This was deprecated as part of #11598. We missed that it can also be
used in artifact resolution queries which are not (yet) deprecated.

For example:

dependencies {
  createArtifactResolutionQuery().withArtifacts(JvmLibrary, ...)
}
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants