<!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>