common: Improve a function's documentation and comments.