(QENG-1211) Added documentation & tests for retry_on

Before, the retry_command method was private by convention, because it didn't have
tests or any documentation.  Some of the QA team wanted to use this functionality,
so now we've added those supporting items to gain confidence in its regular use.