more docs improvements
add backwards compatible behavior to mask_ellipse