Refactor: libpacemaker,controller: best practices for graph execution functions

Name according to current guidelines, use bool instead of gboolean where
appropriate, use standard return codes where appropriate, and add doxygen
comments.

Also, improve log messages.