[options] parsing bug (or lack of documentation probably)

[grogancolin]

When using [options] in a usage string, it seems you must put any options allowed there in a:

Generic options:
      --optA
      --optB

I found this through trial and error (and your git example).

Is this a bug or just a lack of documentation? (Or the likely third option, me being tired and not seeing the docs if they exist!)