On Thu, 14 May 2026 12:40:19 GMT, Alexey Ivanov <[email protected]> wrote:

> Change the description of `mouseDragged` and `mouseMoved` in the 
> [`MouseMotionAdapter` 
> class](https://docs.oracle.com/en/java/javase/26/docs/api/java.desktop/java/awt/event/MouseMotionAdapter.html)
>  to `{@inheritDoc}`. The custom description didn't provide additional 
> information about the methods and repeated the description from the 
> [`MouseMotionListener` 
> interface](https://docs.oracle.com/en/java/javase/26/docs/api/java.desktop/java/awt/event/MouseMotionListener.html).
> 
> ---------
> - [x] I confirm that I make this contribution in accordance with the [OpenJDK 
> Interim AI Policy](https://openjdk.org/legal/ai).

The descriptions in the [MouseMotionListener 
interface](https://docs.oracle.com/en/java/javase/26/docs/api/java.desktop/java/awt/event/MouseMotionListener.html)
 could also be improved:

* **`mouseDragged`**: Invoked when a mouse button is pressed on a component and 
then <ins>the mouse is</ins> dragged.
  (This clarifies that *the mouse* is dragged while a mouse button remains 
pressed; otherwise, it reads as if the mouse button is dragged.)
* **`mouseMoved`**: Invoked when the mouse cursor has been moved onto a 
component\
   but no buttons have been <del>pushed</del> <ins>pressed</ins>.
  (It's unusual to use *“pushed”* for mouse buttons (as opposed to buttons in 
the UI), *“pressed”* is more common.)

Does anyone have any comments?

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

PR Comment: https://git.openjdk.org/jdk/pull/31161#issuecomment-4450838095

Reply via email to