add test coverage for reference target
update documentation for new callback