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]


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to