summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorBurdette Lamar <BurdetteLamar@Yahoo.com>2022-08-11 15:08:57 -0500
committergit <svn-admin@ruby-lang.org>2022-08-12 05:09:02 +0900
commit5e3e4bc9840160f2a6f85cba2e05279d7668b014 (patch)
treeaef5c5e6698f0f13017cf2ba179511c6d1369eaa /doc
parent8a3f401b24e1b5f3e3a0f44c568a3e66ed595d42 (diff)
[ruby/rdoc] Mods to section Text Markup (https://github.com/ruby/rdoc/pull/916)
https://github.com/ruby/rdoc/commit/5506d4d67e
Diffstat (limited to 'doc')
-rw-r--r--doc/rdoc/markup_reference.rb26
1 files changed, 16 insertions, 10 deletions
diff --git a/doc/rdoc/markup_reference.rb b/doc/rdoc/markup_reference.rb
index c7578f3581..04e90aad23 100644
--- a/doc/rdoc/markup_reference.rb
+++ b/doc/rdoc/markup_reference.rb
@@ -94,7 +94,7 @@ require 'rdoc'
# - {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 @@ require 'rdoc'
#
# ==== 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 @@ require 'rdoc'
#
# ====== _Italic_ in a Heading
#
-# ===== Bold
+# ====== Bold
#
# Text may be marked as bold via HTML tag <tt><b></tt>.
#
@@ -755,7 +761,7 @@ require 'rdoc'
#
# ===== *Bold* in a Heading
#
-# ===== Monofont
+# ====== Monofont
#
# Text may be marked as monofont
# -- sometimes called 'typewriter font' --