diff options
| author | dave <dave@b2dd03c8-39d4-4d8f-98ff-823fe69b080e> | 2004-12-04 05:38:17 +0000 |
|---|---|---|
| committer | dave <dave@b2dd03c8-39d4-4d8f-98ff-823fe69b080e> | 2004-12-04 05:38:17 +0000 |
| commit | 01cfa9ec91e74b7cbb653a913a8e65e425bf0601 (patch) | |
| tree | 5a55c360dcac53469d4de426528edc1a0e3a4a6a /lib/rdoc/README | |
| parent | 05aae82a432f33d53fd790f622746b843eb63a30 (diff) | |
| download | ruby-01cfa9ec91e74b7cbb653a913a8e65e425bf0601.tar.gz ruby-01cfa9ec91e74b7cbb653a913a8e65e425bf0601.tar.xz ruby-01cfa9ec91e74b7cbb653a913a8e65e425bf0601.zip | |
Ignore leading and trailing lines in :section: blocks
git-svn-id: http://svn.ruby-lang.org/repos/ruby/branches/ruby_1_8@7455 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
Diffstat (limited to 'lib/rdoc/README')
| -rw-r--r-- | lib/rdoc/README | 12 |
1 files changed, 11 insertions, 1 deletions
diff --git a/lib/rdoc/README b/lib/rdoc/README index 583f7f3b0..60650dd88 100644 --- a/lib/rdoc/README +++ b/lib/rdoc/README @@ -427,7 +427,17 @@ this margin are formatted verbatim. <tt>:section:</tt> is used as the section heading, and the remainder of the comment containing the section is used as introductory text. Subsequent methods, aliases, attributes, - and classes will be documented in this section. + and classes will be documented in this section. A :section: + comment block may have one or more lines before the :section: + directive. These will be removed, and any identical lines at + the end of the block are also removed. This allows you to add + visual cues such as + + # ---------------------------------------- + # :section: My Section + # This is the section that I wrote. + # See it glisten in the noon-day sun. + # ---------------------------------------- [<tt>call-seq:</tt>] lines up to the next blank line in the comment are treated as |