Re: [PR] disable doclint [xerces-j]

SingingBush commented on PR #38:
URL: https://github.com/apache/xerces-j/pull/38#issuecomment-3549317497

   A lot of these doclint issues are gone and some of the remaining ones can probably be tackled fairly easily. One issue that creates a lot of errors is that numerous methods (x19) have been documented with `@throws SAXNotRecognizedException` when the method in question doesn't actually throw a _SAXNotRecognizedException_. 
   Some other make reference to `@exception DOMSystemException` but _DOMSystemException_ doesn't exist. I had to google search to find a full path of `org.w3c.dom.DOMSystemException` but it seems that no longer exists or perhaps was renamed to `org.w3c.dom.DOMException` which does at least exist. 
   
   I can make PRs for these problems, after that then there's just a few leftover errors:
   
   - `error: unknown tag: xsl.usage`
   - `error: no caption for table`
   - `error: heading used out of sequence: <H3>, compared to implicit preceding heading: <H1>`
   
   there's warnings, but that's not so much of a problem. Having `failonerror='yes'` in the Javadoc would be a good thing


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]