I will add a @param comment block, because that is probably the most correct way to explain it. And forcing someone to read the spec isn't exactly good user experience (especially if he is in a rush). I will get a commit out in a few minutes :)