I am sorry, this is not an issue as such, but I have read the docs probably 100 times, and I just cannot figure out how firstMatch and alwaysMatch work.
I see the mechanical instructions in the specs, but what is missing is a fundamental explanation of the meaning of it all. Why is it called firstMatch? And why is alwaysMatch "merged"? How does the functionality check effectively work, and why?

I have just finished writing a decent webdriver API which comes with full documentation, and I am having real trouble explaining what those parameters actually mean...! (And have found absolutely nothing online -- My StackOverflow question has been sitting there quietly for days)