Refactor: libcrmcommon: Some best practices in pcmk__xml_update()

Improve variable names, doxygen, and comments, and make crm_trace()
calls more readable.

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