Fix Bugzilla 3491: updated error message text; also updated Javadoc to reflect @throws; note that the Javadoc is still somewhat contradictory about returning a null on error (it appears to throw exceptions instead) PR:3491 Submitted by:Julian.Birch@ranplc.co.uk