Improve clipping documentation
Improve clipping documentation

The old documentation was very out of date. The new documentation
is slightly less complete, but should be much more accurate.

This is part of #2666.

servo/webrender,servo/webrender,servo/webrender,servo/webrender,servo/webrender,servo/webrender