does

@Throws

serve a purpose other than java interop?

not as far as I'm aware

Seems like a nice way to be very clear about what might happen from a documentation standpoint. Probably not just a JVM thing or it would have a jvm prefix no?

@trevjones What does it do in terms of documentation? kdoc supports @throws (not the annotation but as a block tag in the doc) although when you think about the fact that there are no checked exceptions I don't know how much sense it makes. https://kotlinlang.org/docs/reference/kotlin-doc.html

from the standpoint that selfdocumenting code is better than manually maintained docs

I don't see how

@Throws(...)

is any more maintainable than

@throws(...)

and at least the latter will be added into dokka