Skip to content

Commit 7227acf

Browse files
chore(deps): update plugin org.jetbrains.dokka to v2.1.0 (#2110)
This PR contains the following updates: | Package | Change | Age | Confidence | |---|---|---|---| | [org.jetbrains.dokka](https://redirect.github.com/Kotlin/dokka) | `2.0.0` -> `2.1.0` | [![age](https://developer.mend.io/api/mc/badges/age/maven/org.jetbrains.dokka:org.jetbrains.dokka.gradle.plugin/2.1.0?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![confidence](https://developer.mend.io/api/mc/badges/confidence/maven/org.jetbrains.dokka:org.jetbrains.dokka.gradle.plugin/2.0.0/2.1.0?slim=true)](https://docs.renovatebot.com/merge-confidence/) | --- > [!WARNING] > Some dependencies could not be looked up. Check the Dependency Dashboard for more information. --- ### Release Notes <details> <summary>Kotlin/dokka (org.jetbrains.dokka)</summary> ### [`v2.1.0`](https://redirect.github.com/Kotlin/dokka/releases/tag/v2.1.0): 2.1.0-Beta #### Dokka's Gradle plugin v2 is enabled by default! > Please check the [migration guide](https://kotl.in/dokka-gradle-migration) for the update procedure [Dokka 2.0.0](https://redirect.github.com/Kotlin/dokka/releases/tag/v2.0.0) introduced a significantly improved Gradle plugin v2, and with Dokka 2.1.0-Beta it is now **[enabled by default](https://redirect.github.com/Kotlin/dokka/pull/4133)!** As a result, all types and Gradle tasks related to Dokka Gradle plugin v1 are [deprecated](https://redirect.github.com/Kotlin/dokka/pull/4135) and will be removed in future releases. Running Gradle tasks related to Dokka Gradle plugin v1 [will result in an error](https://redirect.github.com/Kotlin/dokka/pull/4187) during execution. Starting from this release, the minimum supported Gradle version is 7.6.3. ##### Other fixes and improvements - Update Gradle Properties types to be non-nullable ([#&#8203;4136](https://redirect.github.com/Kotlin/dokka/pull/4136)) - Update displayName convention for DokkaSourceSets ([#&#8203;4142](https://redirect.github.com/Kotlin/dokka/pull/4142)) - Update olderVersionsDir to be an optional input. ([#&#8203;4155](https://redirect.github.com/Kotlin/dokka/pull/4155)) - Add lifecycle tasks for generating formats ([#&#8203;4141](https://redirect.github.com/Kotlin/dokka/pull/4141)) - Use project name as default `modulePath` for root project to avoid clashing outputs during aggregation ([#&#8203;4158](https://redirect.github.com/Kotlin/dokka/pull/4158)) - Remove Dokka debug config file from task outputs ([#&#8203;3961](https://redirect.github.com/Kotlin/dokka/pull/3961)) - Remove V2EnabledWithHelpers warning & info message ([#&#8203;4206](https://redirect.github.com/Kotlin/dokka/pull/4206)) #### Dokka's K2 analysis is enabled by default! Dokka 2.1.0-Beta fixes the most problematic issues with K2 analysis and makes it **enabled by default!** In addition to this, Dokka 2.1.0-Beta with K2 analysis introduces support for **[context parameters](https://redirect.github.com/Kotlin/dokka/pull/4080)!** Dokka's K2 analysis leverages Kotlin's K2 compiler frontend for analysing code and uses the same shared Analysis API, which is used in IntelliJ IDEA’s K2 mode. The output with K2 analysis should mostly match that of K1 analysis, but there may be minor differences. If you previously opted in to Dokka's K2 analysis, **remove** `org.jetbrains.dokka.experimental.tryK2` from your project's `gradle.properties` file. Dokka's K1 analysis is still available, but it is deprecated and will be removed in future releases. We would greatly appreciate your feedback, if there is something that is blocking you from migrating to K2 analysis! ##### Other fixes and improvements - Fix merging of implicit expect/actual with a single declaration ([#&#8203;4016](https://redirect.github.com/Kotlin/dokka/pull/4016)) - Support Wasm platform fully ([#&#8203;4123](https://redirect.github.com/Kotlin/dokka/pull/4123)) - Fix `override` modifier for generic functions ([#&#8203;4126](https://redirect.github.com/Kotlin/dokka/pull/4126)) - Add a receiver to accessor DRI ([#&#8203;4122](https://redirect.github.com/Kotlin/dokka/pull/4122)) - Fix param tag for type parameter on implicit primary constructor ([#&#8203;4154](https://redirect.github.com/Kotlin/dokka/pull/4154)) - Fix the primary constructor parameter incorrectly marked as a property ([#&#8203;4125](https://redirect.github.com/Kotlin/dokka/pull/4125)) - Fix Javadoc links with generic parameters ([#&#8203;4159](https://redirect.github.com/Kotlin/dokka/pull/4159)) - Show the correct return type when narrowed by inheritance ([#&#8203;4183](https://redirect.github.com/Kotlin/dokka/issues/4183)) #### HTML format refinement Dokka 2.1.0-Beta introduces a number of design improvements to the HTML output. Many UI elements (listed below) now feature more consistent spacing, better contrast, and improved overall accessibility. **Highlights:** - Improved accessibility of the Search popup and Table of Contents and Tabs - Resizable Table of Contents - Customizable spacing in the Table of Contents via a new set of CSS variables (See [#&#8203;4184](https://redirect.github.com/Kotlin/dokka/pull/4184) for details) In addition, the structure of the templates has been slightly modified. If you're using custom templates, the easiest way to migrate is to update your templates based on the [latest default templates](https://redirect.github.com/Kotlin/dokka/tree/2.1.0/dokka-subprojects/plugin-base/src/main/resources/dokka/templates). For example, to enable the resizable Table of Contents, you need to add a `<div id="resizer">` element and add `[data-item-type]` attributes to container elements. For implementation details, see [the template reference](https://redirect.github.com/Kotlin/dokka/blob/db6f1c9863b2925859394f9e86e4ade18ab8fc11/dokka-subprojects/plugin-base/src/main/resources/dokka/templates/base.ftl#L55). **Updated UI Elements:** - Main layout - Table of Contents - Footer - Search popup - Code areas and code blocks - Links - Tooltips - Tables - Markdown tables #### Notable improvements - Performance: - Cache `packages` field, which is used by `DefaultExternalLocationProvider.resolve` ([#&#8203;4009](https://redirect.github.com/Kotlin/dokka/pull/4009)) - Cache `DisplaySourceSet` as it's stored a lot inside of `ContentPage`s ([#&#8203;4008](https://redirect.github.com/Kotlin/dokka/pull/4008)) - Significantly improves the performance when working with `PackageList` ([#&#8203;4198](https://redirect.github.com/Kotlin/dokka/pull/4198)) - Support a newline inside link text ([#&#8203;3661](https://redirect.github.com/Kotlin/dokka/issues/3661)) - Resolve references to quoted names ([#&#8203;3356](https://redirect.github.com/Kotlin/dokka/issues/3356)) - Update jackson to 2.15.3, which doesn't have known vulnerabilities ([#&#8203;4189](https://redirect.github.com/Kotlin/dokka/pull/4189)) - Make Dokka safe for jackson updates in user projects ([#&#8203;4193](https://redirect.github.com/Kotlin/dokka/pull/4193)) #### Other changes and bugfixes - Update java supertype processing ([#&#8203;3997](https://redirect.github.com/Kotlin/dokka/pull/3997)). Thanks to [@&#8203;juliamcclellan](https://redirect.github.com/juliamcclellan)! - Filter non-directory and hidden files from version directories ([#&#8203;3973](https://redirect.github.com/Kotlin/dokka/pull/3973)). Thanks to [@&#8203;jeffdgr8](https://redirect.github.com/jeffdgr8)! - Drop last additional newline character added when rewriting parsed HTML ([#&#8203;3974](https://redirect.github.com/Kotlin/dokka/pull/3974)). Thanks to [@&#8203;jeffdgr8](https://redirect.github.com/jeffdgr8)! - Fix constructor details to show description instead of brief in Javadoc ([#&#8203;4105](https://redirect.github.com/Kotlin/dokka/pull/4105)). Thanks to [@&#8203;dmitrysulman](https://redirect.github.com/dmitrysulman)! - Remove trove4j from dependencies ([#&#8203;3178](https://redirect.github.com/Kotlin/dokka/issues/3178)) - Make Dokka compatible with JDK 25 ([#&#8203;4202](https://redirect.github.com/Kotlin/dokka/pull/4202)) - Fix parsing of `>` in code blocks ([#&#8203;4210](https://redirect.github.com/Kotlin/dokka/pull/4210)) #### Feedback We would appreciate your feedback! - Please report any feedback or problems <https://kotl.in/dokka-issues> - Chat with the community visit #dokka in <https://kotlinlang.slack.com/> (To sign up visit <https://kotl.in/slack>) See Dokka [2.1.0](https://redirect.github.com/Kotlin/dokka/milestone/32?closed=1) milestone for the list of all changes. </details> --- ### Configuration 📅 **Schedule**: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined). 🚦 **Automerge**: Enabled. ♻ **Rebasing**: Whenever PR is behind base branch, or you tick the rebase/retry checkbox. 🔕 **Ignore**: Close this PR and you won't be reminded about this update again. --- - [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check this box --- This PR was generated by [Mend Renovate](https://mend.io/renovate/). View the [repository job log](https://developer.mend.io/github/typesafegithub/github-workflows-kt). <!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiI0MS4xNDMuMSIsInVwZGF0ZWRJblZlciI6IjQxLjE0My4xIiwidGFyZ2V0QnJhbmNoIjoibWFpbiIsImxhYmVscyI6W119--> Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
1 parent 06b7154 commit 7227acf

1 file changed

Lines changed: 1 addition & 1 deletion

File tree

github-workflows-kt/build.gradle.kts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ plugins {
1616
id("io.gitlab.arturbosch.detekt")
1717
id("org.jetbrains.kotlinx.binary-compatibility-validator") version "0.18.1"
1818

19-
id("org.jetbrains.dokka") version "2.0.0"
19+
id("org.jetbrains.dokka") version "2.1.0"
2020
}
2121

2222
group = rootProject.group

0 commit comments

Comments
 (0)