filters: added some documentation and a basic example for a filter

Have a look and let me know if you want more... I can add some more examples at a later point when my filters are really working ;)

Signed-off-by: Arun Persaud <apersaud@lbl.gov>