diff --git a/pages/common/xml-edit.md b/pages/common/xml-edit.md
index fd760c291..338b71a37 100644
--- a/pages/common/xml-edit.md
+++ b/pages/common/xml-edit.md
@@ -15,7 +15,7 @@
 
 `xml edit --rename "{{//*/@id}}" -v "{{ID}}" {{path/to/input.xml|URI}}`
 
-- Rename the XML elements of "table" named "rec" to "record":
+- Rename sub-elements of the element "table" that are named "rec" to "record":
 
 `xml edit --rename "{{/xml/table/rec}}" -v "{{record}}" {{path/to/input.xml|URI}}`
 
diff --git a/pages/common/xml-select.md b/pages/common/xml-select.md
index 6b6c58376..321e2827c 100644
--- a/pages/common/xml-select.md
+++ b/pages/common/xml-select.md
@@ -4,7 +4,7 @@
 > Tip: use `xml elements` to display the XPATHs of an XML document.
 > More information: <http://xmlstar.sourceforge.net/docs.php>.
 
-- Select all elements matching "XPATH1" and print the value of the element "XPATH2":
+- Select all elements matching "XPATH1" and print the value of their sub-element "XPATH2":
 
 `xml select --template --match "{{XPATH1}}" --value-of "{{XPATH2}}" {{path/to/input.xml|URI}}`