From 23d081b993746ffe47d2f42266e4b7856f2450c3 Mon Sep 17 00:00:00 2001 From: dave Date: Thu, 19 Feb 2004 03:23:51 +0000 Subject: Fix typos (Doug Kearns) git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@5779 b2dd03c8-39d4-4d8f-98ff-823fe69b080e --- lib/rdoc/parsers/parse_c.rb | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) (limited to 'lib/rdoc/parsers/parse_c.rb') diff --git a/lib/rdoc/parsers/parse_c.rb b/lib/rdoc/parsers/parse_c.rb index d491e3d88d..d97e08bf4d 100644 --- a/lib/rdoc/parsers/parse_c.rb +++ b/lib/rdoc/parsers/parse_c.rb @@ -44,6 +44,27 @@ # # C classes can be diagramed (see /tc/dl/ruby/ruby/error.c), and RDoc # integrates C and Ruby source into one tree + # + # The comment blocks may include special direcives: + # + # [Document-class: name] + # This comment block is documentation for the given class. Use this + # when the Init_xxx method is not named after the class. + # + # [Document-method: name] + # This comment documents the named method. Use when RDoc cannot outomatically + # find the method from it's declaration + # + # [call-seq: text up to an empty line] + # Because C source doesn't give descripive names to Ruby-level parameters, + # you need to document the calling sequence explicitly + # + # In additon, RDoc assumes by default that the C method implementing a + # Ruby function is in the same source file as the rb_define_method call. + # If this isn't the case, add the comment + # + # rb_define_method(....); // in: filename + # # Classes and modules built in to the interpreter. We need # these to define superclasses of user objects -- cgit v1.2.3