Javadoc for shouldYieldFocus says:

Returns:
    true when valid, false when invalid

It's not clear and doesn't correspond to the description of the method: "If this method returns true, then the focus is transferred normally; if it returns false, then the focus remains in the argument component."

So the '@return' tag should say something like: true to allow focus transfer, false to make focus remain on the current component