[DOC] Revision of Paragraphs section

BurdetteLamar · BurdetteLamar · commit f6afad9a879d · 2025-08-27T09:48:43.000-05:00
diff --git a/doc/rdoc/markup_reference.rb b/doc/rdoc/markup_reference.rb
@@ -124,14 +124,8 @@
 #
 #   You'll love it.
 #
-# A paragraph may contain nested blocks, including:
+# A paragraph may contain only one type of nested block:
 #
-# - {Verbatim text blocks}[rdoc-ref:RDoc::MarkupReference@Verbatim+Text+Blocks].
-# - {Code blocks}[rdoc-ref:RDoc::MarkupReference@Code+Blocks].
-# - {Block quotes}[rdoc-ref:RDoc::MarkupReference@Block+Quotes].
-# - {Lists}[rdoc-ref:RDoc::MarkupReference@Lists].
-# - {Headings}[rdoc-ref:RDoc::MarkupReference@Headings].
-# - {Horizontal rules}[rdoc-ref:RDoc::MarkupReference@Horizontal+Rules].
 # - {Text Markup}[rdoc-ref:RDoc:MarkupReference@Text+Markup].
 #
 # ==== Verbatim Text Blocks

Original file line number	Diff line number	Diff line change
`@@ -124,14 +124,8 @@`
`124`	`124`	`#`
`125`	`125`	`# You'll love it.`
`126`	`126`	`#`
`127`		`-# A paragraph may contain nested blocks, including:`
	`127`	`+# A paragraph may contain only one type of nested block:`
`128`	`128`	`#`
`129`		`-# - {Verbatim text blocks}[rdoc-ref:RDoc::MarkupReference@Verbatim+Text+Blocks].`
`130`		`-# - {Code blocks}[rdoc-ref:RDoc::MarkupReference@Code+Blocks].`
`131`		`-# - {Block quotes}[rdoc-ref:RDoc::MarkupReference@Block+Quotes].`
`132`		`-# - {Lists}[rdoc-ref:RDoc::MarkupReference@Lists].`
`133`		`-# - {Headings}[rdoc-ref:RDoc::MarkupReference@Headings].`
`134`		`-# - {Horizontal rules}[rdoc-ref:RDoc::MarkupReference@Horizontal+Rules].`
`135`	`129`	`# - {Text Markup}[rdoc-ref:RDoc:MarkupReference@Text+Markup].`
`136`	`130`	`#`
`137`	`131`	`# ==== Verbatim Text Blocks`