jtreg test comments: /* vs /** usage
Daisuke Yamazaki
d.yamazaki at peya.tokyo
Sun Dec 7 18:23:53 UTC 2025
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?
If there is a need to standardise this style, I can file a bug to track it.
Thanks for any clarification.
Best regards,
D. Yamazaki
[1]: https://github.com/openjdk/jdk/blob/master/test/jdk/java/net/httpclient/Http1ChunkedTest.java#L40-L46
[2]: https://github.com/openjdk/jdk/blob/master/test/jdk/java/net/httpclient/quic/AckElicitingTest.java#L86-L93
More information about the net-dev
mailing list