From 55f143d4e39545e5a8520f51679364606b2fbef0 Mon Sep 17 00:00:00 2001
From: Daniel Bovensiepen <daniel@bovensiepen.net>
Date: Sun, 6 May 2012 18:15:38 +0800
Subject: Add documentation to Kernel

---
 mrblib/kernel.rb | 37 ++++++++++++++++++++++++++++++-------
 1 file changed, 30 insertions(+), 7 deletions(-)

diff --git a/mrblib/kernel.rb b/mrblib/kernel.rb
index c09755d6c..fd4c86c38 100644
--- a/mrblib/kernel.rb
+++ b/mrblib/kernel.rb
@@ -1,21 +1,33 @@
+##
+# Kernel
 #
-#  Kernel
-#
+# ISO 15.3.1
 module Kernel
-  # 15.3.1.2.6
+
+  ##
+  # Takes the given block, create a lambda
+  # out of it and +call+ it.
+  #
+  # ISO 15.3.1.2.6
   def self.lambda(&block)
     ### *** TODO *** ###
     block  # dummy
   end
 
-  # 15.3.1.2.8
+  ##
+  # Calls the given block repetitively.
+  #
+  # ISO 15.3.1.2.8
   def self.loop #(&block)
     while(true)
       yield
     end
   end
 
-  # 15.3.1.3.4
+  ##
+  # Alias for +send+.
+  #
+  # ISO 15.3.1.3.4
   def __send__(symbol, *args, &block)
     ### *** TODO *** ###
   end
@@ -25,20 +37,31 @@ module Kernel
     ### *** TODO *** ###
   end
 
+  ##
+  # Alias for Kernel.lambda.
+  #
   # 15.3.1.3.27
   def lambda(&block)
     ### *** TODO *** ###
     block # dummy
   end
 
-  # 15.3.1.3.29
+  ##
+  # Alias for Kernel.loop.
+  #
+  # ISO 15.3.1.3.29
   def loop #(&block)
     while(true)
       yield
     end
   end
 
-  # 15.3.1.3.44
+  ##
+  # Invoke the method with the name +symbol+ on
+  # the receiver and pass +args+ and the given
+  # block.
+  #
+  # ISO 15.3.1.3.44
   def send(symbol, *args, &block)
     ### *** TODO *** ###
   end
-- 
cgit v1.2.3