RFR: 8365635: Add MOUSE_DRAG_DONE event type
Michael Strauß
mstrauss at openjdk.org
Mon Aug 18 20:21:47 UTC 2025
On Mon, 18 Aug 2025 19:31:16 GMT, Nir Lisker <nlisker at openjdk.org> wrote:
>> modules/javafx.graphics/src/main/java/javafx/scene/Node.java line 7718:
>>
>>> 7716: }
>>> 7717:
>>> 7718: /// Defines a function to be called when a full press-drag-release gesture ends with this node as its source.
>>
>> This is the first instance of markdown-style javadoc comments in JavaFX. Do we need a discussion surrounding their use?
>
> They were added in JDK 23, which we can use. I don't know if there's anything special to discuss. The JEP gives standard usage examples, which I've followed, so there's no "feature abuse" here either.
Well, they look very different from the other style. Usually matters of style are settled once in a style guide, which we don't have. But I think we should at least consciously agree that we're fine with having two different styles of documentation in the same project. Personally, I value uniformity of style more than the (little) added value that markdown comments bring.
-------------
PR Review Comment: https://git.openjdk.org/jfx/pull/1873#discussion_r2283373284
More information about the openjfx-dev
mailing list