Improve the documentation of execute_yum_command

Clarify the return values and put it into a POD section, in case future
code desires to invoke Yum/repoquery.