update grammar pool interface so that cacheGrammar(Grammar) can tell the caller whether the grammar was accepted.  Also fix some documentation errors.


git-svn-id: https://svn.apache.org/repos/asf/xerces/c/trunk@175359 13f79535-47bb-0310-9956-ffa450edef68