zzak	2013-02-24 13:49:04 +0900 (Sun, 24 Feb 2013)

  New Revision: 39455

  http://svn.ruby-lang.org/cgi-bin/viewvc.cgi?view=rev&revision=39455

  Log:
    * lib/mutex_m.rb: Add rdoc for Mutex_m module [Backport #7930]

  Modified files:
    branches/ruby_2_0_0/ChangeLog
    branches/ruby_2_0_0/lib/mutex_m.rb

Index: ruby_2_0_0/ChangeLog
===================================================================
--- ruby_2_0_0/ChangeLog	(revision 39454)
+++ ruby_2_0_0/ChangeLog	(revision 39455)
@@ -1,3 +1,7 @@ https://github.com/ruby/ruby/blob/trunk/ruby_2_0_0/ChangeLog#L1
+Wed Feb 20 11:50:00 2013  Zachary Scott  <zachary@z...>
+
+	* lib/mutex_m.rb: Add rdoc for Mutex_m module [Backport #7930]
+
 Tue Feb 19 12:30:00 2013  Zachary Scott  <zachary@z...>
 
 	* object.c: rdoc formatting for Kernel#Array() [Backport #7931]
Index: ruby_2_0_0/lib/mutex_m.rb
===================================================================
--- ruby_2_0_0/lib/mutex_m.rb	(revision 39454)
+++ ruby_2_0_0/lib/mutex_m.rb	(revision 39455)
@@ -8,25 +8,36 @@ https://github.com/ruby/ruby/blob/trunk/ruby_2_0_0/lib/mutex_m.rb#L8
 #       patched by akira yamada
 #
 # --
-#   Usage:
-#       require "mutex_m.rb"
-#       obj = Object.new
-#       obj.extend Mutex_m
-#       ...
-#       extended object can be handled like Mutex
-#       or
-#       class Foo
-#         include Mutex_m
-#         ...
-#       end
-#       obj = Foo.new
-#       this obj can be handled like Mutex
-#
+
 
 require 'thread'
 
+# = mutex_m.rb
+#
+# When 'mutex_m' is required, any object that extends or includes Mutex_m will
+# be treated like a Mutex.
+#
+# Start by requiring the standard library Mutex_m:
+#
+#   require "mutex_m.rb"
+#
+# From here you can extend an object with Mutex instance methods:
+#
+#   obj = Object.new
+#   obj.extend Mutex_m
+#
+# Or mixin Mutex_m into your module to your class inherit Mutex instance
+# methods.
+#
+#   class Foo
+#     include Mutex_m
+#     # ...
+#   end
+#   obj = Foo.new
+#   # this obj can be handled like Mutex
+#
 module Mutex_m
-  def Mutex_m.define_aliases(cl)
+  def Mutex_m.define_aliases(cl) # :nodoc:
     cl.module_eval %q{
       alias locked? mu_locked?
       alias lock mu_lock
@@ -36,17 +47,17 @@ module Mutex_m https://github.com/ruby/ruby/blob/trunk/ruby_2_0_0/lib/mutex_m.rb#L47
     }
   end
 
-  def Mutex_m.append_features(cl)
+  def Mutex_m.append_features(cl) # :nodoc:
     super
     define_aliases(cl) unless cl.instance_of?(Module)
   end
 
-  def Mutex_m.extend_object(obj)
+  def Mutex_m.extend_object(obj) # :nodoc:
     super
     obj.mu_extended
   end
 
-  def mu_extended
+  def mu_extended # :nodoc:
     unless (defined? locked? and
             defined? lock and
             defined? unlock and
@@ -57,38 +68,43 @@ module Mutex_m https://github.com/ruby/ruby/blob/trunk/ruby_2_0_0/lib/mutex_m.rb#L68
     mu_initialize
   end
 
-  # locking
+  # See Mutex#synchronize
   def mu_synchronize(&block)
     @_mutex.synchronize(&block)
   end
 
+  # See Mutex#locked?
   def mu_locked?
     @_mutex.locked?
   end
 
+  # See Mutex#try_lock
   def mu_try_lock
     @_mutex.try_lock
   end
 
+  # See Mutex#lock
   def mu_lock
     @_mutex.lock
   end
 
+  # See Mutex#unlock
   def mu_unlock
     @_mutex.unlock
   end
 
+  # See Mutex#sleep
   def sleep(timeout = nil)
     @_mutex.sleep(timeout)
   end
 
   private
 
-  def mu_initialize
+  def mu_initialize # :nodoc:
     @_mutex = Mutex.new
   end
 
-  def initialize(*args)
+  def initialize(*args) # :nodoc:
     mu_initialize
     super
   end

--
ML: ruby-changes@q...
Info: http://www.atdot.net/~ko1/quickml/