CMake fine tuning. Fix some issues with valadoc and CMake.

 * Enable documentation as default for release builds (if valadoc is
   available).
 * Support multiple independent documentation builds inside a single CMake
   project.
 * Avoid manual valac arguments and add library functionality to
   UseVala.cmake.