change comparison to predicate; update docs