I want to add a comment like this
/**
* @param scrollFraction In range [0..1].
*/
But Dokka/Kdoc interprets stuff inside square brackets as a reference. This leads to badly rendered comments when you check the function's documentation in the IDE or generate the docs. How can I escape square brackets/other symbols in Dokka/Kdoc?
You can use HTML escaping:
/**
* @param scrollFraction In range [0..1].
*/
should output in Dokka as range [0..1]., since [ escapes as [ and ] escapes as ].
Note this will not work inside a section of inline code (between grave accents - like this).
For such cases use square brackets ([ and ]) normally, as was suggested in Demigod's answer.
You should be able to do it using ` symbol, like this:
/**
* @param scrollFraction In range `[0..1]`.
*/