From 6bb201d6d1d44ac2c376a20125caf4be849579df Mon Sep 17 00:00:00 2001
From: zzak <zzak@b2dd03c8-39d4-4d8f-98ff-823fe69b080e>
Date: Fri, 26 Jul 2013 05:06:57 +0000
Subject: * 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                | 4 ++++
 ext/fiddle/handle.c      | 9 ++++++---
 ext/fiddle/lib/fiddle.rb | 8 ++++++--
 3 files changed, 16 insertions(+), 5 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 495b89b0c4..81189fd8e3 100644
--- a/ChangeLog
+++ b/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)
diff --git a/ext/fiddle/handle.c b/ext/fiddle/handle.c
index 357ff0510c..330dbafe67 100644
--- a/ext/fiddle/handle.c
+++ b/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)
diff --git a/ext/fiddle/lib/fiddle.rb b/ext/fiddle/lib/fiddle.rb
index 3a9b5d5bff..ae6e299637 100644
--- a/ext/fiddle/lib/fiddle.rb
+++ b/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
-- 
cgit v1.2.3