>I was just following a sample file I found.
>

That's the way people write code these days. Copy and paste, no need to
understand it. Either that, or ask ChatGPT to do it for them. I guess ChatGPT
looks at more examples and is therefore more likely to get it right. Who
knows, it might even read the documentation.

I guess that for people like us developing APIs the important lesson is to try
and make the method names as explicit as we possibly can.
"set_initial_match_selection" was, I suppose, an attempt to do that. But it's
only explicit if you know what the "initial match selection" is, and I suppose
most people don't.

It's hard to see how to avoid such problems.

Michael Kay
Saxonica