diff --git a/doc/src/sgml/README.links b/doc/src/sgml/README.links
index 5f3668d38b1a529dcd9dab12792958513ea17ada..f64b85731695cffe30311c95f7b407bd9ca56e82 100644
--- a/doc/src/sgml/README.links
+++ b/doc/src/sgml/README.links
@@ -7,8 +7,9 @@ Intra-document Linking
 ----------------------
 
 <xref>
-	use to get chapter/section # from the title of the target
-	link, or xreflabel or refentry if defined at the target; has no close tag
+	use to get chapter/section number from the title of the target
+	link, or xreflabel if defined at the target, or refentrytitle if target
+        is a refentry;  has no close tag
 	http://www.oasis-open.org/docbook/documentation/reference/html/xref.html
 
 <link>