added example script of how to retry opening a file handle by trying a backup option via an onfail callback
tweaks to the "retry via onfail callback" proof-of-concept developer's script that was added in the last commit
bugs fixed that were discovered by verifying examples in the documentation OOPS!