add tests for @Trace
update JavaDoc