Low: tools: improve how crm_node -R purges node from fencer

Now that the fencer is the only daemon handled by tools_remove_node_cache(),
rename that to purge_node_from_fencer() and have it target only the fencer.

Also, add a doxygen block, make it return a standard code, and improve log
messages, variables names, and formatting.