Add the Pism_DOXYGEN_DOCUMENT_ALL CMake option.

This option switches between "include all classes in the browser, do not
warn if something is undocumented" and "include only documented classes
in the browser, warn if something is undocumented."
Add more doxygen comments.