RFR: 8336873: BasicSplitPaneDivider:oneTouchExpandableChanged() should mention that implementation depends on SplitPane.supportsOneTouchButtons property [v2]

[Victor Dyakov]

On Sun, 28 Jul 2024 23:14:03 GMT, Phil Race <prr at openjdk.org> wrote:

>> Prasanta Sadhukhan has updated the pull request incrementally with three additional commits since the last revision:
>> 
>>  - typo
>>  - copyright year
>>  - L&F typo
>
> The only LAF I see that sets supportsOneTouchButtons is GTK and it sets it to false ..
> so nothing anywhere sets it to true !
> And in the code being updated "true" is passed as the default value to DefaultLookup.getBoolean 
> 
> So this seems to imply that a Laf has to consciously opt-out of one touch .. which is surprising to me. i.e you have to know about this property in the first place to opt-out .. and I don't see where it is documented so how can anyone writing a LaF know about it ?
> Is there not a central document about all of these ?

@prrace could you please take a look?

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

PR Comment: https://git.openjdk.org/jdk/pull/20289#issuecomment-2291483466