pry-docmore 0.0.1

data/lib/pry-docmore.rb

@@ -0,0 +1,63 @@
+# encoding: utf-8
+require 'pry'
+class Pry
+  class Docmore
+    def self.find_docs pattern
+      path = File.dirname(__FILE__) + '/../pry-docmore.wiki/*.md'
+      input = Dir[path].map do |file_name|
+        if file_name.match pattern
+          item = $1
+          item.sub! '⁄', '/' # Had to use Unicode "Fraction Slash" in filename.
+          [ item, File.read(file_name) ]
+        end
+      end.compact
+      Hash[input]
+    end
+    @DOCS = {
+      'Keyword' => {
+        source: 'ruby source, lex.c, circa line 219',
+        explanations: find_docs(%r/Ruby Keyword: (.+)\.md/)
+      },
+      'Global Variable' => {
+        source: 'Started from: http://www.zenspider.com/Languages/Ruby/QuickRef.html#pre-defined-variables',
+        explanations: find_docs(%r/Ruby Global (\S+)/)
+      },
+    }
+    def self.raw; @DOCS end
+    def self.explain thing
+      @DOCS.each do |label, docs|
+        # TODO: colored label
+        return docs[:explanations][thing] if docs[:explanations].has_key? thing
+      end
+      nil
+    end
+
+    ORIGINAL_SHOW_DOC ||= Pry.commands['show-doc']
+    Pry::Commands.create_command 'show-doc' do
+      description 'Show the documentation for a method/class/keyword/global. Aliases: ?'
+      command_options \
+        :shellwords => false,
+        :keep_retval => false
+      def process arg_string
+        if docmore = Pry::Docmore.explain(arg_string)
+          _pry_.output.puts docmore
+          $/
+        else
+          ORIGINAL_SHOW_DOC.new(context).call_safely(arg_string)
+        end
+      end
+    end
+    Pry::Commands.create_command 'show-docmores' do
+      description 'List keywords and vars covered by pry-docmore'
+      def process
+        Pry::Docmore.raw.each do |label, docs|
+          # Pry needs a general mechanism to columnize things, and when it gets
+          # one, this can use it:
+          _pry_.output.puts "#{label}s".yellow + ': ' +
+            docs[:explanations].keys.join(' ')
+        end
+      end
+    end
+
+  end
+end

data/pry-docmore.wiki/Home.md

@@ -0,0 +1,96 @@
+This is the input for the actual gem.  Edit these, and the next time the gem
+pushes, this info goes with it.
+
+The goal is for this to be an informative set of docs, full of anything you can
+think to add, so don't hold back.
+
+- [Ruby Global $1 (DollarOne)](wiki/Ruby Global $1 (DollarOne\)) | [Ruby Global $2
+  (DollarTwo)](wiki/Ruby Global $2 (DollarTwo\)) | [Ruby Global $3 (DollarThree)](wiki/Ruby Global $3 (DollarThree\)) | [Ruby Global $4 (DollarFour)](wiki/Ruby Global $4 (DollarFour\)) | [Ruby Global $5 (DollarFive)](wiki/Ruby Global $5 (DollarFive\)) | [Ruby Global $6 (DollarSix)](wiki/Ruby Global $6 (DollarSix\)) | [Ruby Global $7 (DollarSeven)](wiki/Ruby Global $7 (DollarSeven\)) | [Ruby Global $8 (DollarEight)](wiki/Ruby Global $8 (DollarEight\)) | [Ruby Global $9 (DollarNine)](wiki/Ruby Global $9 (DollarNine\))
+- [Ruby Global $& (DollarAmpersand)](wiki/Ruby Global $& (DollarAmpersand\))
+- [Ruby Global $@ (DollarAt)](wiki/Ruby Global $@ (DollarAt\))
+- [Ruby Global $` (DollarBacktick)](wiki/Ruby Global $` (DollarBacktick\))
+- [Ruby Global $! (DollarBang)](wiki/Ruby Global $! (DollarBang\))
+- [Ruby Global $= (DollarEquals)](wiki/Ruby Global $= (DollarEquals\))
+- [Ruby Global $+ (DollarPlus)](wiki/Ruby Global $+ (DollarPlus\))
+- [Ruby Global $⁄ (DollarSlash)](wiki/Ruby Global $⁄ (DollarSlash\))
+- [Ruby Global $~ (DollarSquiggle)](wiki/Ruby Global $~ (DollarSquiggle\))
+- [Ruby Global $' (DollarTick)](wiki/Ruby Global $' (DollarTick\))
+- [Ruby Global $KCODE (DollarKCODE)](wiki/Ruby Global $KCODE (DollarKCODE\))
+- [Ruby Global $-K (DollarDashK)](wiki/Ruby Global $-K (DollarDashK\))
+- [Ruby Global $LOADED\_FEATURES (DollarLOADEDUnderscoreFEATURES)](wiki/Ruby Global $LOADED\_FEATURES (DollarLOADEDUnderscoreFEATURES\))
+- [Ruby Global $PROGRAM\_NAME (DollarPROGRAMUnderscoreNAME)](wiki/Ruby Global $PROGRAM\_NAME (DollarPROGRAMUnderscoreNAME\))
+- [Ruby Global $-W (DollarDashW)](wiki/Ruby Global $-W (DollarDashW\))
+- [Ruby Global $\" (DollarQuote)](wiki/Ruby Global $\" (DollarQuote\))
+- [Ruby Global $$ (DollarDollar)](wiki/Ruby Global $$ (DollarDollar\))
+- [Ruby Global $* (DollarStar)](wiki/Ruby Global $* (DollarStar\))
+- [Ruby Global $, (DollarComma)](wiki/Ruby Global $, (DollarComma\))
+- [Ruby Global $-0 (DollarDashZero)](wiki/Ruby Global $-0 (DollarDashZero\))
+- [Ruby Global $-F (DollarDashF)](wiki/Ruby Global $-F (DollarDashF\))
+- [Ruby Global $-I (DollarDashI)](wiki/Ruby Global $-I (DollarDashI\))
+- [Ruby Global $-a (DollarDasha)](wiki/Ruby Global $-a (DollarDasha\))
+- [Ruby Global $-d (DollarDashd)](wiki/Ruby Global $-d (DollarDashd\))
+- [Ruby Global $-i (DollarDashi)](wiki/Ruby Global $-i (DollarDashi\))
+- [Ruby Global $-l (DollarDashl)](wiki/Ruby Global $-l (DollarDashl\))
+- [Ruby Global $-p (DollarDashp)](wiki/Ruby Global $-p (DollarDashp\))
+- [Ruby Global $-v (DollarDashv)](wiki/Ruby Global $-v (DollarDashv\))
+- [Ruby Global $-w (DollarDashw)](wiki/Ruby Global $-w (DollarDashw\))
+- [Ruby Global $. (DollarDot)](wiki/Ruby Global $. (DollarDot\))
+- [Ruby Global $0 (DollarZero)](wiki/Ruby Global $0 (DollarZero\))
+- [Ruby Global $: (DollarColon)](wiki/Ruby Global $: (DollarColon\))
+- [Ruby Global $; (DollarSemicolon)](wiki/Ruby Global $; (DollarSemicolon\))
+- [Ruby Global $< (DollarLessthan)](wiki/Ruby Global $< (DollarLessthan\))
+- [Ruby Global $> (DollarGreaterthan)](wiki/Ruby Global $> (DollarGreaterthan\))
+- [Ruby Global $? (Dollar?)](wiki/Ruby Global $? (Dollar?\))
+- [Ruby Global $DEBUG (DollarDEBUG)](wiki/Ruby Global $DEBUG (DollarDEBUG\))
+- [Ruby Global $FILENAME (DollarFILENAME)](wiki/Ruby Global $FILENAME (DollarFILENAME\))
+- [Ruby Global $LOAD_PATH (DollarLOADUnderscorePATH)](wiki/Ruby Global $LOAD_PATH (DollarLOADUnderscorePATH\))
+- [Ruby Global $VERBOSE (DollarVERBOSE)](wiki/Ruby Global $VERBOSE (DollarVERBOSE\))
+- [Ruby Global $\\ (DollarBackslash)](wiki/Ruby Global $\\ (DollarBackslash\))
+- [Ruby Global $_ (DollarUnderscore)](wiki/Ruby Global $_ (DollarUnderscore\))
+- [Ruby Global $stderr (Dollarstderr)](wiki/Ruby Global $stderr (Dollarstderr\))
+- [Ruby Global $stdin (Dollarstdin)](wiki/Ruby Global $stdin (Dollarstdin\))
+- [Ruby Global $stdout (Dollarstdout)](wiki/Ruby Global $stdout (Dollarstdout\))
+
+…
+
+- [Ruby Keyword: alias](wiki/Ruby Keyword%3A alias)
+- [Ruby Keyword: and](wiki/Ruby Keyword%3A and)
+- [Ruby Keyword: begin](wiki/Ruby Keyword%3A begin)
+- [Ruby Keyword: BEGIN](wiki/Ruby Keyword%3A BEGIN)
+- [Ruby Keyword: break](wiki/Ruby Keyword%3A break)
+- [Ruby Keyword: case](wiki/Ruby Keyword%3A case)
+- [Ruby Keyword: class](wiki/Ruby Keyword%3A class)
+- [Ruby Keyword: defined?](wiki/Ruby Keyword%3A defined?)
+- [Ruby Keyword: def](wiki/Ruby Keyword%3A def)
+- [Ruby Keyword: do](wiki/Ruby Keyword%3A do)
+- [Ruby Keyword: else](wiki/Ruby Keyword%3A else)
+- [Ruby Keyword: elsif](wiki/Ruby Keyword%3A elsif)
+- [Ruby Keyword: \_\_ENCODING\_\_](wiki/Ruby Keyword%3A \_\_ENCODING\_\_)
+- [Ruby Keyword: end](wiki/Ruby Keyword%3A end)
+- [Ruby Keyword: END](wiki/Ruby Keyword%3A END)
+- [Ruby Keyword: ensure](wiki/Ruby Keyword%3A ensure)
+- [Ruby Keyword: false](wiki/Ruby Keyword%3A false)
+- [Ruby Keyword: \_\_FILE\_\_](wiki/Ruby Keyword%3A \_\_FILE\_\_)
+- [Ruby Keyword: for](wiki/Ruby Keyword%3A for)
+- [Ruby Keyword: if](wiki/Ruby Keyword%3A if)
+- [Ruby Keyword: in](wiki/Ruby Keyword%3A in)
+- [Ruby Keyword: \_\_LINE\_\_](wiki/Ruby Keyword%3A \_\_LINE\_\_)
+- [Ruby Keyword: module](wiki/Ruby Keyword%3A module)
+- [Ruby Keyword: next](wiki/Ruby Keyword%3A next)
+- [Ruby Keyword: nil](wiki/Ruby Keyword%3A nil)
+- [Ruby Keyword: not](wiki/Ruby Keyword%3A not)
+- [Ruby Keyword: or](wiki/Ruby Keyword%3A or)
+- [Ruby Keyword: redo](wiki/Ruby Keyword%3A redo)
+- [Ruby Keyword: rescue](wiki/Ruby Keyword%3A rescue)
+- [Ruby Keyword: retry](wiki/Ruby Keyword%3A retry)
+- [Ruby Keyword: return](wiki/Ruby Keyword%3A return)
+- [Ruby Keyword: self](wiki/Ruby Keyword%3A self)
+- [Ruby Keyword: super](wiki/Ruby Keyword%3A super)
+- [Ruby Keyword: then](wiki/Ruby Keyword%3A then)
+- [Ruby Keyword: true](wiki/Ruby Keyword%3A true)
+- [Ruby Keyword: undef](wiki/Ruby Keyword%3A undef)
+- [Ruby Keyword: unless](wiki/Ruby Keyword%3A unless)
+- [Ruby Keyword: until](wiki/Ruby Keyword%3A until)
+- [Ruby Keyword: when](wiki/Ruby Keyword%3A when)
+- [Ruby Keyword: while](wiki/Ruby Keyword%3A while)
+- [Ruby Keyword: yield](wiki/Ruby Keyword%3A yield)

data/pry-docmore.wiki/Ruby Global $! (DollarBang).md

@@ -0,0 +1,15 @@
+The $! global is the Exception set by 'rescue'
+
+This code:
+
+    begin
+      raise 'hi'
+    rescue
+        p $!
+    end
+    p $!
+
+Prints this:
+
+    #<RuntimeError: hi>
+    nil

data/pry-docmore.wiki/Ruby Global $/" (DollarQuote).md"

@@ -0,0 +1,4 @@
+The $" global is the array contains the module names loaded by require.
+
+(Compare to the list of lookup paths in `$LOAD_PATH`, a.k.a `$:`)
+

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

@@ -0,0 +1,12 @@
+The $$ global is the process number of the Ruby running this script.
+
+Can be used for process control tricks, such as recording in a "pidfile" so
+other processes can later kill the current one, or accessing "/proc/#$$" on
+systems (such as Linux) having a mounted procfs.
+
+Traditionally used in shell scripts for a quick way to generate a semi-unique
+temp filename, but this is better achieved like:
+
+    require 'tempfile'
+    t = Tempfile.new 'hi'
+    # produces a file like: /tmp/hi20121119-2774-1buu566 (because $$ == 2774)

data/pry-docmore.wiki/Ruby Global $& (DollarAmpersand).md

@@ -0,0 +1,16 @@
+The $& global is the string matched by the last successful match.
+
+If you do this:
+
+    str = 'hello goodbye'; str[/good/]
+
+Then this:
+
+    [ $`, $&, $' ]
+
+Yields this:
+[
+    "hello ",
+    "good",
+    "bye"
+]

data/pry-docmore.wiki/Ruby Global $' (DollarTick).md

@@ -0,0 +1,16 @@
+The $' global is the string to the right of the last successful match.
+
+If you do this:
+
+    str = 'hello goodbye'; str[/good/]
+
+Then this:
+
+    [ $`, $&, $' ]
+
+Yields this:
+[
+    "hello ",
+    "good",
+    "bye"
+]

data/pry-docmore.wiki/Ruby Global $* (DollarStar).md

@@ -0,0 +1 @@
+The $* global is the ARGV, the command line arguments given for the script.

data/pry-docmore.wiki/Ruby Global $+ (DollarPlus).md

@@ -0,0 +1,9 @@
+The $+ global is the highest group matched by the last successful match.
+
+This:
+
+    str = 'hello goodbye'; str[/he(llo) g(o(od))/]; $+
+
+Shows:
+
+    "od"

data/pry-docmore.wiki/Ruby Global $, (DollarComma).md

@@ -0,0 +1 @@
+The $, global is the output field separator for the print and Array#join.

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

@@ -0,0 +1 @@
+Aliased to $/

data/pry-docmore.wiki/Ruby Global $-F (DollarDashF).md

@@ -0,0 +1 @@
+Aliased to $;

data/pry-docmore.wiki/Ruby Global $-I (DollarDashI).md

@@ -0,0 +1 @@
+Aliased to $:

data/pry-docmore.wiki/Ruby Global $-K (DollarDashK).md

@@ -0,0 +1 @@
+The $-K global ...pry-docmore TODO!

data/pry-docmore.wiki/Ruby Global $-W (DollarDashW).md

@@ -0,0 +1 @@
+The $-W global ...pry-docmore TODO!

data/pry-docmore.wiki/Ruby Global $-a (DollarDasha).md

@@ -0,0 +1 @@
+The $-a global True if option -a is set. Read-only variable.

data/pry-docmore.wiki/Ruby Global $-d (DollarDashd).md

@@ -0,0 +1 @@
+Aliased to $DEBUG

data/pry-docmore.wiki/Ruby Global $-i (DollarDashi).md

@@ -0,0 +1 @@
+The $-i global In in-place-edit mode, this variable holds the extension, otherwise nil.

data/pry-docmore.wiki/Ruby Global $-l (DollarDashl).md

@@ -0,0 +1 @@
+The $-l global True if option -l is set. Read-only variable.

data/pry-docmore.wiki/Ruby Global $-p (DollarDashp).md

@@ -0,0 +1 @@
+The $-p global True if option -p is set. Read-only variable.

data/pry-docmore.wiki/Ruby Global $-v (DollarDashv).md

@@ -0,0 +1 @@
+Aliased to $VERBOSE

data/pry-docmore.wiki/Ruby Global $-w (DollarDashw).md

@@ -0,0 +1 @@
+The $-w global True if option -w is set.

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

@@ -0,0 +1 @@
+The $. global is the current input line number of the last file that was read.

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

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

data/pry-docmore.wiki/Ruby Global $1 (DollarOne).md

@@ -0,0 +1 @@
+The $1 global is the 1st group of the last successful match. May be > 1.

data/pry-docmore.wiki/Ruby Global $2 (DollarTwo).md

@@ -0,0 +1 @@
+The $2 global is the 2nd group of the last successful match. May be > 1.

data/pry-docmore.wiki/Ruby Global $3 (DollarThree).md

@@ -0,0 +1 @@
+The $3 global is the 3rd group of the last successful match. May be > 1.

data/pry-docmore.wiki/Ruby Global $4 (DollarFour).md

@@ -0,0 +1 @@
+The $4 global is the 4th group of the last successful match. May be > 1.

data/pry-docmore.wiki/Ruby Global $5 (DollarFive).md

@@ -0,0 +1 @@
+The $5 global is the 5th group of the last successful match. May be > 1.

data/pry-docmore.wiki/Ruby Global $6 (DollarSix).md

@@ -0,0 +1 @@
+The $6 global is the 6th group of the last successful match. May be > 1.

data/pry-docmore.wiki/Ruby Global $7 (DollarSeven).md

@@ -0,0 +1 @@
+The $7 global is the 7th group of the last successful match. May be > 1.

data/pry-docmore.wiki/Ruby Global $8 (DollarEight).md

@@ -0,0 +1 @@
+The $8 global is the 8th group of the last successful match. May be > 1.

data/pry-docmore.wiki/Ruby Global $9 (DollarNine).md

@@ -0,0 +1 @@
+The $9 global is the 9th group of the last successful match. May be > 1.

data/pry-docmore.wiki/Ruby Global $: (DollarColon).md

@@ -0,0 +1,3 @@
+The $: global Load path for scripts and binary modules by load or require.
+
+(After scripts are loaded, their path will be in `$"`)

data/pry-docmore.wiki/Ruby Global $; (DollarSemicolon).md

@@ -0,0 +1 @@
+The $; global is the separator for String#split (defaults to nil, which splits on whitespace).

data/pry-docmore.wiki/Ruby Global $< (DollarLessthan).md

@@ -0,0 +1 @@
+The $< global is the virtual concatenation file of the files given on command line (or from $stdin if no files were given).

data/pry-docmore.wiki/Ruby Global $= (DollarEquals).md

@@ -0,0 +1,2 @@
+In older versions of Ruby, setting $= allowed case-insensitive comparisons;
+this is now deprecated in favor of using String#casecmp

data/pry-docmore.wiki/Ruby Global $> (DollarGreaterthan).md

@@ -0,0 +1 @@
+The $> global is the default output for print, printf. $stdout by default.

data/pry-docmore.wiki/Ruby Global $? (Dollar?).md

@@ -0,0 +1,11 @@
+The $? global is the process status of the last executed child process.
+
+It is of type Process::Status, which implements the following methods:
+  &  ==  >>  coredump?  exited?  exitstatus  inspect  pid  signaled?  stopped?
+  stopsig  success?  termsig  to_i  to
+
+For example:
+
+  `head /dev/urandom | grep "Alas, poor Yorick! I knew him, Horatio…"`
+  $?.success?
+  # *probably* false

data/pry-docmore.wiki/Ruby Global $@ (DollarAt).md

@@ -0,0 +1,2 @@
+The $@ global holds the Array of backtrace in the format
+"file:line:in `method`" while in a `rescue` block.

data/pry-docmore.wiki/Ruby Global $DEBUG (DollarDEBUG).md

@@ -0,0 +1 @@
+The $DEBUG global is the status of the -d switch.

data/pry-docmore.wiki/Ruby Global $FILENAME (DollarFILENAME).md

@@ -0,0 +1 @@
+The $FILENAME global Current input file from $<. Same as $<.filename.

data/pry-docmore.wiki/Ruby Global $KCODE (DollarKCODE).md

@@ -0,0 +1 @@
+The $KCODE global ...pry-docmore TODO!

data/pry-docmore.wiki/Ruby Global $LOADED_FEATURES (DollarLOADEDUnderscoreFEATURES).md

@@ -0,0 +1 @@
+The $LOADED_FEATURES global ...pry-docmore TODO!

data/pry-docmore.wiki/Ruby Global $LOAD_PATH (DollarLOADUnderscorePATH).md

@@ -0,0 +1 @@
+Aliased to $:

data/pry-docmore.wiki/Ruby Global $PROGRAM_NAME (DollarPROGRAMUnderscoreNAME).md

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

data/pry-docmore.wiki/Ruby Global $SAFE (DollarSAFE).md

@@ -0,0 +1,4 @@
+This variable determines the "level of paranoia", restricting the set of legal
+operations.
+
+@see: http://www.ruby-doc.org/docs/ProgrammingRuby/html/taint.html

data/pry-docmore.wiki/Ruby Global $VERBOSE (DollarVERBOSE).md

@@ -0,0 +1 @@
+The $VERBOSE global is the verbose flag, which is set by the -v switch.

data/pry-docmore.wiki/Ruby Global $// (DollarBackslash).md"

@@ -0,0 +1 @@
+The $\ global is the output record separator for the print and IO#write. Default is nil.

data/pry-docmore.wiki/Ruby Global $_ (DollarUnderscore).md

@@ -0,0 +1 @@
+The $_ global is the last input line of string by gets or readline.

data/pry-docmore.wiki/Ruby Global $` (DollarBacktick).md

@@ -0,0 +1,16 @@
+The $` global is the string to the left of the last successful match.
+
+If you do this:
+
+    str = 'hello goodbye'; str[/good/]
+
+Then this:
+
+    [ $`, $&, $' ]
+
+Yields this:
+[
+    "hello ",
+    "good",
+    "bye"
+]

data/pry-docmore.wiki/Ruby Global $stderr (Dollarstderr).md

@@ -0,0 +1 @@
+The $stderr global is the current standard error output.

data/pry-docmore.wiki/Ruby Global $stdin (Dollarstdin).md

@@ -0,0 +1 @@
+The $stdin global is the current standard input.

data/pry-docmore.wiki/Ruby Global $stdout (Dollarstdout).md

@@ -0,0 +1 @@
+The $stdout global is the current standard output.

data/pry-docmore.wiki/Ruby Global $~ (DollarSquiggle).md

@@ -0,0 +1 @@
+The $~ global is the match-data about the last match in the current scope.

data/pry-docmore.wiki/Ruby Global $/342/201/204 (DollarSlash).md"

@@ -0,0 +1,3 @@
+The $/ global is the input record separator, newline by default.
+
+This affects String#each_lines, String#lines, and String#chomp

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

@@ -0,0 +1,14 @@
+Like Perl and Awk before that, defines a block to be run before the others:
+
+    p 3
+    BEGIN { p 1 }
+    p 4
+    BEGIN { p 2 }
+    # …prints these out as 1, 2, 3, 4
+
+This works because the whole file gets parsed at the beginning (even though
+'class' and 'def' lines are not executed early), so the interpreter can reorder
+these statements.
+
+See also: `END`
+(Not to be confused with lower-case `begin`)

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

@@ -0,0 +1,10 @@
+Like Perl and Awk before that, defines a block to be run after the others:
+
+    p 1
+    END { p 4 }
+    p 2
+    END { p 3 }
+    # …prints these out as 1, 2, 3, 4
+
+See also: `BEGIN`
+(Not to be confused with lower-case `end`)

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

@@ -0,0 +1,8 @@
+Read-only value of the current Encoding object (which has methods:
+ascii_compatible?  dummy?  inspect  name  names  replicate  to_s)
+
+By default is: #<Encoding:US-ASCII>
+
+But can be affected by the 1st or 2nd line of the file being something like:
+
+# encoding: utf-8

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

@@ -0,0 +1,5 @@
+The filename of the code being evaluated. Evaluates to "(pry)" within the REPL.
+
+Useful especially for code to locate parts nearby, such as:
+
+    File.dirname(__FILE__)

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

@@ -0,0 +1,12 @@
+The code's current line number. Can be a handy way to pepper what would
+otherwise be `print "Got here 1"` statements in your code, e.g.:
+
+    if a
+        p __LINE__
+        # some stuff
+    else
+        p __LINE__
+        # some other stuff
+    end
+
+…but you use the pry-debugger gem instead, don't you?

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

@@ -0,0 +1,35 @@
+The alias keyword is used to make synonyms of methods.
+
+  If you are used to the semantics of the `/bin/ln` command, get it out of your
+  head right now: Ruby does the opposite. That is, instead of `ln existing
+  new`, Ruby's semantics are `alias new existing`. (Mnested Mnemonic: this `new`
+  sorting is the b`a`-`n`-`e` of my `exist`ence.)
+
+  Also take particular note that this is not a method call, but a keyword, so
+  it can do things method calls cannot. The args are not :symbols (though they
+  are permitted to be), and it is a SyntaxError to attempt to place a comma
+  between the args.
+
+  Note that, this being a keyword and happening at compile-time, is not enough
+  to make dynamic assignments. See {Module#alias_method} for that kind of
+  trickery.
+
+@example Basic Usage
+  def foo; 3 end
+  alias boo foo
+  boo
+  ⇒ 3
+@example Symbols as args
+  alias :zoo :boo # or even mix and match, if you want to for some reason.
+  zoo
+  ⇒ 3
+@example Some decorating!
+  alias orig_foo foo
+  def foo; 4 + orig_foo end
+  foo
+  ⇒ 7
+  # See also Rails's alias_method_chain for a formalization of this idiom.
+@param [unadorned symbol] New name
+@param [unadorned symbol] Existing name
+@return [NilClass] nil
+@see http://kresimirbojcic.com/2011/12/01/decorators-in-ruby.html

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

@@ -0,0 +1,23 @@
+Boolean conjunction.
+
+  Only evaluates to `true` if both its left and right side are true.
+
+  Remember that the 'and' operator is lower precedence operator than '&&', so
+
+  an_expression and another_expression
+    is roughly equivalent to:
+  (an_expression) && (another_expression)
+
+@example Truth table
+  true  and true  ⇒ true
+  false and true  ⇒ false
+  false and false ⇒ false
+@example Precedence
+  true and not false ⇒ true
+  true && not false ⇒ SyntaxError
+  a = true and false; a ⇒ true
+  a = true && false; a ⇒ false
+@example The fowl chain
+  if false or true && false then false elsif true and false or true then true end
+  ⇒ true
+@see http://phrogz.net/ProgrammingRuby/language.html#table_18.4

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

@@ -0,0 +1,24 @@
+Opens a block when `def` or `do` isn't already opening one for you.
+
+Uses include:
+
+    begin
+      1/0
+    rescue => e
+      p e
+    else
+      puts 'Cannot get here with that 1/0'
+    ensure
+      puts 'OK then.'
+    end
+
+Or something like:
+
+    x = something_falsy || begin
+      several_steps
+      go_here
+      3
+    end
+    # Now x == 3
+
+(Not to be confused with the BEGIN keyword.)

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

@@ -0,0 +1,16 @@
+Hops out of the inner-most loop. Like this:
+
+    %w(a b c).each do |i|
+      print i
+      32343.times do |j|
+        break if j > 2
+        print j
+      end
+    end
+    puts
+
+Prints:
+
+    a012b012c012
+
+Compare with: next, last

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

@@ -0,0 +1,23 @@
+A convenient conditional that doesn't require the "subject" to be repeated.
+
+Uses #=== for comparison ("the threequals"), which is defined specially for
+various objects.
+
+    x = 'asdf'
+    case x
+    when 'asdf'; puts 'Found it!'
+    when 'fghj'; puts 'Impossible.'
+    else puts 'Also impossible.'
+    end
+
+    case x
+    when String; puts 'Yep, will get here.'
+    when Array; puts 'Actually, wait a minute.'
+    when Hash; puts 'This is pretty bad OO.'
+    else puts 'But, the code works'
+    end
+
+    case x
+    when /^[fdsa]{4}/; puts 'Whoa, works with regexes.'
+    else puts 'Will not get here.'
+    end

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

@@ -0,0 +1,4 @@
+- Opens a class definition
+- class << self ← Opens the eigenclass of 'self'
+
+TODO - https://github.com/rking/pry-docmore/wiki