Update mask docs

This PR updates the mask documentation, removing the mirroring and adding the new `mask_method` options with some examples.

Merge only after https://github.com/astropy/photutils/pull/133 is merged.