update to javadocs and exception throwing

some methods were not throwing exceptions even though the java  docs
said they would