Document that we now support Integer advanced indexing (not boolean mask).
Merge pull request #1362 from nouiz/doc_adv_idx

Document that we now support Integer advanced indexing (not boolean mask)