Skip to content

Releases: Kotlin/dokka

1.4.10 Alpha - Mobile friendly html format

22 Sep 10:14
Compare
Choose a tag to compare

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

03 Sep 14:27
Compare
Choose a tag to compare

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 and element-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

04 Aug 09:54
Compare
Choose a tag to compare

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

04 Feb 13:01
Compare
Choose a tag to compare

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

07 Oct 16:06
Compare
Choose a tag to compare

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

19 Mar 21:15
Compare
Choose a tag to compare

Check out migration notes: here

Experimental Kotlin Multiplatform support is scheduled for 0.9.19

Thanks to our external contributors:

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

  • updated readme.md #399, #441, #443

  • 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 inbound links in java layout html 71ef970
    87705bf

  • 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

21 May 13:29
Compare
Choose a tag to compare
  • 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

22 Feb 11:59
Compare
Choose a tag to compare
  • 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 to reportUndocumented 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 option Iterable<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

01 Feb 16:23
Compare
Choose a tag to compare
0.9.16 EAP 3 Pre-release
Pre-release

Fixed incompatibility with Gradle 4.5+ (#265)

Dokka now not compatible with Gradle >= 3.2, < 3.5

Artifacts

https://bintray.com/kotlin/kotlin-eap/dokka/0.9.16-eap-3

0.9.16 EAP 2

11 Jan 15:05
Compare
Choose a tag to compare
0.9.16 EAP 2 Pre-release
Pre-release