add doc comments to Filter interface