-
Notifications
You must be signed in to change notification settings - Fork 0
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 dependency org.jetbrains.dokka:kotlin-as-java-plugin to v1.9.10 #26
Update dependency org.jetbrains.dokka:kotlin-as-java-plugin to v1.9.10 #26
Conversation
61fd11c
to
fe122f5
Compare
Kudos, SonarCloud Quality Gate passed! |
fe122f5
to
07bd3fd
Compare
Kudos, SonarCloud Quality Gate passed! |
07bd3fd
to
0fe5a24
Compare
Kudos, SonarCloud Quality Gate passed! |
0fe5a24
to
8ae7c22
Compare
Kudos, SonarCloud Quality Gate passed! |
8ae7c22
to
3468b17
Compare
Kudos, SonarCloud Quality Gate passed! |
3468b17
to
e46b30f
Compare
Kudos, SonarCloud Quality Gate passed! 0 Bugs No Coverage information |
e46b30f
to
05baba7
Compare
Kudos, SonarCloud Quality Gate passed! 0 Bugs No Coverage information |
This PR contains the following updates:
1.6.10
->1.9.10
Release Notes
Kotlin/dokka (org.jetbrains.dokka:kotlin-as-java-plugin)
v1.9.10
: 1.9.10 BetaGeneral
HTML format
Gradle
Java
v1.9.0
: 1.9.0 BetaGeneral improvements
HTML format
This release is packed with enhancements and bugfixes that make your API reference docs mobile-friendly!
You may find it a weird direction for improvement — we were just as surprised to find that almost 1/4 of Standard Library's API reference traffic is coming from mobile devices. Thanks to the Kotlin Website team, who contributed these improvements, Dokka now provides a solid experience to such visitors.
Improvements:
Bugfixes
Java interoperability
Javadoc format
@author
,@since
and@return
tags (https://github.com/Kotlin/dokka/issues/1770). Thanks to @irina-turova!Other
Known problems
Some Multiplatform Gradle 8 projects might experience build failures when resolving native/platform dependencies. Please, see https://github.com/Kotlin/dokka/issues/3153 for more details and workarounds.
Breaking changes
This release introduces some breaking changes that are expected to affect only a fraction of Dokka users.
HTML
Note: this section only applies to those customizing Dokka's HTML format by overriding styles or HTML templates. If you are not doing any customizations, you may skip this section.
To lay a solid foundation to making the HTML format responsive, some page layouts and many styles had to be changed in a backward-incompatible manner.
If you are overriding
logo-styles.css
to provide your own header logo, please update it to be in line with the new styles - there is significantly less position hardcoding now. See this example for how it can be done.If you are overriding
styles.css
with your own file, please update the baseline styles to the latest, and see if anything is broken. If you get stuck with adapting your styles to the changes, the diff might help.If you are overriding
base.ftl
orheader.ftl
templates, please update them to the latest, and adapt your changes.CLI runner
Due to the analysis refactoring needed for the migration to K2 (#3099), the JARs required to run Dokka have slightly changed.
The following JARs are no longer supported or published:
Please, replace them with a single JAR:
Plugin API
An internal refactoring of Dokka's analysis API was much needed for the migration to K2, leading to breaking changes in some cases.
If your Dokka plugin compiles without any problems — you may ignore this information, you are likely not affected.
If something doesn't compile or doesn't work anymore, please see #3099 for more details.
v1.8.20
: 1.8.20 BetaImprovements
Bugfixes
TypeNotPresentException
thrown in projects without KGP (#2890), regression from 1.8.10.Gradle plugin
kotlin-dsl
plugin (#2702, #2833). Thanks to @aSemy!Plugin API
DokkaConsoleLogger
) toPROGRESS
(#2871)@InternalDokkaApi
annotation (#2904)Infrastructure
Big thanks to @aSemy, @Goooler and @3flex for their valuable contributions and for improving the internal
developer experience when working on Dokka!
buildSrc
to a composite build (#2912 by @Goooler)Documentation
README.md
(#2940). Thanks to @Goooler!CONTRIBUTING.md
(#2952)Security
Other
v1.8.10
: 1.8.10 BetaDokka's documentation has been entirely rewritten and can now be found on kotlinlang.org:
Note: Version 1.8.0 was skipped due to a Metaspace memory leak in Kotlin's reflection (KT-56093). Dokka 1.8.10 should be fully compatible with Kotlin 1.8.0.
Improvements
Inheritors
,Parameters
,See also
andSamples
tabs into the main declaration description (#2688).Members
andMembers & Extensions
tabs to class-like declaration pages (#2764).Bugfixes
var
properties being displayed (#2717).DokkaLogger
(#2827).Gradle Plugin
NoSuchMethodError
when running under Gradle 8 (#2796).outputDirectory
input property (#556).moduleVersion
input property (#2799). Thanks to @JavierSegoviaCordoba!MultiModule
tasks (#2806). Thanks to @TWiStErRob!Javadoc
javadoc.jar
produced by Dokka is imported into IntelliJ IDEA / Android Studio (#2734). Thanks to @bomberaya!Plugin API
Infrastructure
Other
jackson-databind
to avoid CVE-2022-42003 (#2733). Thanks to @ryanlewis!Jsoup
to avoid CVE-2022-36033 (#2772).v1.7.20
: 1.7.20 BetaThis release focuses primarily on improving user experience and HTML format in particular.
Improvements
General
suppressInheritedMembers
configuration property) (#2625)@Deprecated
declarations such as deprecation message, level and proposed replacement (#2622)Enum
's syntheticvalues()
andvalueOf()
functions (#2650)Java
constants (#2609)HTML format
Cmd + K
/Ctrl + K
hotkey for opening search dialog, thanks to @atyrin! (#2633)Javadoc format
var
HTML tag, thanks to @atyrin (#2617)Kotlin-as-Java plugin
Gradle runner
kotlin-stdlib
dependency, which should fix errors likeModule was compiled with an incompatible version of Kotlin
, thanks to @martinbonnin! (#2570)Bugfixes
Markdown
elements, where_try_ *this*
would be rendered astrythis
(#2640)StackOverflowError
related to type-aliased native references (#2664)IllegalStateException
that was caused by using JS's dynamic types (#2645)private
declarations were rendered aspublic
(#2639)@see
tag (#2627)Java
Enum types being rendered asAny
(#2647)Java
annotation params (#2593)sourceRoots
configuration param not handling single.java
files, thanks to @2017398956! (#2604)dokka-customFormat-example
project to use up-to-date logo styles (#2608)Developer experience
Gradle Enterprise
build scans, thanks to @Goooler! (#2641)GitHub Actions
artifacts to store generated documentation snapshots, thanks to @StefMa! (#2630)Other
v1.7.10
: 1.7.10 BetaBugfix release that addresses several blockers and regressions.
General
Kotlin
1.7.10Gradle plugin
Kotlin
stdlib in plugin dependencies, this should fix errors likeModule was compiled with an incompatible version of Kotlin
when usingDokka
. Thanks to @martinbonnin (#2543)Java sources
Java
code (#2544)Java
sources (#2509, #2551, #2350)IntelliJ
platformWARN: Attempt to load key
messages that appeared when analyzingJava
sources (#2559)v1.7.0
: 1.7.0 BetaImprovements
General
Kotlin
1.7.0,IntelliJ
Platform 213Java
fields with accessors, now properly interpreted asval
/var
properties (https://github.com/Kotlin/dokka/pull/2481, https://github.com/Kotlin/dokka/pull/2532, https://github.com/Kotlin/dokka/pull/2540)@Deprecated
members withHIDDEN
level (https://github.com/Kotlin/dokka/pull/2486)HTML format
Javadoc format
Javadoc
pages generation deterministic (https://github.com/Kotlin/dokka/pull/2479)jQuery
to avoid multiple CVEs, thanks to @ToppleTheNun (https://github.com/Kotlin/dokka/issues/1938)GFM format
Kotlin-as-Java plugin
Java
access modifiers into function signatures, thanks to @tripolkaandrey (https://github.com/Kotlin/dokka/pull/2510)Gradle runner
dokka-analysis
dependencycompileOnly
, this should help avoid compatibility problems if different versions ofKotlin
are bundled inGradle
andDokka
(https://github.com/Kotlin/dokka/pull/2521)Gradle
tasks, thanks to @3flex (https://github.com/Kotlin/dokka/pull/2500)Gradle
runner, thanks to @3flex (https://github.com/Kotlin/dokka/pull/2502)Gradle
runner, thanks to @3flex (https://github.com/Kotlin/dokka/pull/2501)Fixes
General bugfixes
Security
log4j
1.2 that came as a transitive dependency (https://github.com/Kotlin/dokka/issues/2488)Plugin API
base.ftl
template: nowheader.ftl
,footer.ftl
andpage_metadata.ftl
can be overridden individually (https://github.com/Kotlin/dokka/pull/2432)Other
Thanks to all the contributors!
v1.6.21
: 1.6.21 BetaThis is a bugfix release that mostly enables building documentation for multiplatform projects that utilize
.klib
libraries.Changes
jsoup
dependency to avoid CVE-2021-37714 (#2448)Bugfixes
KLIB
libraries for common platform, previously led toERROR CLASS
instead of references in documentation (#2441)v1.6.20
: 1.6.20 BetaFeatures
documentedVisibilities
setting that allows including/excluding any visibility modifier in documentation. This is a more flexible replacement forincludeNonPublic
, which has now been deprecated (https://github.com/Kotlin/dokka/pull/2270)HTML format changes
val
/var
keywords and default values (https://github.com/Kotlin/dokka/pull/2313)Bugfixes
OutOfMemoryError: Metaspace
-related issues for the majority of cases (https://github.com/Kotlin/dokka/pull/2216)@
symbol within code blocks in.md
files doesn't lead to cropped documents anymore (https://github.com/Kotlin/dokka/pull/2418)isBoolean
instead ofgetBoolean
(https://github.com/Kotlin/dokka/pull/2356), thanks to @CharlesG-Branch!Plugin API Changes
General Improvements
package-info.java
(https://github.com/Kotlin/dokka/pull/2331), thanks to @ember-rose!<h1>
/<h2>
/<h3>
) in Javadoc (https://github.com/Kotlin/dokka/pull/2345), thanks to @asfalcone!expect
-actual
keywords (https://github.com/Kotlin/dokka/pull/2316)Known issues
.klib
libraries may experience problems. There will be a separate1.6.21
release that will address this issue shortly.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 this update again.
This PR has been generated by Mend Renovate. View repository job log here.