Refactor: libpacemaker: best practices when injecting ticket attributes

Add a doxygen block for set_ticket_state_attr(), drop an argument that was
always the same value, make it return a standard code, and improve comments and
formatting.