docs:  add mention of index swapping

Backpatch to 9.3

Greg Smith
docs:  mention SGML refentry also pulls text from the link
docs:  improve xref description for xreflabel and refentry links