<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
</head>
<body>
<p>Hello,</p>
<p>I'd like to point out that making simple links could use the same
approach as Rust where a simple link uses backticks, like <font
face="monospace">[`fmt::Display`]</font>, which produces a link
with fixed-width font. One would expect backticks to set
fixed-width font, right? So this looks consistent to me. Moreover,
the backticks pairing takes precedence, so the text within the
backticks needs no escaping of square brackets, which the JEP
discusses as necessary in some cases.</p>
<p>Hence I think that the backticks-in-a-simple-link convention
should be endorsed by the JEP as <i>the</i> way to make simple
links.<br>
</p>
<p>P.</p>
<p><br>
</p>
<div class="moz-cite-prefix">On 27.02.2024 21:31, Mark Reinhold
wrote:<br>
</div>
<blockquote type="cite"
cite="mid:20240227203115.5017F6C2D5B@eggemoggin.niobe.net">
<pre class="moz-quote-pre" wrap=""><a class="moz-txt-link-freetext" href="https://openjdk.org/jeps/467">https://openjdk.org/jeps/467</a>
Summary: Enable JavaDoc documentation comments to be written in
Markdown rather than solely in a mixture of HTML and JavaDoc @-tags.
- Mark</pre>
</blockquote>
</body>
</html>