I've wanted to move the description into the function header comment. But certainly, this is a bit unclear. I'll change the comment to "Do swap this and rhs".