completed tracing and javadoc for some classes