better names and types for parser entry points