Hey I wonder about arity of the kotlin docs block types? https://kotlinlang.org/docs/kotlin-doc.html#see-identifier This is what I have deducted. Is this correct? can you help me fill the gaps? @param name - many @return - one @constructor - one @receiver - many @property name - many @throws class - many @exception class - ? @sample identifier - many @see identifier - many @author - one @since - one @suppress - one What is a difference between @throws class and @exception class?

@throws

and

@exception

is the same thing as far as I know

Maybe it's many because of the context receivers ?

They're not a thing yet, and I doubt the prototype is fleshed out enough to bother with stuff like this

I’d be curious to know if context receivers would make the

@receiver

arity “many”, or if a new

@context

tag would be added. My gut tells me that the latter would make more sense and be closer to the intended understanding of context receivers, that they are a bit more nuanced that just “multiple receivers”. Also, it’s worth remembering that context receivers has been deferred until after the K2 migration is complete. I believe the roadmap for it will be: 1.9 (final release without stable K2), 2.0 (first release with stable K2), 2.1 (with full context receiver support). So we’ve got a while until this feature becomes stable.

To my knowledge, they never stated explicitly that 2.1 will have full context receiver support. They said “after 2.0”. I wonder if 2.1 will be statics and collection literals, and 2.2 will be context receivers.

Upd: @param name - many @return - one @constructor - one @receiver - one @property name - many @throws class == @exception class - many @sample identifier - many @see identifier - many @author - one? @since - one @suppress - one

I've never really seen

author

be used, honestly. Everyone uses Git, which is just better at storing that info.