DOC: Improved doc for boolean array indexing

Explain how multidimensional boolean index arrays interact with multidimensional arrays being indexed, and clear up some confusion about broadcasting.