Refactor: libpacemaker: best practices when simulating fencing actions

Rename exec_stonith_action() to simulate_fencing_action() for clarity,
add a doxygen block, and improve comments and formatting.