* ext/fiddle/*: [DOC] More doc on dlopen and RTLD_DEFAULT from r42186

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

ChangeLog

@@ -1,3 +1,7 @@
+Fri Jul 26 14:05:19 2013  Zachary Scott  <e@zzak.io>
+
+	* ext/fiddle/*: [DOC] More doc on dlopen and RTLD_DEFAULT from r42186
+
 Fri Jul 26 13:08:53 2013  Zachary Scott  <e@zzak.io>
 
 	* ext/fiddle/lib/fiddle.rb: [DOC] Document Fiddle.dlopen(nil)

ext/fiddle/handle.c

@@ -117,11 +117,14 @@ predefined_fiddle_handle(void *handle)
  *
  * Create a new handler that opens +library+ with +flags+.
  *
- * If no +library+ is specified or +nil+ is given, RTLD_DEFAULT is used, which
- * usually means +libc+.
+ * If no +library+ is specified or +nil+ is given, DEFAULT is used, which is
+ * the equivalent to RTLD_DEFAULT. See <code>man 3 dlopen</code> for more.
  *
- *	libc = Fiddle::Handle.new
+ *	lib = Fiddle::Handle.new
  *
+ * The default is dependent on OS, and provide a handle for all libraries
+ * already loaded. For example, in most cases you can use this to access +libc+
+ * functions, or ruby functions like +rb_str_new+.
  */
 static VALUE
 rb_fiddle_handle_initialize(int argc, VALUE argv[], VALUE self)

ext/fiddle/lib/fiddle.rb

@@ -33,9 +33,13 @@ module Fiddle
   # Fiddle::Handle.
   #
   # If +nil+ is given for the +library+, Fiddle::Handle::DEFAULT is used, which
-  # usually means +libc+.
+  # is the equivalent to RTLD_DEFAULT. See <code>man 3 dlopen</code> for more.
   #
-  #   libc = Fiddle.dlopen(nil)
+  #   lib = Fiddle.dlopen(nil)
+  #
+  # The default is dependent on OS, and provide a handle for all libraries
+  # already loaded. For example, in most cases you can use this to access
+  # +libc+ functions, or ruby functions like +rb_str_new+.
   #
   # See Fiddle::Handle.new for more.
   def dlopen library