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 ;)
Merge pull request #37 from nubs/master

Add documentation for the Filterer behavior.