[DOC] Parse options doc (#3360)

**What problem is this PR intended to solve?**

Improvements to doc for XML::ParseOptions.

**Have you included adequate test coverage?**

N/A.  All doc.

**Does this change affect the behavior of either the C or the Java
implementations?**

No.

---------

Co-authored-by: Mike Dalessio <[email protected]>