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

Update genjavadoc-plugin to 0.18_2.13.8 #728

Merged

Conversation

scala-steward
Copy link
Contributor

Updates com.typesafe.genjavadoc:genjavadoc-plugin from 0.18_2.12.15 to 0.18_2.13.8.
GitHub Release Notes - Version Diff

I'll automatically update this PR to resolve conflicts as long as you don't change it yourself.

If you'd like to skip this version, you can just close this PR. If you have any feedback, just mention me in the comments below.

Configure Scala Steward for your repository with a .scala-steward.conf file.

Have a fantastic day writing Scala!

Ignore future updates

Add this to your .scala-steward.conf file to ignore future updates of this dependency:

updates.ignore = [ { groupId = "com.typesafe.genjavadoc", artifactId = "genjavadoc-plugin" } ]

labels: library-update, commit-count:1

@@ -18,7 +18,7 @@
enablePlugins(GenJavadocPlugin)
enablePlugins(PublishJavadocPlugin)

unidocGenjavadocVersion := "0.18_2.12.15"
unidocGenjavadocVersion := "0.18_2.13.8"
Copy link
Member

Choose a reason for hiding this comment

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

I think we don't actually want to merge this? The CI tests pass, but I assume we want to stick with the version of genjavadoc that matches our scala version (2.12.15)?

In fact, looking at the GenJavaDocPlugin, I wonder if we should even being including the scala version in the value of unidocGenjavadocVersion? Looking at this file:

https://github.com/sbt/sbt-unidoc/blob/master/src/main/scala/sbtunidoc/GenJavadocPlugin.scala

The setting defaults to just "0.18" and uses crossVersion to get the right Scala version. Seems like maybe we should change this back to just "0.18"?

Copy link
Contributor

Choose a reason for hiding this comment

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

I looked at sbt/sbt-unidoc#110, https://github.com/sbt/sbt-unidoc, and https://github.com/apache/daffodil/blame/main/daffodil-japi/build.sbt to determine why we need that unidocGenjavadocVersion line (we need it because the old default, 0.15, doesn't work anymore, a PR changed it to 0.18 in the sbt-unidoc repo only yesterday, and a new sbt-unidoc release hasn't been made yet), whether we should keep that unidocGenjavadocVersion line (yes because the default in the last released sbt-unidoc version is still 0.15), when we first added that unidocGenjavadocVersion line (in your PR #398 almost two years ago), and why it changed to include a Scala cross version (blame Scala Steward for adding it in PR #634). I agree you can change it back to "0.18" and leave it there, but Scala Stewart may add a new Scala cross version to it again in the future. If you change that line anyway, you probably want to add a comment to remind us that the cross version shouldn't be needed and find a way to tell Scala Stewart not to add a cross version again (if possible).

Copy link
Member

Choose a reason for hiding this comment

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

Thanks for confirming my thinking. Looking at the scala-steward configuration options, nothing jumps out at me as a way to prevent this. And we don't want to ignore this line altogether since we'll still want PRs if genjavadoc creates a new release.

I've fixed this and added a comment so we hopefully catch it if Scala Steward tries this again.

@stevedlawrence stevedlawrence force-pushed the update/genjavadoc-plugin-0.18_2.13.8 branch from 74e7fd7 to cc454ce Compare January 14, 2022 13:13
Copy link
Contributor

@tuxji tuxji left a comment

Choose a reason for hiding this comment

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

+1

I love the new comment. Well said!

@stevedlawrence
Copy link
Member

+1

@stevedlawrence stevedlawrence merged commit f2f85e0 into apache:main Jan 20, 2022
@scala-steward scala-steward deleted the update/genjavadoc-plugin-0.18_2.13.8 branch January 20, 2022 17:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants