pry-docmore 0.0.4 → 0.1.0

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

@@ -1,22 +0,0 @@
-Boolean disjunction.
-
-  Evaluates to true if either its left or right side are true.
-
-    Remember that the 'or' operator is lower precedence operator than '||', so
-
-  an_expression or another_expression
-    is roughly equivalent to:
-  (an_expression) || (another_expression)
-
-Truth table
-
-  true  or true  ⇒ true
-  false or true  ⇒ true
-  false or false ⇒ false
-
-Precedence
-
-  true or false ? 'yes' : 'no' ⇒ true
-  true || false ? 'yes' : 'no' ⇒ "yes"
-
-See http://phrogz.net/ProgrammingRuby/language.html#table_18.4

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

@@ -1,16 +0,0 @@
-Jump back to the top of the inner-most block. E.g.:
-
-    2.times do |i|
-      3.times do |j|
-        print i,j
-        j += 1
-        redo if 1 == j
-      end
-    end
-    puts
-
-Prints:
-
-    0001010210111112
-
-# TODO: Pick a better example

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

@@ -1,55 +0,0 @@
-Catch exceptions.
-
-Usage:
-
-    begin
-      1/0
-    rescue => e
-      puts "No division by zero ever bothered me."
-    end
-
-Or
-
-    def foo
-      1/0
-    rescue
-      puts "Yep, works on 'def's, too."
-    end
-
-This is the basic exception heirarchy:
-
-   Exception
-    NoMemoryError
-    ScriptError:
-      LoadError
-      NotImplementedError
-      SyntaxError
-    SignalException
-      Interrupt
-    StandardError
-      ArgumentError
-      IOError
-        EOFError
-      IndexError
-      LocalJumpError
-      NameError
-        NoMethodError
-      RangeError
-        FloatDomainError
-      RegexpError
-      RuntimeError
-      SecurityError
-      SystemCallError
-      SystemStackError
-      ThreadError
-      TypeError
-      ZeroDivisionError
-    SystemExit
-    fatal
-
-More in Avdi Grimm's book, Exceptional Ruby: http://pragprog.com/book/ager/exceptional-ruby
-# TODO:
-#   Explain the args syntax
-#   Talk about Standard
-
-See: ensure, else, retry

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

@@ -1,20 +0,0 @@
-Re-run the block that raised an Exception.
-
-For example:
-
-    tries = 3
-    begin
-      puts "Try ##{tries}."
-      1/0
-    rescue => e
-      tries -= 1
-      retry unless tries.zero?
-    end
-
-This will output:
-
-    Try #3.
-    Try #2.
-    Try #1.
-
-See also: begin, rescue, else, ensure

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

@@ -1,38 +0,0 @@
-Leave the current method, making the given value.
-
-Keep in mind that the last statement in a Ruby method is its implied value, so
-these are equivalent:
-
-    def f x
-      if 0 == x % 3
-        return true
-      else
-        return false
-      end
-    end
-
-    def f x
-      if 0 == x % 3
-        true
-      else
-        false
-      end
-    end
-
-…but, then, you might as well go all the way with it, as this is equivalent:
-
-    def f x
-      0 == x % 3
-    end
-
-So, usually, it's only useful as an "early return" in Ruby, such as:
-
-    return if arg > 3
-    # rest of method here
-
-Note that you can return out of lambdas but not proc's, e.g.:
-
-    -> { return 3 }.()
-    # ⇒ 3
-    proc { return 3 }.()
-    # ⇒ LocalJumpError: unexpected return

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

@@ -1,15 +0,0 @@
-An ever-present variable in Ruby. At the very top level, it is the "(main)"
-self, but everywhere else its value is very important to know.
-
-Within a method, it is the instance that received the method.
-
-Within a class defintion, it is the class itself. This explains why:
-
-    class Foo
-      def self.hi; 'hi' end # this is equivalent to:
-      def Foo.hi; 'hi' end # this.
-    end
-
-# TODO:
-#  Explain eigenclasses
-#  …?

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

@@ -1,34 +0,0 @@
-Call the current method, but using the superclass's implementation. Can be
-useful so that subclasses can 'decorate' their parent class's functionality.
-
-A subtle syntax issue is that, when this is called with no arguments, all
-arguments are passed up.
-
-For example:
-
-    class Dad
-      def f *args; p args end
-    end
-    class Kid < Dad
-      def f *args; super end
-    end
-    Kid.new.f 1, 2
-
-Outputs:
-
-    [1, 2]
-
-The way to stop this behavior is to use something Ruby almost never requires:
-empty parens:
-
-    class Dad
-      def f *args; p args end
-    end
-    class Kid < Dad
-      def f *args; super() end
-    end
-    Kid.new.f 1, 2
-
-Outputs:
-
-    []

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

@@ -1,17 +0,0 @@
-A keyword that is generally needless. For example, these all work:
-
-    if 3 then
-      puts 'hi'
-    end
-    if 3
-      puts 'hi'
-    end
-
-    if 3 then 'yes' else 'no' end
-    if 3; 'yes' else 'no' end
-    3 ? 'yes' : 'no'
-
-    case x
-    when 3 then puts 'yo' end
-    when 4; puts 'yo' end
-    end

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

@@ -1,7 +0,0 @@
-not false.  Everything in Ruby (except `false` and `nil`) are true.
-
-    if 0
-      puts "Ruby."
-    else
-      puts "Perl."
-    end

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

@@ -1,5 +0,0 @@
-Opposite of `def` — removes a method definition.
-
-   def foo; end
-   undef foo
-   foo ⇒ NameError: undefined local variable or method `foo' for main:Object`

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

@@ -1,4 +0,0 @@
-Equivalent to `if not`, but with very clear precedence. Especially popular in
-the "Yoda if" form:
-
-    fail "Oh no!" unless valid?

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

@@ -1,6 +0,0 @@
-Negated `while`.
-
-    puts 'Guess a letter.'
-    until 'y' == $stdin.readline.chomp
-      puts 'Guess again.'
-    end

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

@@ -1 +0,0 @@
-Specific condition of a `case` statement. (See: case)

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

@@ -1,6 +0,0 @@
-Loop as long as the condition holds.
-
-   puts 'Guess a letter.'
-   while 'y' == $stdin.readline.chomp
-     puts 'Anything but that one.'
-   end

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

@@ -1,16 +0,0 @@
-Run the block passed to a method.
-
-    def foo
-      p 1
-      yield 2
-      p 3
-    end
-    foo do |i|
-      p i
-    end
-
-Prints:
-
-    1
-    2
-    3