summaryrefslogtreecommitdiff
path: root/ext/fiddle
diff options
context:
space:
mode:
Diffstat (limited to 'ext/fiddle')
-rw-r--r--ext/fiddle/handle.c9
-rw-r--r--ext/fiddle/lib/fiddle.rb8
2 files changed, 12 insertions, 5 deletions
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