tests and javadoc

ensured DEBUG flags were set and minor updates to javadoc