added todo; documented filters on each function