Explain the code for the #952 fix.

Let's explain what Trinity did in its fix for #952 (closed), so that we know why this code is here the next time we find it.

Comments only. cc @trinity-1686a