> I think I would remove the parameter documentation and leave only the
> short description above. Those two functions are private and short. The
> documentation takes more space than the actual implementation.

I was actually thinking the same. So +1 on this remark