<!DOCTYPE html><html><head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
</head>
<body>
<div class="moz-cite-prefix">On 07/12/2025 18:23, Daisuke Yamazaki
wrote:<br>
</div>
<blockquote type="cite" cite="mid:19afa0e5181.26cbbd8791536.7686578147937895807@peya.tokyo">
<pre wrap="" class="moz-quote-pre">Hello all,
I noticed that in most jtreg tests, the standard block comment `/* ... */` is
used for the test directives.
This is also what official jtreg documentation shows.
However, in some older tests[1], for example QUIC-related tests[2],
I see`/** ... */` being used instead of `/* ... */`.
Is there any specific reason for using JavaDoc-style comments (`/** ... */`) in
these tests?
Are there cases where `/**` beginning is preferred over the regular block
comment for jtreg directives?
</pre>
</blockquote>
jtreg (via the JT harness) looks for @test as the first token in /*
.. */ comments and doc comments /** .. */. The examples in the tag
spec [1] use traditional comments but the test suites in openjdk/jdk
have a mix. I don't recall any discussion about making this a style
issue and trying to be consistent.<br>
<br>
-Alan<br>
<br>
[1] <a class="moz-txt-link-freetext" href="https://openjdk.org/jtreg/tag-spec.html">https://openjdk.org/jtreg/tag-spec.html</a><br>
</body>
</html>