The prior commit which introduced it was pretty squalid in terms of
code documentation, so add some comments.