API: libpacemaker: pcmk_controller_status() node name arg is now const

Implement other best practices in pcmk_controller_status() and called
functions: add doxygen blocks, improve an error message, change
"dest_node" argument to "node_name", fix spacing.

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