method still needs to support string exceptions, and allow None for the
third argument.  Documentation updates are needed, too.