diff --git a/doc/rdoc/markup_reference.rb b/doc/rdoc/markup_reference.rb
index 059511f478..c7578f3581 100644
--- a/doc/rdoc/markup_reference.rb
+++ b/doc/rdoc/markup_reference.rb
@@ -649,27 +649,27 @@
#
# Example input:
#
-# Two words in a paragraph.
+# Italicized words in a paragraph.
#
# >>>
-# Two words in a block quote.
+# Italicized words in a block quote.
#
-# - Two words in a bullet list item.
+# - Italicized words in a list item.
#
-# ====== Two words in a Heading
+# ====== Italicized words in a Heading
#
# Italicized passage containing *bold* and +monofont+.
#
# Rendered HTML:
# >>>
-# Two words in a paragraph.
+# Italicized words in a paragraph.
#
# >>>
-# Two words in a block quote.
+# Italicized words in a block quote.
#
-# - Two words in a bullet list item.
+# - Italicized words in a list item.
#
-# ====== Two words in a Heading
+# ====== Italicized words in a Heading
#
# Italicized passage containing *bold* and +monofont+.
#
@@ -678,29 +678,25 @@
#
# Example input:
#
-# _Word_ in a paragraph.
+# _Italic_ in a paragraph.
#
# >>>
-# _Word_ in a block quote.
+# _Italic_ in a block quote.
#
-# - _Word_ in a bullet list item.
+# - _Italic_ in a list item.
#
-# [_word_] _Word_ in a labeled list item.
-#
-# ====== _Word_ in a Heading
+# ====== _Italic_ in a Heading
#
# Rendered HTML:
# >>>
-# _Word_ in a paragraph.
+# _Italic_ in a paragraph.
#
# >>>
-# _Word_ in a block quote.
-#
-# - _Word_ in a bullet list item.
+# _Italic_ in a block quote.
#
-# [_word_] _Word_ in a labeled list item.
+# - _Italic_ in a list item.
#
-# ====== _Word_ in a Heading
+# ====== _Italic_ in a Heading
#
# ===== Bold
#
@@ -708,28 +704,28 @@
#
# Example input:
#
-# Two words in a paragraph.
+# Bold words in a paragraph.
#
# >>>
-# Two words in a block quote.
+# Bold words in a block quote.
#
-# - Two words in a bullet list item.
+# - Bold words in a list item.
#
-# ====== Two words in a Heading
+# ====== Bold words in a Heading
#
# Bold passage containing _italics_ and +monofont+.
#
# Rendered HTML:
#
# >>>
-# Two words in a paragraph.
+# Bold words in a paragraph.
#
# >>>
-# Two words in a block quote.
+# Bold words in a block quote.
#
-# - Two words in a bullet list item.
+# - Bold words in a list item.
#
-# ====== Two words in a Heading
+# ====== Bold words in a Heading
#
# Bold passage containing _italics_ and +monofont+.
#
@@ -738,30 +734,26 @@
#
# Example input:
#
-# *Word* in a paragraph.
+# *Bold* in a paragraph.
#
# >>>
-# *Word* in a block quote.
+# *Bold* in a block quote.
#
-# - *Word* in a bullet list item.
+# - *Bold* in a list item.
#
-# [*word*] *Word* in a labeled list item.
-#
-# ===== *Word* in a Heading
+# ===== *Bold* in a Heading
#
# Rendered HTML:
#
# >>>
-# *Word* in a paragraph.
+# *Bold* in a paragraph.
#
# >>>
-# *Word* in a block quote.
-#
-# - *Word* in a bullet list item.
+# *Bold* in a block quote.
#
-# [*word*] *Word* in a labeled list item.
+# - *Bold* in a list item.
#
-# ===== *Word* in a Heading
+# ===== *Bold* in a Heading
#
# ===== Monofont
#
@@ -771,28 +763,28 @@
#
# Example input:
#
-# Two words in a paragraph.
+# Monofont words in a paragraph.
#
# >>>
-# Two words in a block quote.
+# Monofont words in a block quote.
#
-# - Two words in a bullet list item.
+# - Monofont words in a list item.
#
-# ====== Two words in heading
+# ====== Monofont words in heading
#
# Monofont passage containing _italics_ and *bold*.
#
# Rendered HTML:
#
# >>>
-# Two words in a paragraph.
+# Monofont words in a paragraph.
#
# >>>
-# Two words in a block quote.
+# Monofont words in a block quote.
#
-# - Two words in a bullet list item.
+# - Monofont words in a list item.
#
-# ====== Two words in heading
+# ====== Monofont words in heading
#
# Monofont passage containing _italics_ and *bold*.
#
@@ -801,26 +793,26 @@
#
# Example input:
#
-# +Word+ in a paragraph.
+# +Monofont+ in a paragraph.
#
# >>>
-# +Word+ in a block quote.
+# +Monofont+ in a block quote.
#
-# - +Word+ in a bullet list item.
+# - +Monofont+ in a list item.
#
-# ====== +Word+ in a Heading
+# ====== +Monofont+ in a Heading
#
# Rendered HTML:
#
# >>>
-# +Word+ in a paragraph.
+# +Monofont+ in a paragraph.
#
# >>>
-# +Word+ in a block quote.
+# +Monofont+ in a block quote.
#
-# - +Word+ in a bullet list item.
+# - +Monofont+ in a list item.
#
-# ====== +Word+ in a Heading
+# ====== +Monofont+ in a Heading
#
# ==== Escaping Text Markup
#