[XERCESJ-1781] Javadoc fixes for html in org.apache.xerces

[SingingBush]

Some more html fixes for errors in Javadoc generation. Mostly handling chars like < and & correctly. Not that tables need to have a caption tag. I've left it blank as there was previously no caption anyway. This at least prevents html errors in Javadoc (note that empty caption is a warning)

[elharo]

Near as I can tell captions on tables are not required in both XHTML 1.0 and the "Living Standard". They're recommended but not with empty content

[SingingBush]

Near as I can tell captions on tables are not required in both XHTML 1.0 and the "Living Standard". They're recommended but not with empty content

yeah, it's odd that the Javadoc linter has been set to treat the lack of a captions block as an error

[elharo]

You need to remove the empty captions

[SingingBush]

You need to remove the empty captions

I'll push another commit that reverts them. That will of course leave errors such as:

  [javadoc] /home/user/apache/xerces-j/build/src/org/apache/xerces/xs/datatypes/package.html:220: error: no caption for table
  [javadoc] </TABLE>
  [javadoc] ^

I'd recommend going the other way and just deciding on some text to use in the caption.

I do agree that the javadoc process should not consider this an error though. Perhaps it should be raised with Open JDK

[elharo]

You can add captions in a separate PR if you like, but they need to be meaningful and useful, not pro forma placeholders. If it makes more sense for a table to not have a caption it shouldn't have one, warning or not.

[elharo]

I think p is more appropriate than pre here. Whitespace can be collapsed here

[SingingBush]

updated