Java 25 Javadoc не поддерживает синтаксис ссылок URL-адреса Markdown в `@see` ⇐ JAVA

[Anonymous]

Используя Java 25 с новым JEP 467: комментарии к документации Markdown, я попытался добавить следующее:

Код: Выделить всё

/// @see [Example Site](https://example.com/)

Javadoc (вызванный Maven) пожаловался на «ошибку: неожиданное содержимое» с ^ в конце ).
Спецификация JEP 467 гласит:

Вы можете использовать все другие формы ссылок Markdown, включая ссылки на URL-адреса….

…

Встроенные и блочные теги анализируются так же, как и традиционные комментарии к документации, за исключением того, что содержимое тега также анализируется как Markdown.

Таким образом, я не вижу ничего, что указывало бы на то, что URL-ссылки Markdown нельзя использовать в блоке @see.
Моя цель состоит в том, чтобы не найдите другой способ ссылки на классы или методы. Я действительно хочу дать ссылку на URL. Многие вещи, которые мы пишем, вдохновлены, под влиянием или руководствуются статьями в блогах или даже Stack Overflow. Итак, чтобы сделать вещи мета, если бы я писал Java-реализацию синтаксического анализа Javadoc, я мог бы просто сослаться на этот самый вопрос о переполнении стека!

Код: Выделить всё

/// Parses Javadoc Markdown comments and returns a Markdown node tree.
/// @implNote Supports Markdown for the `@see` tag.
/// @see [Java 25 Javadoc not allowing Markdown URL link syntax in `@see`](https://stackoverflow.com/q/79794040)

Может ли кто-нибудь подтвердить, что это ошибка Javadoc, и сообщить мне, где я могу сообщить об ошибке в этом инструменте? (У меня нет учетной записи OpenJDK, поэтому я не могу подать ее на https://bugs.openjdk.org/.)


Подробнее здесь: https://stackoverflow.com/questions/797 ... tax-in-see