Move all function documentation in to COMMENT characteristics clauses and the README