Fix xml comments

As per the comment by @jonorossi in #1684 the original comments I used were incorrect for what the code is really doing.