Explain the behavior of `finally` blocks in the readme examples

[IanButterworth]

From the readme it's not clear what happens if there's a finally on the try-catch blocks. It would be good to explain when those finally blocks are called in the retry process

[IanButterworth]

Also, I think the current behavior of finally is a bit unexpected

I think it's reasonable to expect the following:

julia> Retry.@repeat 3 try
               error()
       catch e
               println("catch");
               @delay_retry if e isa ErrorException end
       finally
               println("finally")
       end
catch
catch
catch
finally
ERROR: 
Stacktrace:
 [1] error()
   @ Base ./error.jl:42
 [2] top-level scope
   @ ~/.julia/packages/Retry/vS1bg/src/repeat_try.jl:192

[mattBrzezinski]

Do you have an example of current behaviour? Your blob for expected is what I would assume is happening here.

[IanButterworth]

Current behavior:

julia> Retry.@repeat 3 try
               error()
       catch e
               println("catch");
               @delay_retry if e isa ErrorException end
       finally
               println("finally")
       end
catch
finally
catch
finally
catch
finally
ERROR: 
Stacktrace:
 [1] error()
   @ Base ./error.jl:42
 [2] top-level scope
   @ ~/.julia/packages/Retry/vS1bg/src/repeat_try.jl:192