Bringing filter docs more in line with events

There was missing info about the ability to define a method to use for filter classes, and reorganized to match the events docs.
Merge pull request #644 from janhartigan/patch-2

Bringing filter docs more in line with events