Add `rethrowSTM` and improve STM-related documentation
Adding rethrowSTM resolves #26758 (closed) and implements CLC proposal #436.
The implementation of rethrowSTM is completely analogous to the one of rethrowIO.
The following is established for the documentation of throwSTM and catchSTM:
-
Both operations are directly described as analogs of their
IOcounterparts. -
There is no reference to
throwin the documentation ofthrowSTM, because, although such a reference is great in the documentation ofthrowIO, it is somewhat out of place in the documentation ofthrowSTM. -
Instead of repeating part of
throwIO’s documentation, the documentation ofthrowSTMjust recommends usingthrowSTMinstead ofthrowand references the corresponding arguments in the documentation ofthrowIO.