* proc.c (Kernel#define_singleton_method): rdoc. based on a patch by

  Marc-Andre Lafortune <ruby-core-mailing-list AT marc-andre.ca>.
  [ruby-core:23944].

git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@24089 b2dd03c8-39d4-4d8f-98ff-823fe69b080e

1 files changed, 26 insertions, 0 deletions

diff --git a/proc.c b/proc.c
index a1b2feea19..9b7e3c63aa 100644
--- a/proc.c
+++ b/proc.c
@@ -1264,6 +1264,32 @@ rb_mod_define_method(int argc, VALUE *argv, VALUE mod)
     return body;
 }
 
+/*
+ *  call-seq:
+ *     define_singleton_method(symbol, method) => new_method
+ *     define_singleton_method(symbol) { block } => proc
+ *
+ *  Defines a singleton method in the receiver. The _method_
+ *  parameter can be a +Proc+ or +Method+ object.
+ *  If a block is specified, it is used as the method body. 
+ *
+ *     class A
+ *       class << self
+ *         def class_name
+ *           to_s
+ *         end
+ *       end
+ *     end
+ *     A.define_singleton_method(:who_am_i) do
+ *       "I am: #{class_name}"
+ *     end
+ *     A.who_am_i   # ==> "I am: A"
+ *
+ *     guy = "Bob"
+ *     guy.define_singleton_method(:hello) { "#{self}: Hello there!" }
+ *     guy.hello    # =>  "Bob: Hello there!"
+ */
+
 static VALUE
 rb_obj_define_method(int argc, VALUE *argv, VALUE obj)
 {