Bad usage of doxygen reserved keywords :) should be return. retval should be used if you name the returned value. Also input should be param :)