Page http://docs.python.org/lib/optparse-terminology.html says: The GNU project introduced "-" followed by a series of hyphen-separated words, e.g. "-file" or "-dry-run". but should say: The GNU project introduced "--" followed by a series of hyphen-separated words, e.g. "--file" or "--dry-run". Also at the bottom of that page: "-v" and "-report" are both options. should be: "-v" and "--report" are both options. It looks in general that there is a documentation rendering problem when double-dash appears in quotes. Other double-dash items on that page are ok, when not in quotes.