doc cleanup: separate types/signatures from POD headers