On Fri, 5 Sep 2025 18:52:58 GMT, Chen Liang <[email protected]> wrote:

>> In the code this is based on (ExtendedRobot.java) it was called 
>> DEFAULT_SPEED and used by click and type as well as glide
>> As 'named' now, DEFAULT_STEP_DELAY is only appropriate for glide(..). 
>> There's no "stepping" here.
>> 
>> And yet click(..) uses it (internally) 
>> 
>> so long as we don't document the name DEFAULT_STEP_DELAY on click() or 
>> type() it isn't critical.
>> I see a number of choices 
>> - Use literal 20 here and in click
>> - Use DEFAULT_STEP_DELAY here and in click - do not document
>> - Add a new (private) DEFAULT_DELAY - and use it in both cases
>> - Add a new public DEFAULT_DELAY - and use it in both cases and document it
>> - Rename DEFAULT_STEP_DELAY to DEFAULT_DELAY - and use it in click and type 
>> as well as glide
>> 
>> I'm inclined to go with the last of these - CSR will need to be revised.
>> But if we don't do that one now, it will be awkward to do later.
>> Thoughts ?
>> 
>> PS I can see the potential need for an overload of click() and type() which 
>> accepts an alternate delay but I don't propose it here, I just note that for 
>> click() it would not be possible for the default click() to just accept a 
>> delay since that would clash with click(int buttons).
>
> I recommend revising the CSR. Since the CSR already has reviewers, once it is 
> updated, it can be directly finalized for re-approval. Just describe the 
> changes in a comment, and it should proceed smoothly.

I have chosen to go with Phil's last point as he suggested. I renamed all 
instances of `DEFAULT_STEP_DELAY` to `DEFAULT_DELAY`. I also updated the docs 
where needed.

I generated the docs to view how it looks with all the suggestions implemented, 
and I believe it looks presentable now but let me know if anyone finds any 
issues.

I will revise the CSR with the new updates. Thanks!

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

PR Review Comment: https://git.openjdk.org/jdk/pull/26969#discussion_r2331580759

Reply via email to