You're making me regret adding the comments :)  That was a last-minute addition to the patch set.

I'll make them proper doxygen comments.