Документация Kotlin: ссылка на методы с разными сигнатурами?

В Java у нас есть что-то вроде этого:

/**
 * Link1: {@linkplain java.io.Writer#write(int)}
 * Link2: {@linkplain java.io.Writer#write(char[],int,int)}
 */

Нажав на ссылку, перейдите к различным методам.

Я мог бы несколько достичь первой ссылки с этим:

[Link1 label][java.io.Writer#write(int)]

Я также попытался с другим примером (чтобы проверить, не является ли это случайностью)

[Another Link label][java.io.Writer#write(java.lang.String,int,int)]

Я пробовал это на Android Studio. Ссылки Koltin нельзя щелкнуть напрямую, но если просмотреть документацию в представлении Rendered (с помощью Ctrl+Alt+Q), ссылки отображаются.

Мне трудно со вторым примером Java. Это не работает:

[Link1 label][java.io.Writer#write(char[],int,int)]

Если кто-то решил это, пожалуйста, дайте мне знать. Спасибо.


person SayantanRC    schedule 24.04.2021    source источник


Ответы (1)


Согласно документации Kotlin, это невозможно.

Обратите внимание, что KDoc не имеет синтаксиса для разрешения перегруженных элементов в ссылках. Поскольку инструмент генерации документации Kotlin помещает документацию для всех перегрузок функции на одну страницу, для работы ссылки не требуется указывать конкретную перегруженную функцию.

person geobreze    schedule 24.04.2021
comment
Крайне неубедительно, если честно. - person SayantanRC; 24.04.2021