diff --git a/doc/src/sgml/README.links b/doc/src/sgml/README.links
index 4181e0877b..65df9c111f 100644
--- a/doc/src/sgml/README.links
+++ b/doc/src/sgml/README.links
@@ -22,6 +22,7 @@ endterm=
 <link>
 	use to supply text for the link, only uses linkend, requires </link>
 	http://www.oasis-open.org/docbook/documentation/reference/html/link.html
+	can be embedded inside of <command>, unlike <xref>
 
 
 External Linking