Okay, I'm fine with that. I just hope that the comment will not go out-of-sync with the code. It's always a risk if the code lives far away from the comment. But I agree, it's nice to provide this information to the API users.