On Tue, 28 May 2024 20:01:46 GMT, Alan Bateman <al...@openjdk.org> wrote:

> > OK. I was just trying to honor the apparent intent to make the comment 
> > stand out more than just a plain `//` comment, but I have no strong 
> > feelings against reducing `///` to `//`
> 
> In this case I would reduce it to '//' but others will have different 
> opinions of course.

What about changing `///` to `//---` to give slightly more prominence to these 
comments, over plain old `//` comments.
The dashes give a small sense of a horizontal rule, to delimit sections of code.

(FWIW, I have locally edited `//|` to `//` and such comments do not stand out 
beside existing use of `//`.)

-------------

PR Comment: https://git.openjdk.org/jdk/pull/19130#issuecomment-2136042843

Reply via email to