-
Notifications
You must be signed in to change notification settings - Fork 410
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
Make javadoc pages generation deterministic #2479
Conversation
e8b12b7
to
bbcc20c
Compare
plugins/javadoc/src/test/kotlin/org/jetbrains/dokka/javadoc/JavadocIndexTest.kt
Outdated
Show resolved
Hide resolved
} | ||
|
||
private fun NavigableJavadocNode.getFullComparatorKey(): String { | ||
return getDRI().let { dri -> |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
DRI.toString
is the same logic.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
It's generally bad to build business logic around and rely on .toString()
. It's good for debugging, but very error-prone and difficult to get rid of in pretty much all other cases
Ideally, I'd actually like to get rid of all DRI.toString
calls and replace them with some other method that you can easily find usages of
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
It's generally bad to build business logic around and rely on .toString()
Yes, so an comparator of DRI should be here.
[![Mend Renovate](https://app.renovatebot.com/images/banner.svg)](https://renovatebot.com) This PR contains the following updates: | Package | Change | Age | Adoption | Passing | Confidence | |---|---|---|---|---|---| | [org.jetbrains.dokka](https://github.com/Kotlin/dokka) | `1.5.31` -> `1.7.10` | [![age](https://badges.renovateapi.com/packages/maven/org.jetbrains.dokka/1.7.10/age-slim)](https://docs.renovatebot.com/merge-confidence/) | [![adoption](https://badges.renovateapi.com/packages/maven/org.jetbrains.dokka/1.7.10/adoption-slim)](https://docs.renovatebot.com/merge-confidence/) | [![passing](https://badges.renovateapi.com/packages/maven/org.jetbrains.dokka/1.7.10/compatibility-slim/1.5.31)](https://docs.renovatebot.com/merge-confidence/) | [![confidence](https://badges.renovateapi.com/packages/maven/org.jetbrains.dokka/1.7.10/confidence-slim/1.5.31)](https://docs.renovatebot.com/merge-confidence/) | | [org.jetbrains.dokka:dokka-gradle-plugin](https://github.com/Kotlin/dokka) | `1.5.31` -> `1.7.10` | [![age](https://badges.renovateapi.com/packages/maven/org.jetbrains.dokka:dokka-gradle-plugin/1.7.10/age-slim)](https://docs.renovatebot.com/merge-confidence/) | [![adoption](https://badges.renovateapi.com/packages/maven/org.jetbrains.dokka:dokka-gradle-plugin/1.7.10/adoption-slim)](https://docs.renovatebot.com/merge-confidence/) | [![passing](https://badges.renovateapi.com/packages/maven/org.jetbrains.dokka:dokka-gradle-plugin/1.7.10/compatibility-slim/1.5.31)](https://docs.renovatebot.com/merge-confidence/) | [![confidence](https://badges.renovateapi.com/packages/maven/org.jetbrains.dokka:dokka-gradle-plugin/1.7.10/confidence-slim/1.5.31)](https://docs.renovatebot.com/merge-confidence/) | --- ### Release Notes <details> <summary>Kotlin/dokka</summary> ### [`v1.7.10`](https://github.com/Kotlin/dokka/releases/tag/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](https://github.com/martinbonnin) ([#​2543](https://github.com/Kotlin/dokka/issues/2543)) ##### Java sources - Fixed build failure caused by having configured source links for `Java` code ([#​2544](https://github.com/Kotlin/dokka/issues/2544)) - Fixed several exotic problems that led to build failures, all related to using annotation in `Java` sources ([#​2509](https://github.com/Kotlin/dokka/issues/2509), [#​2551](https://github.com/Kotlin/dokka/issues/2551), [#​2350](https://github.com/Kotlin/dokka/issues/2350)) - Fixed `IntelliJ` platform `WARN: Attempt to load key` messages that appeared when analyzing `Java` sources ([#​2559](https://github.com/Kotlin/dokka/issues/2559)) ### [`v1.7.0`](https://github.com/Kotlin/dokka/releases/tag/v1.7.0) ##### Improvements ##### General - Update to `Kotlin` 1.7.0, `IntelliJ` Platform 213 - Support [definitely non-nullable types](https://kotlinlang.org/docs/whatsnew17.html#stable-definitely-non-nullable-types) ([https://github.com/Kotlin/dokka/pull/2520](https://github.com/Kotlin/dokka/pull/2520)) - Don't expose enum entry constructor arguments, thanks to [@​ebraminio](https://github.com/ebraminio) ([https://github.com/Kotlin/dokka/pull/2497](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](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/2481), [https://github.com/Kotlin/dokka/pull/2532](https://github.com/Kotlin/dokka/pull/2532), [https://github.com/Kotlin/dokka/pull/2540](https://github.com/Kotlin/dokka/pull/2540)) - Skip `@Deprecated` members with `HIDDEN` level ([https://github.com/Kotlin/dokka/pull/2486](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](https://github.com/Kotlin/dokka/pull/2449)) ##### HTML format - Render quotes as blockquotes instead of code blocks, thanks to [@​TheOnlyTails](https://github.com/TheOnlyTails) ([https://github.com/Kotlin/dokka/pull/2496](https://github.com/Kotlin/dokka/pull/2496)) ##### Javadoc format - Make `Javadoc` pages generation deterministic ([https://github.com/Kotlin/dokka/pull/2479](https://github.com/Kotlin/dokka/pull/2479)) - Update shipped `jQuery` to avoid multiple CVEs, thanks to [@​ToppleTheNun](https://github.com/ToppleTheNun) ([https://github.com/Kotlin/dokka/issues/1938](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/cosinekitty) ([https://github.com/Kotlin/dokka/pull/2485](https://github.com/Kotlin/dokka/pull/2485)) ##### Kotlin-as-Java plugin - Include `Java` access modifiers into function signatures, thanks to [@​tripolkaandrey](https://github.com/tripolkaandrey) ([https://github.com/Kotlin/dokka/pull/2510](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](https://github.com/Kotlin/dokka/pull/2521)) - Enable stricter validation for cacheable `Gradle` tasks, thanks to [@​3flex](https://github.com/3flex) ([https://github.com/Kotlin/dokka/pull/2500](https://github.com/Kotlin/dokka/pull/2500)) - Remove unused & redundant dependencies for `Gradle` runner, thanks to [@​3flex](https://github.com/3flex) ([https://github.com/Kotlin/dokka/pull/2502](https://github.com/Kotlin/dokka/pull/2502)) - Remove outdated suppression in `Gradle` runner, thanks to [@​3flex](https://github.com/3flex) ([https://github.com/Kotlin/dokka/pull/2501](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](https://github.com/Kotlin/dokka/pull/2480)) - Fixed incorrect argument names of functional type parameters ([https://github.com/Kotlin/dokka/pull/2478](https://github.com/Kotlin/dokka/pull/2478)) - Fixed missing external docs for AndroidX libraries, thanks to [@​EdricChan03](https://github.com/EdricChan03) ([https://github.com/Kotlin/dokka/pull/2456](https://github.com/Kotlin/dokka/pull/2456)) - Fixed tests failing on Windows, thanks to [@​3flex](https://github.com/3flex) ([https://github.com/Kotlin/dokka/pull/2507](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](https://github.com/Kotlin/dokka/issues/2488)) - Update Jackson to avoid [CVE-2020-36518](https://nvd.nist.gov/vuln/detail/CVE-2020-36518), thanks to [@​1mt](https://github.com/1mt) ([https://github.com/Kotlin/dokka/pull/2525](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](https://github.com/Kotlin/dokka/pull/2432)) ##### Other - Add Kotlin stability & support badges, thanks to [@​etolstoy](https://github.com/etolstoy) ([https://github.com/Kotlin/dokka/pull/2511](https://github.com/Kotlin/dokka/pull/2511)) - Remove an unused runner parameter, thanks to [@​3flex](https://github.com/3flex) ([https://github.com/Kotlin/dokka/pull/2498](https://github.com/Kotlin/dokka/pull/2498)) - Correct typos, thanks to [@​PaladiRka](https://github.com/PaladiRka) ([https://github.com/Kotlin/dokka/pull/2504](https://github.com/Kotlin/dokka/pull/2504)) and [@​mahozad](https://github.com/mahozad) ([https://github.com/Kotlin/dokka/pull/2506](https://github.com/Kotlin/dokka/pull/2506))! Thanks to all the contributors! ### [`v1.6.21`](https://github.com/Kotlin/dokka/releases/tag/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](https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2021-37714) ([#​2448](https://github.com/Kotlin/dokka/issues/2448)) ##### Bugfixes - Support `KLIB` libraries for common platform, previously led to `ERROR CLASS` instead of references in documentation ([#​2441](https://github.com/Kotlin/dokka/issues/2441)) - Fixed a maven plugin build problem related to coroutines which only occurred in multi-module builds ([#​2461](https://github.com/Kotlin/dokka/issues/2461)) ### [`v1.6.20`](https://github.com/Kotlin/dokka/releases/tag/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](https://github.com/Kotlin/dokka/pull/2270)) - Make HTML pages customizable through FreeMarker HTML templates ([https://github.com/Kotlin/dokka/pull/2374](https://github.com/Kotlin/dokka/pull/2374)) - Add global settings to JSON dokka CLI input ([https://github.com/Kotlin/dokka/pull/2292](https://github.com/Kotlin/dokka/pull/2292)), thanks to [@​BarkingBad](https://github.com/BarkingBad)! #### HTML format changes - Add vertical alignment (wrapping) of signatures when 3 and more parameters are present ([https://github.com/Kotlin/dokka/pull/2309](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](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](https://github.com/Kotlin/dokka/pull/2291)) - Add horizontal margin to breadcrumbs delimiter ([https://github.com/Kotlin/dokka/pull/2285](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/2284), [https://github.com/Kotlin/dokka/pull/2389](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](https://github.com/Kotlin/dokka/pull/2216)) - Fixed classpath issues for HMPP libraries ([https://github.com/Kotlin/dokka/pull/2431](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](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](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](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](https://github.com/Kotlin/dokka/pull/2325)) - Suppressed property setters are now excluded from documentation ([https://github.com/Kotlin/dokka/pull/2220](https://github.com/Kotlin/dokka/pull/2220)) - Suppressing extensions doesn't fail builds anymore ([https://github.com/Kotlin/dokka/pull/2348](https://github.com/Kotlin/dokka/pull/2348)), thanks to [@​BarkingBad](https://github.com/BarkingBad)! - Fixed java getter / setter name generation for kotlin-java interop, now `isBoolean` instead of `getBoolean` ([https://github.com/Kotlin/dokka/pull/2356](https://github.com/Kotlin/dokka/pull/2356)), thanks to [@​CharlesG-Branch](https://github.com/CharlesG-Branch)! - Fixed MathJax plugin, previously completely broken ([https://github.com/Kotlin/dokka/pull/2342](https://github.com/Kotlin/dokka/pull/2342)), thanks to [@​wyskoj](https://github.com/wyskoj)! - Fixed Input/Output streams to minimize resource leaks ([https://github.com/Kotlin/dokka/pull/2312](https://github.com/Kotlin/dokka/pull/2312), [https://github.com/Kotlin/dokka/pull/2319](https://github.com/Kotlin/dokka/pull/2319)) #### Plugin API Changes - Add an extension point for rendering custom [documentation tags](https://kotlinlang.org/docs/kotlin-doc.html#block-tags) ([https://github.com/Kotlin/dokka/pull/2343](https://github.com/Kotlin/dokka/pull/2343)) - Add an extension point for an external documentable provider ([https://github.com/Kotlin/dokka/pull/2307](https://github.com/Kotlin/dokka/pull/2307)), thanks to [@​Kordyjan](https://github.com/Kordyjan)! - Add filtering stategies extension point and fix constructors in Kotlin-as-Java ([https://github.com/Kotlin/dokka/pull/2277](https://github.com/Kotlin/dokka/pull/2277)), thanks to [@​BarkingBad](https://github.com/BarkingBad)! - Expose Kotlin-as-Java methods that could be used not only as part of transformers ([https://github.com/Kotlin/dokka/pull/2351](https://github.com/Kotlin/dokka/pull/2351)), thanks to [@​BarkingBad](https://github.com/BarkingBad)! - Refactor Ancestry Graphs ([https://github.com/Kotlin/dokka/pull/2326](https://github.com/Kotlin/dokka/pull/2326)), thanks to [@​BarkingBad](https://github.com/BarkingBad)! - Fixed resolving of DRIs for Enum Entries ([https://github.com/Kotlin/dokka/pull/2305](https://github.com/Kotlin/dokka/pull/2305)), thanks to [@​BarkingBad](https://github.com/BarkingBad)! #### General Improvements - Collect annotations from `package-info.java` ([https://github.com/Kotlin/dokka/pull/2331](https://github.com/Kotlin/dokka/pull/2331)), thanks to [@​ember-rose](https://github.com/ember-rose)! - Add support for header tags (`<h1>` / `<h2>` / `<h3>`) in Javadoc ([https://github.com/Kotlin/dokka/pull/2345](https://github.com/Kotlin/dokka/pull/2345)), thanks to [@​asfalcone](https://github.com/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](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](https://github.com/Kotlin/dokka/pull/2303)), thanks to [@​chkpnt](https://github.com/chkpnt)! - Fixed wrong Groovy DSL example ([https://github.com/Kotlin/dokka/pull/2302](https://github.com/Kotlin/dokka/pull/2302)), thanks to [@​chkpnt](https://github.com/chkpnt)! - Various code cleanups ([https://github.com/Kotlin/dokka/pull/2165](https://github.com/Kotlin/dokka/pull/2165), [https://github.com/Kotlin/dokka/pull/2360](https://github.com/Kotlin/dokka/pull/2360), [https://github.com/Kotlin/dokka/pull/2364](https://github.com/Kotlin/dokka/pull/2364), [https://github.com/Kotlin/dokka/pull/2385](https://github.com/Kotlin/dokka/pull/2385)), thanks to [@​Goooler](https://github.com/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`](https://github.com/Kotlin/dokka/releases/tag/v1.6.10) #### Changes - Support Kotlin 1.6.10 - Add a sample project for versioning multi-module ([https://github.com/Kotlin/dokka/pull/2170](https://github.com/Kotlin/dokka/pull/2170)) #### Bugfixes - Fix various `java.util.zip.ZipException` for JS dependencies ([https://github.com/Kotlin/dokka/pull/2258](https://github.com/Kotlin/dokka/pull/2258)) - Fix handling of Description Lists (`<dl>`) used in JavaDocs ([https://github.com/Kotlin/dokka/pull/2259](https://github.com/Kotlin/dokka/pull/2259)) - Fix for "repositories not defined" issue in versioning multimodule example ([https://github.com/Kotlin/dokka/pull/2263](https://github.com/Kotlin/dokka/pull/2263)), thanks [@​rajdeep1008](https://github.com/rajdeep1008)! - Fix multiple rendering issues for "See Also" block for html format ([https://github.com/Kotlin/dokka/pull/2267](https://github.com/Kotlin/dokka/pull/2267)) - Fix sample body not being embedded to documentation ([https://github.com/Kotlin/dokka/pull/2216](https://github.com/Kotlin/dokka/pull/2216)) #### Maintenance - Update npm dependencies ([https://github.com/Kotlin/dokka/pull/2251](https://github.com/Kotlin/dokka/pull/2251)) - Bump `de.undercouch.download` to 4.1.2 ([https://github.com/Kotlin/dokka/pull/2268](https://github.com/Kotlin/dokka/pull/2268)) - Bump `kotlinx.coroutines` to 1.6.0 in integration tests ([https://github.com/Kotlin/dokka/pull/2276](https://github.com/Kotlin/dokka/pull/2276)) ### [`v1.6.0`](https://github.com/Kotlin/dokka/releases/tag/v1.6.0) Changes: - **New UI** - Support of version plugin for single module projects - Allow package-level suppression ([#​2209](https://github.com/Kotlin/dokka/issues/2209)), thanks [@​owengray-google](https://github.com/owengray-google) - GFM: Use Markdown syntax to render lists ([#​2098](https://github.com/Kotlin/dokka/issues/2098)), thanks [@​sgilson](https://github.com/sgilson) - Fix names of nested inheritors - Fix adding new custom stylesheets in submodules - Add keywords `expect` and `actual` in signatures </details> --- ### 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](https://www.mend.io/free-developer-tools/renovate/). View repository job log [here](https://app.renovatebot.com/dashboard#github/RBusarow/Dispatch). PR-URL: #488
https://youtrack.jetbrains.com/issue/KT-52069