Assorted javadoc updates. Add more explicit error conditions often assocaited with passing null, require IllegalArgument/IlleglStateExceptions to be thrown. svn path=/trunk/; revision=486