Intereting Posts
Как разобрать JSON вручную в Котлине? Запустите операцию наложения, не показывая остальную часть приложения. Есть ли допустимое правило proguard для RxJava и FasterXML? Kotlin VS Scala: реализовать методы с параметрами первичного конструктора Переназначение переменных посредством деструктурирования RecyclerView с Kotlin не выставляет ячейки по вертикали Ошибка при переходе с Java на Kotlin. Ошибка – org.gradle.api.tasks.TaskExecutionException: выполнение не выполнено для задачи: app: compileDebugKotlin ' Создание регистратора на уровне пакета без класса Абстрактный метод Котлина с телом данных и открытой несовместимости, какая у меня альтернатива? Параллельная загрузка файлов S3 через Kotlin Corouts Подключение к топливу Шаблон Nullable var внутри строки Объединение всех стандартных и пользовательских десериализаторов Джексона в универсальный десериализатор свойств Как сделать COUNT (*) с GROUP BY в Котлине?

Как использовать @link и @code в kotlin kDoc

Я пытаюсь документировать метод и пытаюсь использовать @link и @code как в JavaDoc .

Я знаю, что в kotlin есть kDoc, но я не могу найти их или, по крайней мере, что-то подобное.

@link и @code не существуют в kDoc, но могут быть легко заменены Inline Markup .

от KotlinDoc Linking to Elements

Встроенная разметка

Для встроенной разметки KDoc использует стандартный синтаксис Markdown , расширенный для поддержки сокращенного синтаксиса для привязки к другим элементам кода.

Связывание с элементами

Чтобы связать себя с другим элементом (классом, методом, свойством или параметром), просто поместите его имя в квадратные скобки:

Для этого используйте метод [foo] .

Если вы хотите указать пользовательский ярлык для ссылки, используйте синтаксис стиля ссылки Markdown:

Для этого используйте [this method][foo] . Вы также можете использовать квалифицированные имена в ссылках. Обратите внимание, что в отличие от JavaDoc, квалифицированные имена всегда используют символ точки для разделения компонентов, даже до имени метода:

Используйте [kotlin.reflect.KClass.properties] чтобы перечислять свойства класса. Имена в ссылках разрешаются с использованием тех же правил, что и имя внутри документа, документированного. В частности, это означает, что если вы импортировали имя в текущий файл, вам не нужно полностью его квалифицировать, когда вы используете его в комментарии KDoc.

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