Add clipper_clip() documentation and improve comments a tiny bit. Signed-off-by: Loïc Molinari <loic.molinari@collabora.com>