Thanks, I knew I didn't have my head on straight!

There are 2 minor typos in your example, which Getopt::Declare makes easy to find.

First, there doesn't appear to be a tab between the specifications and the descriptions (but this may be due to the cut and paste).

Second, a blank line is needed between each parameter spec and the next.