summaryrefslogtreecommitdiff
path: root/lib/rdoc/README
diff options
context:
space:
mode:
Diffstat (limited to 'lib/rdoc/README')
-rw-r--r--lib/rdoc/README10
1 files changed, 9 insertions, 1 deletions
diff --git a/lib/rdoc/README b/lib/rdoc/README
index 0c10d0ea69..6e234e31a5 100644
--- a/lib/rdoc/README
+++ b/lib/rdoc/README
@@ -240,7 +240,15 @@ can see the formatted result in EXAMPLE.rb and Anagram.
= Markup
-Comment blocks can be written fairly naturally.
+Comment blocks can be written fairly naturally, either using '#' on
+successive lines of the comment, or by including the comment in
+an =begin/=end block. If you use the latter form, the =begin line
+must be flagged with an RDoc tag:
+
+ =begin rdoc
+ Documentation to
+ be processed by RDoc.
+ =end
Paragraphs are lines that share the left margin. Text indented past
this margin are formatted verbatim.