Hi all, I'm using dokka to generate the javadoc fo...

# dokka

[alfdev]

Hi all, I'm using dokka to generate the javadoc for a kotlin library but the @throws are not rendered in the html, any idea? Thanks

[Ignat Beresnev]

Hi! Which version of Dokka are you using? I think this bug was fixed fairly recently

[alfdev]

Hi, 1.9.10

[Ignat Beresnev]

Hm, could you give a reproducer example or a screenshot of what you're seeing in code and in html? Might be a bug

[alfdev]

You mean the gradle configuration?

[alfdev]

Because in the output html I don't see the Throws section, simply 🙂

[alfdev]

/*....
* @throws [IllegalArgumentException] if the parameters passed are not valid.
*/
@Throws(IllegalArgumentException::class)
fun build(): ChallengeResponse {

[Ignat Beresnev]

Preferably just the piece of Kotlin source code in which you have the throws tag on a declaration, and a screenshot of that same declaration in the HTML output

[alfdev]

ok

[Ignat Beresnev]

(I understand it may sound like a weird request, but we have unit tests that cover basic and obvious scenarios for sure, so either this bug is a corner case or it's not used correctly / the expectations are off)

[alfdev]

don't worry 🙂

[alfdev]

image.png

[alfdev]

Instead, if I use the html as output format it works

[Ignat Beresnev]

Oh, it's the Javadoc format, I thought we were talking about Dokka's own HTML format (which can also be put in javadoc.jar), sorry.

Yeah, the throws tag is simply not supported in the Javadoc format, but there's no issue for it :(

However, it shouldn't be difficult to fix though. Do you want to submit an issue to Dokka's repo or even take a shot at fixing it?

[alfdev]

Oh so it's not supported. In the meanwhile I switched to the dokka's own html format so I can use it.

[alfdev]

Thank you so much Ignat

[Ignat Beresnev]

Thank you for the report! :)