The existing Click API is very large and a lot of edge cases are undocumented. Additionally there are lots of combinations between parameters and options.

I am not sure what is the best way to document all the combinations. There are enough combinations that it is hard to remember them all. Maybe a table with with tests that correlate to the table entry?