paula: tried to improve the documentation.