Add documentation for the Filterer behavior.

This defines the specification that the filterer is given and hopefully
makes it a bit easier to understand, although that's a tough task ;)