Update dokka to v1.7.10

[renovate]

This PR contains the following updates:

Package	Change	Age	Adoption	Passing	Confidence
org.jetbrains.dokka	1.5.31 -> 1.7.10
org.jetbrains.dokka:dokka-gradle-plugin	1.5.31 -> 1.7.10

---

Release Notes

Kotlin/dokka

v1.7.10

Bugfix release that addresses several blockers and regressions.

General

• Support Kotlin 1.7.10

Gradle plugin

• Do not expose Kotlin stdlib in plugin dependencies, this should fix errors like Module was compiled with an incompatible version of Kotlin when using Dokka. Thanks to @​martinbonnin (#​2543)

Java sources

• Fixed build failure caused by having configured source links for Java code (#​2544)
• Fixed several exotic problems that led to build failures, all related to using annotation in Java sources (#​2509, #​2551, #​2350)
• Fixed IntelliJ platform WARN: Attempt to load key messages that appeared when analyzing Java sources (#​2559)

v1.7.0

Improvements

General

• Update to Kotlin 1.7.0, IntelliJ Platform 213
• Support definitely non-nullable types (https://github.com/Kotlin/dokka/pull/2520)
• Don't expose enum entry constructor arguments, thanks to @​ebraminio (https://github.com/Kotlin/dokka/pull/2497)
• Preserve ordering of enum entries as in source code, previously reversed (https://github.com/Kotlin/dokka/pull/2469)
• Improve support for inherited Java fields with accessors, now properly interpreted as val/var properties (https://github.com/Kotlin/dokka/pull/2481, https://github.com/Kotlin/dokka/pull/2532, https://github.com/Kotlin/dokka/pull/2540)
• Skip @Deprecated members with HIDDEN level (https://github.com/Kotlin/dokka/pull/2486)
• Make rendered default value dependent on source set for expect/actual declarations (https://github.com/Kotlin/dokka/pull/2449)

HTML format

• Render quotes as blockquotes instead of code blocks, thanks to @​TheOnlyTails (https://github.com/Kotlin/dokka/pull/2496)

Javadoc format

• Make Javadoc pages generation deterministic (https://github.com/Kotlin/dokka/pull/2479)
• Update shipped jQuery to avoid multiple CVEs, thanks to @​ToppleTheNun (https://github.com/Kotlin/dokka/issues/1938)

GFM format

• Support rendering of code blocks and inline code used in KDocs, thanks to @​cosinekitty (https://github.com/Kotlin/dokka/pull/2485)

Kotlin-as-Java plugin

• Include Java access modifiers into function signatures, thanks to @​tripolkaandrey (https://github.com/Kotlin/dokka/pull/2510)

Gradle runner

• Make dokka-analysis dependency compileOnly, this should help avoid compatibility problems if different versions of Kotlin are bundled in Gradle and Dokka (https://github.com/Kotlin/dokka/pull/2521)
• Enable stricter validation for cacheable Gradle tasks, thanks to @​3flex (https://github.com/Kotlin/dokka/pull/2500)
• Remove unused & redundant dependencies for Gradle runner, thanks to @​3flex (https://github.com/Kotlin/dokka/pull/2502)
• Remove outdated suppression in Gradle runner, thanks to @​3flex (https://github.com/Kotlin/dokka/pull/2501)

Fixes

General bugfixes

• Fixed a compiler deadlock issue which led to stalling builds in some KMP projects (https://github.com/Kotlin/dokka/pull/2480)
• Fixed incorrect argument names of functional type parameters (https://github.com/Kotlin/dokka/pull/2478)
• Fixed missing external docs for AndroidX libraries, thanks to @​EdricChan03 (https://github.com/Kotlin/dokka/pull/2456)
• Fixed tests failing on Windows, thanks to @​3flex (https://github.com/Kotlin/dokka/pull/2507)

Security

• Get rid of bundled log4j 1.2 that came as a transitive dependency (https://github.com/Kotlin/dokka/issues/2488)
• Update Jackson to avoid CVE-2020-36518, thanks to @​1mt (https://github.com/Kotlin/dokka/pull/2525)

Plugin API

• Decompose base.ftl template: now header.ftl, footer.ftl and page_metadata.ftl can be overridden individually (https://github.com/Kotlin/dokka/pull/2432)

Other

• Add Kotlin stability & support badges, thanks to @​etolstoy (https://github.com/Kotlin/dokka/pull/2511)
• Remove an unused runner parameter, thanks to @​3flex (https://github.com/Kotlin/dokka/pull/2498)
• Correct typos, thanks to @​PaladiRka (https://github.com/Kotlin/dokka/pull/2504) and @​mahozad (https://github.com/Kotlin/dokka/pull/2506)!

Thanks to all the contributors!

v1.6.21

This is a bugfix release that mostly enables building documentation for multiplatform projects that utilize .klib libraries.

Changes

• Support Kotlin 1.6.21
• Update jsoup dependency to avoid CVE-2021-37714 (#​2448)

Bugfixes

• Support KLIB libraries for common platform, previously led to ERROR CLASS instead of references in documentation (#​2441)
• Fixed a maven plugin build problem related to coroutines which only occurred in multi-module builds (#​2461)

v1.6.20

Features

• Introduce documentedVisibilities setting that allows including/excluding any visibility modifier in documentation. This is a more flexible replacement for includeNonPublic, which has now been deprecated (https://github.com/Kotlin/dokka/pull/2270)
• Make HTML pages customizable through FreeMarker HTML templates (https://github.com/Kotlin/dokka/pull/2374)
• Add global settings to JSON dokka CLI input (https://github.com/Kotlin/dokka/pull/2292), thanks to @​BarkingBad!

HTML format changes

• Add vertical alignment (wrapping) of signatures when 3 and more parameters are present (https://github.com/Kotlin/dokka/pull/2309)
• Enhance primary constructor signature, display val/var keywords and default values (https://github.com/Kotlin/dokka/pull/2313)
• Add a level of indentation to childless items in navigation tree (https://github.com/Kotlin/dokka/pull/2291)
• Add horizontal margin to breadcrumbs delimiter (https://github.com/Kotlin/dokka/pull/2285)
• Fixed various CSS rendering issues (https://github.com/Kotlin/dokka/pull/2284, https://github.com/Kotlin/dokka/pull/2389)

Bugfixes

• Fixed OutOfMemoryError: Metaspace-related issues for the majority of cases (https://github.com/Kotlin/dokka/pull/2216)
• Fixed classpath issues for HMPP libraries (https://github.com/Kotlin/dokka/pull/2431)
• Using @ symbol within code blocks in .md files doesn't lead to cropped documents anymore (https://github.com/Kotlin/dokka/pull/2418)
• Fixed incorrect placement of HTML head tags, which led to missing favicon in multi-module projects (https://github.com/Kotlin/dokka/pull/2365)
• Fixed resolution of ultralight methods that led to flaky signature generation (https://github.com/Kotlin/dokka/pull/2400)
• Coroutines dispatchers are now shut down after each module pass to avoid resource leaks (https://github.com/Kotlin/dokka/pull/2325)
• Suppressed property setters are now excluded from documentation (https://github.com/Kotlin/dokka/pull/2220)
• Suppressing extensions doesn't fail builds anymore (https://github.com/Kotlin/dokka/pull/2348), thanks to @​BarkingBad!
• Fixed java getter / setter name generation for kotlin-java interop, now isBoolean instead of getBoolean (https://github.com/Kotlin/dokka/pull/2356), thanks to @​CharlesG-Branch!
• Fixed MathJax plugin, previously completely broken (https://github.com/Kotlin/dokka/pull/2342), thanks to @​wyskoj!
• Fixed Input/Output streams to minimize resource leaks (https://github.com/Kotlin/dokka/pull/2312, https://github.com/Kotlin/dokka/pull/2319)

Plugin API Changes

• Add an extension point for rendering custom documentation tags (https://github.com/Kotlin/dokka/pull/2343)
• Add an extension point for an external documentable provider (https://github.com/Kotlin/dokka/pull/2307), thanks to @​Kordyjan!
• Add filtering stategies extension point and fix constructors in Kotlin-as-Java (https://github.com/Kotlin/dokka/pull/2277), thanks to @​BarkingBad!
• Expose Kotlin-as-Java methods that could be used not only as part of transformers (https://github.com/Kotlin/dokka/pull/2351), thanks to @​BarkingBad!
• Refactor Ancestry Graphs (https://github.com/Kotlin/dokka/pull/2326), thanks to @​BarkingBad!
• Fixed resolving of DRIs for Enum Entries (https://github.com/Kotlin/dokka/pull/2305), thanks to @​BarkingBad!

General Improvements

• Collect annotations from package-info.java (https://github.com/Kotlin/dokka/pull/2331), thanks to @​ember-rose!
• Add support for header tags (<h1> / <h2> / <h3>) in Javadoc (https://github.com/Kotlin/dokka/pull/2345), thanks to @​asfalcone!
• Add an option to merge implicit expect-actual declarations, enables merging of pages for related declarations which are not connected via expect-actual keywords (https://github.com/Kotlin/dokka/pull/2316)
• Add a note about using Dokka in a precompiled script plugin (https://github.com/Kotlin/dokka/pull/2303), thanks to @​chkpnt!
• Fixed wrong Groovy DSL example (https://github.com/Kotlin/dokka/pull/2302), thanks to @​chkpnt!
• Various code cleanups (https://github.com/Kotlin/dokka/pull/2165, https://github.com/Kotlin/dokka/pull/2360, https://github.com/Kotlin/dokka/pull/2364, https://github.com/Kotlin/dokka/pull/2385), thanks to @​Goooler!

Known issues

• Kotlin Multiplatform projects that use .klib libraries may experience problems. There will be a separate 1.6.21 release that will address this issue shortly.

v1.6.10

Changes

• Support Kotlin 1.6.10
• Add a sample project for versioning multi-module (https://github.com/Kotlin/dokka/pull/2170)

Bugfixes

• Fix various java.util.zip.ZipException for JS dependencies (https://github.com/Kotlin/dokka/pull/2258)
• Fix handling of Description Lists (<dl>) used in JavaDocs (https://github.com/Kotlin/dokka/pull/2259)
• Fix for "repositories not defined" issue in versioning multimodule example (https://github.com/Kotlin/dokka/pull/2263), thanks @​rajdeep1008!
• Fix multiple rendering issues for "See Also" block for html format (https://github.com/Kotlin/dokka/pull/2267)
• Fix sample body not being embedded to documentation (https://github.com/Kotlin/dokka/pull/2216)

Maintenance

• Update npm dependencies (https://github.com/Kotlin/dokka/pull/2251)
• Bump de.undercouch.download to 4.1.2 (https://github.com/Kotlin/dokka/pull/2268)
• Bump kotlinx.coroutines to 1.6.0 in integration tests (https://github.com/Kotlin/dokka/pull/2276)

v1.6.0

Changes:

• New UI
• Support of version plugin for single module projects
• Allow package-level suppression (#​2209), thanks @​owengray-google
• GFM: Use Markdown syntax to render lists (#​2098), thanks @​sgilson
• Fix names of nested inheritors
• Fix adding new custom stylesheets in submodules
• Add keywords expect and actual in signatures

---

Configuration

📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about these updates again.

---

• If you want to rebase/retry this PR, click this checkbox.

---

This PR has been generated by Mend Renovate. View repository job log here.