diff options
Diffstat (limited to 'lib/rdoc')
| -rw-r--r-- | lib/rdoc/README | 5 | ||||
| -rw-r--r-- | lib/rdoc/parsers/parse_rb.rb | 10 |
2 files changed, 15 insertions, 0 deletions
diff --git a/lib/rdoc/README b/lib/rdoc/README index e13ab87dc8..cfc99cb50f 100644 --- a/lib/rdoc/README +++ b/lib/rdoc/README @@ -419,6 +419,11 @@ this margin are formatted verbatim. 12. Comment blocks can contain other directives: + [<tt>call-seq:</tt>] + lines up to the next blank line in the comment are treated as + the method's calling sequence, overriding the + default parsing of method parameters and yield arguments. + [<tt>:include:</tt><i>filename</i>] include the contents of the named file at this point. The file will be searched for in the directories listed by diff --git a/lib/rdoc/parsers/parse_rb.rb b/lib/rdoc/parsers/parse_rb.rb index 70236af343..9f02dfd079 100644 --- a/lib/rdoc/parsers/parse_rb.rb +++ b/lib/rdoc/parsers/parse_rb.rb @@ -1975,6 +1975,16 @@ module RDoc parse_statements(container, single, meth) remove_token_listener(meth) + + # Look for a 'call-seq' in the comment, and override the + # normal parameter stuff + + if comment.sub!(/call-seq:(.*?)^\s*\#?\s*$/m, '') +$stderr.puts $1 + seq = $1 + seq.gsub!(/^\s*\#\s*/, '') + meth.call_seq = seq + end meth.comment = comment |