Clarify/fix header comments of the compression API.