Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Fix error messages from Javadocs #4191
I'm trying to significantly reduce the number of error messages from the
This isn't finished yet; I'd like some advice. This first commit was just running GenerateDescriptions.py with some patching/manual editing of files where it was broken. This was so that if I needed to modify and rerun the script or XMLs later, the later commits' diffs wouldn't contain ordinary updates to XML files.
The second commit fixes most of the errors except those in the HTML and syntax categories of Javadoc's Doc-lint tool, and suppresses the production of those messages by the Javadoc tool. It also makes the
This just leaves the syntax errors. As far as I can tell, there's no way to stop Javadoc moaning about
I'm asking because I don't know what else uses those files and how strict their XML needs to be. I'd also need to wrap code samples in the XMLs in