Revision 137536

Added note that IllegalArgumentException should be thrown when a bad argument
of 'null' is passed in and not NullPointerException.

Also a note that XxxUtils classes should suppress Exceptions when sensible.