matcher: fix poorly named parameter.
doc: add docs for matcher functions.