Refactor: libcrmcommon: best practices for pcmk__cmp_nvpair_blocks()
Add a doxygen block, and improve comments and formatting.