pgsql: Improve documentation about our XML functionality

Improve documentation about our XML functionality

Add a section explaining how our XML features depart from current
versions of the SQL standard. Update and clarify the descriptions
of some XML functions.

This is a backpatch for branches 10 and 11, taken from Tom's commit
12d46ac392d0 for 12, then edited to correctly describe behaviors that
are fixed in 12 but still broken in 10 and 11.

Chapman Flack, reviewed by Ryan Lambert

Discussion: https://postgr.es/m/[email protected]
Discussion: https://postgr.es/m/[email protected]
Discussion: https://postgr.es/m/CAN-V+g-6JqUQEQZ55Q3toXEN6d5Ez5uvzL4VR+8KtvJKj31taw@mail.gmail.com

Branch
------
REL_10_STABLE

Details
-------
https://git.postgresql.org/pg/commitdiff/603a28b4497347bc0a4ff1dbea3bb6d1e04d740c

Modified Files
--------------
doc/src/sgml/datatype.sgml | 5 +
doc/src/sgml/features.sgml | 381 ++++++++++++++++++++++++++++++++++-
doc/src/sgml/func.sgml | 188 +++++++++--------
src/backend/catalog/sql_features.txt | 6 +-
4 files changed, 492 insertions(+), 88 deletions(-)