* lib/rexml/functions.rb: Add some documentation for REXML::Functions.

	  Patch by Sebastian Martinez.  [Ruby 1.9 - Feature #4688]


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

ChangeLog

@@ -1,3 +1,8 @@
+Sat May 14 02:54:04 2011  Eric Hodel  <drbrain@segment7.net>
+
+	* lib/rexml/functions.rb:  Add some documentation for REXML::Functions.
+	  Patch by Sebastian Martinez.  [Ruby 1.9 - Feature #4688]
+
 Sat May 14 02:51:42 2011  Eric Hodel  <drbrain@segment7.net>
 
 	* lib/resolv.rb:  Hide private method and state-tracking constants from

lib/rexml/functions.rb

@@ -28,6 +28,7 @@ def Functions::text( )
       end
     end
 
+    # Returns the last node of the given list of nodes.
     def Functions::last( )
       @@context[:size]
     end
@@ -36,6 +37,7 @@ def Functions::position( )
       @@context[:index]
     end
 
+    # Returns the size of the given list of nodes.
     def Functions::count( node_set )
       node_set.size
     end
@@ -129,6 +131,11 @@ def Functions::string( object=nil )
       end
     end
 
+    # A node-set is converted to a string by
+    # returning the concatenation of the string-value
+    # of each of the children of the node in the
+    # node-set that is first in document order.
+    # If the node-set is empty, an empty string is returned.
     def Functions::string_value( o )
       rv = ""
       o.children.each { |e|