pry-docmore 0.0.2 → 0.0.3

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

@@ -13,4 +13,10 @@ Prints:
 
     a012b012c012
 
+Also note that the keyword accepts an argument:
+
+    x = loop do break 3 end
+    p x
+    # ⇒ 3
+
 Compare with: next, last

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

@@ -1,3 +1,30 @@
-Defines a Module, which is like a Class but can never be instantiated.
+Usage: module ModuleName; module-contents end
 
-TODO - https://github.com/rking/pry-docmore/wiki
+Defines a new Module, or re-opens an existing module. Modules in ruby are
+collections of code, they have two distinct use-cases:
+
+1. As a Namespace. Often all of the code in a rubygem will be written in the
+same module to avoid naming collisions with code not in that Gem.
+
+2. As a set of shared functions. Modules can be included into Classes, which
+makes all of the methods defined in the module available to instances of the
+class. This can be used to emulate multiple-inheritance, or to divide one large
+class into more manageable chunks.
+
+Note that, though the class `Class` inherits from `Module`, this is more of an
+implementation detail than a direct, Liskov-substitutable interface: modules
+can be `include`d, `extend`ed or `using`d, while classes cannot. (On the other
+hand, classes can be instantiated, where modules cannot).
+
+    module X
+      def foo; 2 end
+    end
+    class Y; include X end
+    class Z; extend X end
+    # Now, these work:
+    Y.new.foo
+    Z.foo
+    # 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.2
+  version: 0.0.3
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-11-19 00:00:00.000000000 Z
+date: 2012-12-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pry