Mods to section Text Markup (#916)

BurdetteLamar · web-flow · commit 5506d4d67e4e · 2022-08-11T15:08:57.000-05:00
diff --git a/doc/rdoc/markup_reference.rb b/doc/rdoc/markup_reference.rb
@@ -94,7 +94,7 @@
 # - {Directive}[rdoc-ref:RDoc::MarkupReference@Directives]:
 #   various special directions for the rendering.
 # - {Text Markup}[rdoc-ref:RDoc:MarkupReference@Text+Markup]:
-#   text to be rendered in italic, bold, or monofont.
+#   text to be rendered in a special way.
 #
 # About the blocks:
 #
@@ -632,18 +632,24 @@
 #
 # ==== Text Markup
 #
-# Text markup is metatext that marks text as:
+# Text markup is metatext that affects HTML rendering:
 #
-# - Italic.
-# - Bold.
-# - Monofont.
+# - Typeface: italic, bold, monofont.
+# - Character conversions: copyright, trademark, certain punctuation.
+# - Links.
+# - Escapes: marking text as "not markup."
 #
-# Text markup may contain only one type of nested block:
+# ===== Typeface Markup
 #
-# - More text markup:
+# Typeface markup can specify that text is to be rendered
+# as italic, bold, or monofont.
+#
+# Typeface markup may contain only one type of nested block:
+#
+# - More typeface markup:
 #   italic, bold, monofont.
 #
-# ===== Italic
+# ====== Italic
 #
 # Text may be marked as italic via HTML tag <tt><i></tt> or <tt><em></tt>.
 #
@@ -698,7 +704,7 @@
 #
 #   ====== _Italic_ in a Heading
 #
-# ===== Bold
+# ====== Bold
 #
 # Text may be marked as bold via HTML tag <tt><b></tt>.
 #
@@ -755,7 +761,7 @@
 #
 #   ===== *Bold* in a Heading
 #
-# ===== Monofont
+# ====== Monofont
 #
 # Text may be marked as monofont
 # -- sometimes called 'typewriter font' --

Original file line number	Diff line number	Diff line change
`@@ -94,7 +94,7 @@`
`94`	`94`	`# - {Directive}[rdoc-ref:RDoc::MarkupReference@Directives]:`
`95`	`95`	`# various special directions for the rendering.`
`96`	`96`	`# - {Text Markup}[rdoc-ref:RDoc:MarkupReference@Text+Markup]:`
`97`		`-# text to be rendered in italic, bold, or monofont.`
	`97`	`+# text to be rendered in a special way.`
`98`	`98`	`#`
`99`	`99`	`# About the blocks:`
`100`	`100`	`#`
`@@ -632,18 +632,24 @@`
`632`	`632`	`#`
`633`	`633`	`# ==== Text Markup`
`634`	`634`	`#`
`635`		`-# Text markup is metatext that marks text as:`
	`635`	`+# Text markup is metatext that affects HTML rendering:`
`636`	`636`	`#`
`637`		`-# - Italic.`
`638`		`-# - Bold.`
`639`		`-# - Monofont.`
	`637`	`+# - Typeface: italic, bold, monofont.`
	`638`	`+# - Character conversions: copyright, trademark, certain punctuation.`
	`639`	`+# - Links.`
	`640`	`+# - Escapes: marking text as "not markup."`
`640`	`641`	`#`
`641`		`-# Text markup may contain only one type of nested block:`
	`642`	`+# ===== Typeface Markup`
`642`	`643`	`#`
`643`		`-# - More text markup:`
	`644`	`+# Typeface markup can specify that text is to be rendered`
	`645`	`+# as italic, bold, or monofont.`
	`646`	`+#`
	`647`	`+# Typeface markup may contain only one type of nested block:`
	`648`	`+#`
	`649`	`+# - More typeface markup:`
`644`	`650`	`# italic, bold, monofont.`
`645`	`651`	`#`
`646`		`-# ===== Italic`
	`652`	`+# ====== Italic`
`647`	`653`	`#`
`648`	`654`	`# Text may be marked as italic via HTML tag <tt><i></tt> or <tt><em></tt>.`
`649`	`655`	`#`
`@@ -698,7 +704,7 @@`
`698`	`704`	`#`
`699`	`705`	`# ====== _Italic_ in a Heading`
`700`	`706`	`#`
`701`		`-# ===== Bold`
	`707`	`+# ====== Bold`
`702`	`708`	`#`
`703`	`709`	`# Text may be marked as bold via HTML tag <tt><b></tt>.`
`704`	`710`	`#`
`@@ -755,7 +761,7 @@`
`755`	`761`	`#`
`756`	`762`	`# ===== Bold in a Heading`
`757`	`763`	`#`
`758`		`-# ===== Monofont`
	`764`	`+# ====== Monofont`
`759`	`765`	`#`
`760`	`766`	`# Text may be marked as monofont`
`761`	`767`	`# -- sometimes called 'typewriter font' --`