pry-docmore 0.0.3 → 0.0.4

data/pry-docmore.wiki/Ruby Global $0 (DollarZero).md

@@ -1 +1,2 @@
-The $0 global Same as $PROGRAM_NAME. Contains the name of the script being executed. May be assignable.
+The $0 global contains the name of the script being executed. May be assignable.
+Alias: $PROGRAM_NAME

data/pry-docmore.wiki/Ruby Keyword: defined?.md

@@ -2,12 +2,28 @@
     defined? self ⇒ "self"
     defined? true ⇒ "true"
     defined? false ⇒ "false"
-    # ____ ⇒ "expression"
+    defined? "asdf" ⇒ "expression"
+    defined? a = 3 ⇒ "assignment" # but doesn't actually set a to 3.
     defined? printf ⇒ "method"
     printf = 3
-    defined? printf ⇒ "local-variable"
-    defined? a = 3 ⇒ "assignment" # but doesn't actually set a to 3.
+    defined? printf ⇒ "local-variable" # nil if there is no local or method with that name
+    defined? $foo ⇒ "global-variable"  # nil if $foo has not been assigned to
+    defined? Object ⇒ "constant"       # nil if there is no constant with that name
+    defined? super ⇒ "super"           # nil if there is no super method.
+    defined? yield ⇒ "yield"           # nil if no block was passed to this method
+
+defined? is most often used to determine whether a constant or global variable is defined. For example ruby-1.8.7 didn't have a RUBY_ENGINE constant, so jruby was often detected using:
+
+    defined?(RUBY_ENGINE) && RUBY_ENGINE == "jruby"
+
+Another idiomatic use is to safely call a super-method:
+
+    super if defined?(super)
+
+It can be used to detect whether a block was passed to this method, though `block_given?` is usually preferred.
+
+    yield if defined?(yield)
 
-What the heck is this thing good for?
+Although the return value of `defined?` is a string, this is usually ignored and only the truthiness of the result considered.
 
-Please answer at: https://github.com/rking/pry-docmore/wiki
+Improve these docs at https://github.com/rking/pry-docmore/wiki

data/pry-docmore.wiki/Ruby Keyword: module.md

@@ -24,7 +24,8 @@ hand, classes can be instantiated, where modules cannot).
     # Now, these work:
     Y.new.foo
     Z.foo
-    # Mnemonic! INclude for INstances, Extend for sElf
+    # "extend just calls include on the eigenclass"
+    #   Mnemonic! INclude for INstances, Extend for sElf
 
 For all you ever wanted to know about constant lookup, see:
 http://cirw.in/blog/constant-lookup

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pry-docmore
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.0.4
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-12-22 00:00:00.000000000 Z
+date: 2013-01-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pry