Releases: Kotlin/dokka
1.4.10 Alpha - Mobile friendly html format
Main features:
- The New HTML format is much more mobile-friendly - #1279
- Kotlin 1.4.10
Improvements:
Javadoc:
- added subclasses page
- added deprecated page
Other:
- added favicon in HTML format
- simplified where documentation for modules is being searched for - #1265
Bugs fixed:
- Asterisks in KDoc cause the chunk of text to be ripped off - #1368
- Missing variance in classlike signatures - #1384
- NullPointerException on images - #1424
- Javadoc version number is always 0.0.1 - #1406
- Codeblocks from package markdown are not displayed in HTML - #1371
- Change substituting typealiases with actual types - #1447
- NotImplementedError after migrating from 0.10.1 to 1.4.0-rc-24 - #1255
- Kotlin as Java should translate type aliases - #1115
- Show fully qualified name for typealias target coming from different package - #950
1.4.0 Alpha - Gradle plugin overhaul
Main features:
- Gradle plugin overhaul
- Autoconfiguration for sourceset for Multiplatform projects
- Kotlin 1.4.0
Improvements:
Html format:
- added left navigation search component
- improved intuitiveness of displayed cursor types (thanks to @hamza1311)
- improved presentation of some generic parameters
- made unresolved links render as text
- improved overall UI experience
Javadoc:
- implemented generating both
package-list
andelement-list
- added index page
Reporting
- maturity warning
- handling of missing sourceset for Javadoc
- handling nothing to document
- descriptions to all Dokka tasks
Other:
- improved parsing of generic typealiases
- removed redundant type bounds from all formats
Bugs fixed:
- missing whitespace in class-like signatures - #1419
- classpath issues in very specific conditions - #1415
- missing resources on windows - #1399
- top-level functions crashing Javadoc generation - #1393 #1385
- unstable order of functions in generated documentation - #1333
- anchors on android being broken in some cases - #1230
- improperly formatted code blocks - #1346
- source tabs not displayed on Windows in html format - #1361
- stack overflow on documenting complex type constraints - #1342
- symbols defined in companion objects not being linked correctly in rare cases - #1268
- unresolved links in some cases - #1345
- missing sourcesets on non-lazily configured Android projects - #1330
Couldn't get delegate for class
error - #1341- to many sources set bubbles after running Dokka collector - #1294
- empty packages listed in the sidebar - #1257
- suppressed files still documented - #1245
1.4.0-rc
The first preview release of Dokka after a complete rewrite.
Most important features:
- Support for Kotlin 1.4.0-rc
- Safe and extensible plugin system
- New HTML format:
- Search bar
- Navigation tree
- Runnable samples
- Platform filtering
- Linking to sources
- GFM format
- Jekyll format
- Kotlin-as-java view for all formats
- Rendering Javadoc (for all versions of JDK)
- Documentation of multimodule projects with a common index
For details see the blog post.
0.10.1
Changes:
- Update bundled compiler version to 1.3.61 #531
- Support Flavor-specific documentation #345
- Links to stdlib on kotlinlang don't work for dokka-maven-plugin #551
- Dokka 0.10.0 ignore unsuppresed packages in suppressed packages #521
- packageListUrl must be specified even if in default location #514
- Some API methods are private starting from 0.10.0 #534
- Dokka 0.10.0 creates links to packages with no public declarations #510
- Better error message than "List is empty" when no platform is specified in multiplatform project #511
- Implement display of Java default constructors #542
- Ignore samples. Sample import when generating runnable samples #530
0.10.0
Check out migration notes: here
Thanks to our external contributors:
Changes:
- Experimental Multiplatform Support (#322, #491, #212, #307, #391)
- Merged Android and non-Android Gradle plugin #458
- Fixed Gradle plugin does not play well with gradle-kotlin-dsl #196
- Added Include Non Public as global maven configuration option #435
- Fixed Code blocks in included markdown aren't parsed correctly #433
- Fixed NPE in Javadoc generation #450
- Fixed Markdown underscore emphasis in outFormat html #182
- Fixed Self-closing
<p/>
tag causing removal of link #369 - Added documentation for the Gradle Kotlin DSL #359
- Fixed problems with
dokkaFatJar
resolution (#332, #296, #462) - Fixed using sourceRoot results in empty index.html #496
- Fixed incorrect parsing of
https
urls in KDoc links #405 - Fixed
+includeNonPublic
in CLI #481 - Fixed Dokka fails with Javadoc format and nested Java annotations #490
- Fixed CCE in html-as-java mode #455
- Fixed CCE in Javadoc output mode #477
- Fixed rendering for parameter type in Javadoc #465
- Fixed Javadoc fails when documenting annotations #464
0.9.18
Check out migration notes: here
Experimental Kotlin Multiplatform support is scheduled for 0.9.19
Thanks to our external contributors:
- Robert Stoll
- Dominik Schürmann
- Tiem Song
- Tim McCormack
- Ivan Canet
- Paul Merlin
- Douglas Sigelbaum
- Sean McQuillan
Changes:
-
fixed fat JAR resolution in Gradle plugin #316
-
fixed constructor tag #300
-
fixed preserve newlines in javadoc code blocks #409
-
fixed visibility modifier for protected property getters and setters #342
-
fixed missing parameters on Javadoc output on Java classes #343
-
removed duplicate copies of parameters in generated docs for primary constructors #341
-
fixed nullable left off function type parameter with default value #328
-
fixed failing of Dokka plugin on Gradle 5.0 #388
-
added instructions for configuring Dokka in IDEA #386
-
fixed annotatedProperty test #426
-
added an ability to disable link to Java documentation #188
-
added type safe counterparts to Closure taking methods on Gradle DokkaTask #358
-
fixed "Can't find node by signature not implemented for value-parameter." #278
-
use canonicalPath instead of absolutePath for srcLink #289
-
created FAQ
-
fixed nullability annotations in Javadoc #446
-
updated bundled kotlin-compiler to 1.3.20-dev-564 f640397
-
refactored maven-plugin build b3b3058
-
fixed constant values for java b0310f8
-
formated javadoc: vararg arguments are represented as single arg #361
-
added type safe counterparts to Closure taking methods on Gradle DokkaTask #358
-
excluded
internal
visibility modifier from summary, fixed exclusion logic
a18952b -
fixed parameter rendering in asJava mode 0485472
-
introduced option to enable/disable jdk linking
bf03146
069caa2
2386192 -
added more detailed signature on class page f5746c4
-
added support for constants in as java mode 633fda3
-
fixed local links resolved in incorrect context 4301503
-
fixed inbound links to enum entries e38d839
-
fixed relative uri's generation 6361dd3
-
fixed resolution of inbound links to constructors in Javadoc [commit] (3c6be4a)
-
added support for external link resolution in JavadocParser b00dabc
-
added type info to param and return section in javadoc a50de81
-
added support for implicit sections inheritance 74b2281
-
fixed resolution of package links ee0b640
-
added support for
{@inheritDoc}
including grand inheritance and skip levels a16ae6c -
fixed resolution of links in Javadoc 6cfaf04
-
fixed structure of content paragraphs in Javadoc parser 57a6bb5
-
fixed generation of superclass sequence 9539284
-
added logic for inherited constants 5487473
-
fixed checking belonging to public API 27deff9
-
stabilized signatures to fix linking from Java to Kotlin a3f16fd
-
made possible to group extensions by receiver 3e8448b
-
added support for constants from Java in Kotlin-as-Kotlin mode 85d2ea3
-
added support for propagating inherited extensions from libraries 1391dcc
-
added support for deep inheritance with external classes c776aaa
-
made possible to generate signatures on output format side 63ab561
0.9.17
- Fix suppression of generated files for new Android Gradle Plugin #308
- Fix the wrong URL for external elements in packages with upper case in Dokka format #285
- Fix link resolution context for inherited Kdoc #229
- Fix Dokka Maven Plugin to work on JDK9 #272
- Fix CCE in getting
sourcePsi
while Javadoc generation #287, thanks to @Nexcius - Fix not found node for external enum items #274
- Fix early resolution of classpath #282
- Remove unnecessary report logging in
Javadoc
generator #291, thanks to @lukasniemeier-zalando
Internals
LocationService
removed, and all logic of path calculations was moved to NodeLocationAwareGenerator
which implemented by FileGenerator
FormatDescriptor
now can bind its own services, as it has access to output & analysis module Binder
By default, there is a hierarchy of some abstract base format descriptors, which provides an interface of required services
0.9.16
- Bundled kotlin compiler updated to
1.2.40-dev-529
- #251 Fixed suboptimal (non-incremental) input properties for Gradle tasks
- #252 Fixed crash when class folders are on the classpath
- #265 Fixed Gradle plugin compatibility with Kotlin 1.2
- #243 Renamed
reportNotDocumented
toreportUndocumented
in the Gradle plugin - #128 Added task option to suppress an entire package
- #220 Fixed Dokka running under JDK9
- #174 Fixed wrong link in the last breadcrumbs item
- #205 Fixed links to Companion static methods with parameters do not work in
javadoc
format - #224 Filtered out Android generated classes from docs
- #186 Fixed Gradle plugin task does not execute after source updates
- #228 Fixed Multi-line indented code block rendering to HTML
- #226 Fixed Gradle plugin
includeNonPublic
not working as documented - #218 Made
classpath
configuration optionIterable<File>
- #219 Unbundled kotlin-stdlib & kotlin-reflect from Gradle plugin
- #225 Fixed exception when using
packageOptions
in Gradle plugin
Get artifacts at https://bintray.com/kotlin/dokka/dokka/0.9.16
0.9.16 EAP 3
Fixed incompatibility with Gradle 4.5+ (#265)
Dokka now not compatible with Gradle >= 3.2, < 3.5
Artifacts
0.9.16 EAP 2
Artifacts available at https://bintray.com/kotlin/kotlin-eap/dokka