javadocs and compilation warnings