CID 608055: Fixed unintended sign extension.
Clarified why the documentation does not belong into headers.

* Haiku is slow, and that's why we do not put documentation in headers???
  Hell yeah.