parse-options: clearer reporting of API misuse