Yes it is documented... Somewhere

I think it was the release notes when it was added
Another place is the Balloon help on the button
BTW
there are two arrow (placement) types used in Calibre:
Mid level arrow: (right-click type) Menu available, button is default action
Bottom Level arrow: There is a sub-Menu