Update doxygen comment to match renamed parameters.

Found by -Wdocumentation.
Improved tests (and fixed a bug in the tests); thanks to Richard Smith for the suggestion