cleaned docs further; expanded and fixed example_test.go; unfortunately had to rename all filters to make docs nicer, sorry.