clarify

Resolve [NEEDS CLARIFICATION] markers in specs with structured options