DOC: clarify intent of masking using a list of keys
DOC: make more consistent with other doc strings