Refactor: libpacemaker: Best practices in pcmk_designated_controller()

Implement best practices in pcmk_designated_controller() and called
functions: add doxygen blocks, improve an error message, shorten
overlong lines, fix indentation.

Signed-off-by: Reid Wahl <nrwahl@protonmail.com>