> - don't specify the length of the state argument: just say it's the same as
 >   the return value.

The state argument can be the empty list, I'd say "same form" should
suffice here.

 > - specify the ignored elements rather than the non-ignored ones.
 >   The list of ignored ones is much less likely to change.

Elementary.  I attached a patch.