Commits

Lynn Rees committed 4b52d0a Merge
  • Participants
  • Parent commits a7ecd19, 2960ac9
  • Branches maint

Comments (0)

Files changed (67)

 What's new in 0.5.2
 ===================
 
-* verify Python 3.1 compatibility
+* verify PyPy 1.8, Python 3.1 compatibility
 * made randomizing methods lazier
-* memoize some routines
+* memoize some routines

File MANIFEST

-LICENSE.txt
-MANIFEST.in
-README.rst
-requirements.txt
-setup.cfg
-setup.py
-knife/__init__.py
-knife/_active.py
-knife/_base.py
-knife/_compat.py
-knife/_kbase.py
-knife/_kmixins.py
-knife/_lazy.py
-knife/_mixins.py
-knife/active.py
-knife/base.py
-knife/lazy.py
-knife/mixins.py
-knife/tests/__init__.py
-knife/tests/mixins.py
-knife/tests/test_active.py
-knife/tests/test_lazy.py
 `knife` is a powerful `Python <http://docs.python.org/>`_ multitool
-loosely inspired by `underscore.js <http://documentcloud.github.com/underscore/>`_
+loosely inspired by `Underscore.js <http://documentcloud.github.com/underscore/>`_
 but remixed for maximum `pythonicity <http://docs.python.org/glossary.html#term-pythonic>`_. 
 
 `knife` concentrates power that is normally dispersed across the entire
 Vitals
 ======
 
-`knife` works with Python 2.6, 2.7, and 3.2.
+`knife` works with CPython 2.6, 2.7, 3.1. and 3.2 and PyPy 1.8.
 
 `knife` documentation is at http://readthedocs.org/docs/knife/en/latest/ or
 http://packages.python.org/knife/
   >>> oo.get()
   3
   
-`knife` can roll its current state back to a previous state such as the results
-of the immediately preceding steps, a baseline snapshot, or even the original
-arguments.
+A `knife` object can roll its current state back to previous states
+like snapshots of immediately preceding operations, a baseline snapshot, or even 
+a snapshot of the original arguments.
 
 contrived example:
 ^^^^^^^^^^^^^^^^^^
   >>> undone.original().peek()
   [1, 2, 3]
 
-`knife` knives come in two flavors: `active` and `lazy`. Active
-knives evaluate the result of each method immediately it's called. Calling the
-same method with a lazy knife only generate results when they are iterated over
+`knife` objects come in two flavors: `active` and `lazy`.
+`active.knife` objects evaluate the result of calling a
+method immediately after the call. Calling the same method with
+a `lazy.knife` object only yields results when it is iterated over
 or `knife.lazy.lazyknife.get` is called to get results.
   
 `knife.lazy.lazyknife` combines all `knife` methods in one class:
   >>> from knife import knife
 
 `knife` methods are available in more focused classes that group related 
-methods together. These can also be chained into pipelines.
+methods together. These classes can also be chained into pipelines.
 
 contrived example:
 ^^^^^^^^^^^^^^^^^^
   1000
   >>> one.original().minmax().pipe(two).merge().back().sum().get()
   1002
-  
-  
+
 What's new in 0.5.2
 ===================
 
-* verify Python 3.1 compatibility
+* verify PyPy 1.8, CPython 3.1 compatibility
 * made randomizing methods lazier
 * memoize some routines

File dev_requirements.txt

+stuf>=0.8.14
+parse>=1.4.1
+tox
+sphinx
+sphinxcontrib.spelling
+Sphinx-PyPI-upload
+Fabric
+hg-github

File docs/_build/doctest/output.txt

-Results of doctest builder run on 2012-04-24 22:14:48
+Results of doctest builder run on 2012-04-27 18:00:05
 =====================================================
 
 Document: index

File docs/_build/doctrees/acmpknife.doctree

Binary file modified.

File docs/_build/doctrees/activeknife.doctree

Binary file modified.

File docs/_build/doctrees/afilterknife.doctree

Binary file modified.

File docs/_build/doctrees/amapknife.doctree

Binary file modified.

File docs/_build/doctrees/amathknife.doctree

Binary file modified.

File docs/_build/doctrees/aorderknife.doctree

Binary file modified.

File docs/_build/doctrees/areduceknife.doctree

Binary file modified.

File docs/_build/doctrees/arepeatknife.doctree

Binary file modified.

File docs/_build/doctrees/asliceknife.doctree

Binary file modified.

File docs/_build/doctrees/environment.pickle

Binary file modified.

File docs/_build/doctrees/index.doctree

Binary file modified.

File docs/_build/doctrees/lazyknife.doctree

Binary file modified.

File docs/_build/doctrees/lcmpknife.doctree

Binary file modified.

File docs/_build/doctrees/lfilterknife.doctree

Binary file modified.

File docs/_build/doctrees/lmapknife.doctree

Binary file modified.

File docs/_build/doctrees/lmathknife.doctree

Binary file modified.

File docs/_build/doctrees/lorderknife.doctree

Binary file modified.

File docs/_build/doctrees/lreduceknife.doctree

Binary file modified.

File docs/_build/doctrees/lrepeatknife.doctree

Binary file modified.

File docs/_build/doctrees/lsliceknife.doctree

Binary file modified.

File docs/_build/html/_sources/index.txt

 #####################
 
 :mod:`knife` is a powerful `Python <http://docs.python.org/>`_ multitool
-loosely inspired by `underscore.js <http://documentcloud.github.com/underscore/>`_
+loosely inspired by `Underscore.js <http://documentcloud.github.com/underscore/>`_
 but remixed for maximum `pythonicity <http://docs.python.org/glossary.html#term-pythonic>`_. 
 
 :mod:`knife` concentrates power that is normally dispersed across the entire Python
 Vitals
 ======
 
-:mod:`knife` works with Python 2.6, 2.7, and 3.2.
+:mod:`knife` works with CPython 2.6, 2.7, 3.1. and 3.2 and PyPy 1.8.
 
-mod:`knife` documentation is at http://readthedocs.org/docs/knife/en/latest/ or
+:mod:`knife` documentation is at http://readthedocs.org/docs/knife/en/latest/ or
 http://packages.python.org/knife/
 
 Installation
 Slightly more *knife*
 =====================
 
-:mod:`knife` has 40 plus methods that can be `chained <https://en.wikipedia.org/
+:mod:`knife` has 40 plus :term:`method`\s that can be `chained <https://en.wikipedia.org/
 wiki/Fluent_interface>`_ into pipelines.
 
 contrived example:
   >>> __(5, 4, 3, 2, 1).initial().rest().slice(1, 2).last().get()
   3
 
-Or used object-oriented style.
+Or used :term:`object`\-oriented style.
 
 contrived example:
 ^^^^^^^^^^^^^^^^^^
   >>> oo.get()
   3
   
-:mod:`knife` can roll its current state back to a previous state such as the results
-of the immediately preceding steps, a baseline snapshot, or even the original
-arguments.
+A :mod:`knife` :term:`object` can roll its current state back to previous states
+like snapshots of immediately preceding operations, a baseline snapshot, or even 
+a snapshot of the original arguments.
 
 contrived example:
 ^^^^^^^^^^^^^^^^^^
   >>> undone.original().peek()
   [1, 2, 3]
 
-:mod:`knife` knives come in two flavors: :mod:`active` and :mod:`lazy`. Active
-knives evaluate the result of each method immediately it's called. Calling the
-same method with a lazy knife only generate results when they are iterated over
+:mod:`knife` knives come in two flavors: :mod:`active` and :mod:`lazy`.
+:mod:`active.knife` :term:`object`\s evaluate the result of calling a
+:term:`method` immediately after the call. Calling the same :term:`method` with
+a :mod:`lazy.knife` :term:`object` only yields results when it is iterated over
 or :meth:`knife.lazy.lazyknife.get` is called to get results.
   
 :class:`knife.lazy.lazyknife` combines all :mod:`knife` methods in one
   >>> from knife import __  
   
 :class:`knife.active.activeknife` also combines every :mod:`knife` method in one
-combo :mod:`knife` class:
+combo :mod:`knife` :term:`class`:
 
   >>> from knife import activeknife
 
  
   >>> from knife import knife
 
-:mod:`knife` methods are available in more focused classes that group related 
-methods together. These can also be chained into pipelines.
+:mod:`knife` :term:`method`\s are available in more focused :term:`class`\es
+that group related :term:`method`\s together. These :term:`class`\es can also be
+chained together into pipelines.
 
 contrived example:
 ^^^^^^^^^^^^^^^^^^
   >>> one.original().minmax().pipe(two).merge().back().sum().get()
   1002
 
+What's new in 0.5.2
+===================
+
+* verify PyPy 1.8, CPython 3.1 compatibility
+* made randomizing methods lazier
+* memoize some routines
+
 Lazy knives
 ===========
 
 
 * :ref:`genindex`
 * :ref:`modindex`
-* :ref:`search`
-
+* :ref:`search`

File docs/_build/html/acmpknife.html

 <dl class="class">
 <dt id="knife.active.cmpknife">
 <em class="property">class </em><tt class="descclassname">knife.active.</tt><tt class="descname">cmpknife</tt><big>(</big><em>*things</em>, <em>**kw</em><big>)</big><a class="headerlink" href="#knife.active.cmpknife" title="Permalink to this definition">¶</a></dt>
-<dd><p>Actively evaluated comparing knife.</p>
-<p>Comparison operations for incoming things.</p>
+<dd><p>Actively evaluated comparing knife. Provides comparison operations for
+incoming things.</p>
 <div class="highlight-python"><div class="highlight"><pre><span class="gp">&gt;&gt;&gt; </span><span class="kn">from</span> <span class="nn">knife.active</span> <span class="kn">import</span> <span class="n">cmpknife</span>
 </pre></div>
 </div>
 <dl class="method">
 <dt id="knife.active.cmpknife.__init__">
 <tt class="descname">__init__</tt><big>(</big><em>*things</em>, <em>snapshots=5</em><big>)</big><a class="headerlink" href="#knife.active.cmpknife.__init__" title="Permalink to this definition">¶</a></dt>
-<dd><p>Initialize <tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt>.</p>
-<table class="docutils field-list" frame="void" rules="none">
+<dd><table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
 <dl class="method">
 <dt id="knife.active.cmpknife.all">
 <tt class="descname">all</tt><big>(</big><big>)</big><a class="headerlink" href="#knife.active.cmpknife.all" title="Permalink to this definition">¶</a></dt>
-<dd><p>Discover if <a class="reference internal" href="#knife.active.cmpknife.worker" title="knife.active.cmpknife.worker"><tt class="xref py py-meth docutils literal"><span class="pre">worker()</span></tt></a> is <tt class="xref py py-const docutils literal"><span class="pre">True</span></tt> for <strong>every</strong> incoming
-thing.</p>
+<dd><p>Discover if <a class="reference internal" href="#knife.active.cmpknife.worker" title="knife.active.cmpknife.worker"><tt class="xref py py-meth docutils literal"><span class="pre">worker</span></tt></a> is <a class="reference external" href="http://docs.python.org/2.7/library/constants.html#True" title="(in Python v2.7)"><tt class="xref py py-data docutils literal"><span class="pre">True</span></tt></a> for <strong>all</strong> incoming things.</p>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</td>
+<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body"><a class="reference external" href="http://docs.python.org/2.7/library/functions.html#bool" title="(in Python v2.7)"><tt class="xref py py-func docutils literal"><span class="pre">bool</span></tt></a></td>
+</tr>
+<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
 </tbody>
 </table>
 <span class="go">True</span>
 </pre></div>
 </div>
+<div class="admonition-see-also admonition seealso">
+<p class="first admonition-title">See also</p>
+<dl class="last docutils">
+<dt><a class="reference internal" href="#knife.active.cmpknife.all" title="knife.active.cmpknife.all"><tt class="xref py py-func docutils literal"><span class="pre">all</span></tt></a></dt>
+<dd>function in Python standard library</dd>
+<dt><a class="reference external" href="http://documentcloud.github.com/underscore/#all">all</a></dt>
+<dd>function in Underscore.js</dd>
+<dt><a class="reference external" href="http://mirven.github.com/underscore.lua/#all">all</a></dt>
+<dd>function in Underscore.lua</dd>
+<dt><a class="reference external" href="http://vti.github.com/underscore-perl/#all">all</a></dt>
+<dd>function in Underscore.perl</dd>
+<dt><a class="reference external" href="http://brianhaveri.github.com/Underscore.php/#all">all</a></dt>
+<dd>function in Underscore.php</dd>
+</dl>
+</div>
 </dd></dl>
 
 <dl class="method">
 <dt id="knife.active.cmpknife.any">
 <tt class="descname">any</tt><big>(</big><big>)</big><a class="headerlink" href="#knife.active.cmpknife.any" title="Permalink to this definition">¶</a></dt>
-<dd><p>Discover if <a class="reference internal" href="#knife.active.cmpknife.worker" title="knife.active.cmpknife.worker"><tt class="xref py py-meth docutils literal"><span class="pre">worker()</span></tt></a> is <tt class="xref py py-const docutils literal"><span class="pre">True</span></tt> for <strong>any</strong> incoming thing.</p>
+<dd><p>Discover if <a class="reference internal" href="#knife.active.cmpknife.worker" title="knife.active.cmpknife.worker"><tt class="xref py py-meth docutils literal"><span class="pre">worker</span></tt></a> is <a class="reference external" href="http://docs.python.org/2.7/library/constants.html#True" title="(in Python v2.7)"><tt class="xref py py-data docutils literal"><span class="pre">True</span></tt></a> for <strong>any</strong> incoming thing.</p>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</td>
+<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body"><a class="reference external" href="http://docs.python.org/2.7/library/functions.html#bool" title="(in Python v2.7)"><tt class="xref py py-func docutils literal"><span class="pre">bool</span></tt></a></td>
+</tr>
+<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
 </tbody>
 </table>
 <span class="go">True</span>
 </pre></div>
 </div>
+<div class="admonition-see-also admonition seealso">
+<p class="first admonition-title">See also</p>
+<dl class="last docutils">
+<dt><a class="reference internal" href="#knife.active.cmpknife.any" title="knife.active.cmpknife.any"><tt class="xref py py-func docutils literal"><span class="pre">any</span></tt></a></dt>
+<dd>function in Python standard library</dd>
+<dt><a class="reference external" href="http://documentcloud.github.com/underscore/#any">any</a></dt>
+<dd>function in Underscore.js</dd>
+<dt><a class="reference external" href="http://mirven.github.com/underscore.lua/#any">any</a></dt>
+<dd>function in Underscore.lua</dd>
+<dt><a class="reference external" href="http://vti.github.com/underscore-perl/#ant">any</a></dt>
+<dd>function in Underscore.perl</dd>
+<dt><a class="reference external" href="http://brianhaveri.github.com/Underscore.php/#any">any</a></dt>
+<dd>function in Underscore.php</dd>
+</dl>
+</div>
 </dd></dl>
 
 <dl class="method">
 <tbody valign="top">
 <tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>things</strong> &#8211; incoming things</td>
 </tr>
-<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</td>
+<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
 </tbody>
 </table>
 </dd></dl>
 
 <dl class="method">
-<dt id="knife.active.cmpknife.ascii">
-<tt class="descname">ascii</tt><big>(</big><em>errors='strict'</em><big>)</big><a class="headerlink" href="#knife.active.cmpknife.ascii" title="Permalink to this definition">¶</a></dt>
-<dd><p><a class="reference external" href="http://docs.python.org/py3k/library/functions.html#bytes">byte</a>
-<a class="reference external" href="http://docs.python.org/py3k/library/stdtypes.html#str.encode">encode()</a> outgoing things with the <tt class="docutils literal"><span class="pre">'ascii'</span></tt> codec.</p>
+<dt id="knife.active.cmpknife.apply">
+<tt class="descname">apply</tt><big>(</big><em>worker</em>, <em>*args</em>, <em>**kw</em><big>)</big><a class="headerlink" href="#knife.active.cmpknife.apply" title="Permalink to this definition">¶</a></dt>
+<dd><p>Assign <a class="reference external" href="http://docs.python.org/2.7/library/functions.html#callable" title="(in Python v2.7)"><tt class="xref py py-func docutils literal"><span class="pre">callable</span></tt></a> used to work on incoming things plus any
+<a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-positional-argument" title="(in Python v2.7)"><em class="xref std std-term">positional argument</em></a>s and <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-keyword-argument" title="(in Python v2.7)"><em class="xref std std-term">keyword argument</em></a>s
+it will use.</p>
+<div class="admonition note">
+<p class="first admonition-title">Note</p>
+<p class="last">Global <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-positional-argument" title="(in Python v2.7)"><em class="xref std std-term">positional argument</em></a>s and <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-keyword-argument" title="(in Python v2.7)"><em class="xref std std-term">keyword argument</em></a>s
+assigned with <a class="reference internal" href="#knife.active.cmpknife.params" title="knife.active.cmpknife.params"><tt class="xref py py-meth docutils literal"><span class="pre">params</span></tt></a> are reset whenever <a class="reference internal" href="#knife.active.cmpknife.apply" title="knife.active.cmpknife.apply"><tt class="xref py py-func docutils literal"><span class="pre">apply</span></tt></a> is
+called.</p>
+</div>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>errors</strong> (<em>string</em>) &#8211; error handling for decoding issues</td>
+<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>worker</strong> &#8211; a <a class="reference external" href="http://docs.python.org/2.7/library/functions.html#callable" title="(in Python v2.7)"><tt class="xref py py-func docutils literal"><span class="pre">callable</span></tt></a></td>
 </tr>
-<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</td>
+<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
+</tr>
+</tbody>
+</table>
+</dd></dl>
+
+<dl class="method">
+<dt id="knife.active.cmpknife.ascii">
+<tt class="descname">ascii</tt><big>(</big><em>errors='strict'</em><big>)</big><a class="headerlink" href="#knife.active.cmpknife.ascii" title="Permalink to this definition">¶</a></dt>
+<dd><p><a class="reference external" href="http://docs.python.org/2.7/library/stdtypes.html#str.encode" title="(in Python v2.7)"><tt class="xref py py-meth docutils literal"><span class="pre">encode</span></tt></a> outgoing things as <a class="reference external" href="http://docs.python.org/py3k/library/functions.html#bytes">bytes</a> with the <tt class="docutils literal"><span class="pre">'latin-1'</span></tt> codec.</p>
+<table class="docutils field-list" frame="void" rules="none">
+<col class="field-name" />
+<col class="field-body" />
+<tbody valign="top">
+<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>errors</strong> (<a class="reference external" href="http://docs.python.org/2.7/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) &#8211; <a class="reference external" href="http://docs.python.org/library/codecs.html#codec-base-classes">error handling</a> for encoding</td>
+</tr>
+<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
 </tbody>
 </table>
 <dl class="method">
 <dt id="knife.active.cmpknife.back">
 <tt class="descname">back</tt><big>(</big><big>)</big><a class="headerlink" href="#knife.active.cmpknife.back" title="Permalink to this definition">¶</a></dt>
-<dd><p>Switch back to the previous <tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt> object that piped its incoming
-things through this <tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt>.</p>
+<dd><p>Switch back to <tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a> that piped its incoming
+things through this <tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a>.</p>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</td>
+<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
 </tbody>
 </table>
 <dl class="method">
 <dt id="knife.active.cmpknife.baseline">
 <tt class="descname">baseline</tt><big>(</big><big>)</big><a class="headerlink" href="#knife.active.cmpknife.baseline" title="Permalink to this definition">¶</a></dt>
-<dd><p>Restore incoming things to baseline <a class="reference internal" href="#knife.active.cmpknife.snapshot" title="knife.active.cmpknife.snapshot"><tt class="xref py py-meth docutils literal"><span class="pre">snapshot()</span></tt></a>.</p>
+<dd><p>Restore incoming things back to the baseline <a class="reference internal" href="#knife.active.cmpknife.snapshot" title="knife.active.cmpknife.snapshot"><tt class="xref py py-meth docutils literal"><span class="pre">snapshot</span></tt></a>.</p>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</td>
+<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
 </tbody>
 </table>
 
 <dl class="method">
 <dt id="knife.active.cmpknife.bytes">
-<tt class="descname">bytes</tt><big>(</big><em>encoding='utf-8'</em>, <em>errors='strict'</em><big>)</big><a class="headerlink" href="#knife.active.cmpknife.bytes" title="Permalink to this definition">¶</a></dt>
-<dd><p><a class="reference external" href="http://docs.python.org/py3k/library/functions.html#bytes">byte</a>
-<a class="reference external" href="http://docs.python.org/py3k/library/stdtypes.html#str.encode">encode()</a> outgoing things.</p>
+<tt class="descname">bytes</tt><big>(</big><em>encoding='utf_8'</em>, <em>errors='strict'</em><big>)</big><a class="headerlink" href="#knife.active.cmpknife.bytes" title="Permalink to this definition">¶</a></dt>
+<dd><p><a class="reference external" href="http://docs.python.org/2.7/library/stdtypes.html#str.encode" title="(in Python v2.7)"><tt class="xref py py-meth docutils literal"><span class="pre">encode</span></tt></a> outgoing things as <a class="reference external" href="http://docs.python.org/py3k/library/functions.html#bytes">bytes</a>.</p>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
 <tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
-<li><strong>encoding</strong> (<em>string</em>) &#8211; Unicode encoding</li>
-<li><strong>errors</strong> (<em>string</em>) &#8211; error handling for encoding issues</li>
+<li><strong>encoding</strong> (<a class="reference external" href="http://docs.python.org/2.7/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) &#8211; character <a class="reference external" href="http://docs.python.org/library/codecs.html#standard-encodings">encoding</a></li>
+<li><strong>errors</strong> (<a class="reference external" href="http://docs.python.org/2.7/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) &#8211; <p><a class="reference external" href="http://docs.python.org/library/codecs.html#codec-base-classes">error handling</a> for encoding</p>
+</li>
 </ul>
 </td>
 </tr>
-<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><p class="first last"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</p>
+<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><p class="first last"><tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></p>
 </td>
 </tr>
 </tbody>
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</td>
+<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
 </tbody>
 </table>
 <dl class="method">
 <dt id="knife.active.cmpknife.difference">
 <tt class="descname">difference</tt><big>(</big><em>symmetric=False</em><big>)</big><a class="headerlink" href="#knife.active.cmpknife.difference" title="Permalink to this definition">¶</a></dt>
-<dd><p>Discover <a class="reference external" href="http://docs.python.org/library/stdtypes.html#set.difference">difference</a> within a series of <a class="reference external" href="http://docs.python.org/glossary.html#term-iterable">iterable</a> incoming things.</p>
+<dd><p>Discover difference within a series of <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-iterable" title="(in Python v2.7)"><em class="xref std std-term">iterable</em></a> incoming
+things.</p>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>symmetric</strong> (<em>boolean</em>) &#8211; use <a class="reference external" href="http://docs.python.org/library/stdtypes.html#set.symmetric_difference">symmetric</a> difference</td>
+<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>symmetric</strong> (<a class="reference external" href="http://docs.python.org/2.7/library/functions.html#bool" title="(in Python v2.7)"><em>bool</em></a>) &#8211; return symmetric difference</td>
 </tr>
-<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</td>
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><a class="reference external" href="http://docs.python.org/2.7/library/functions.html#list" title="(in Python v2.7)"><tt class="xref py py-func docutils literal"><span class="pre">list</span></tt></a></td>
+</tr>
+<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
 </tbody>
 </table>
 <span class="go">[1, 2, 3, 4, 11]</span>
 </pre></div>
 </div>
+<div class="admonition-see-also admonition seealso">
+<p class="first admonition-title">See also</p>
+<dl class="last docutils">
+<dt><a class="reference external" href="http://docs.python.org/2.7/library/stdtypes.html#set.difference" title="(in Python v2.7)"><tt class="xref py py-meth docutils literal"><span class="pre">set.difference</span></tt></a></dt>
+<dd>function in Python standard library</dd>
+<dt><a class="reference external" href="http://docs.python.org/2.7/library/stdtypes.html#set.symmetric_difference" title="(in Python v2.7)"><tt class="xref py py-meth docutils literal"><span class="pre">set.symmetric_difference</span></tt></a></dt>
+<dd>function in Python standard library</dd>
+<dt><a class="reference external" href="http://documentcloud.github.com/underscore/#difference">difference</a></dt>
+<dd>function in Underscore.js</dd>
+<dt><a class="reference external" href="http://vti.github.com/underscore-perl/#difference">difference</a></dt>
+<dd>function in Underscore.perl</dd>
+<dt><a class="reference external" href="http://brianhaveri.github.com/Underscore.php/#difference">difference</a></dt>
+<dd>function in Underscore.php</dd>
+</dl>
+</div>
 </dd></dl>
 
 <dl class="method">
 <dt id="knife.active.cmpknife.get">
 <tt class="descname">get</tt><big>(</big><big>)</big><a class="headerlink" href="#knife.active.cmpknife.get" title="Permalink to this definition">¶</a></dt>
-<dd><p>Return outgoing things wrapped with <a class="reference internal" href="#knife.active.cmpknife.wrap" title="knife.active.cmpknife.wrap"><tt class="xref py py-meth docutils literal"><span class="pre">wrap()</span></tt></a>.</p>
-<p>If there&#8217;s only one outgoing thing, only that thing will be returned.
-If there are multiple outgoing things, they will be returned wrapped
-with <a class="reference internal" href="#knife.active.cmpknife.wrap" title="knife.active.cmpknife.wrap"><tt class="xref py py-meth docutils literal"><span class="pre">wrap()</span></tt></a>.</p>
+<dd><p>Return outgoing things wrapped with <a class="reference internal" href="#knife.active.cmpknife.wrap" title="knife.active.cmpknife.wrap"><tt class="xref py py-meth docutils literal"><span class="pre">wrap</span></tt></a>.</p>
+<div class="admonition note">
+<p class="first admonition-title">Note</p>
+<p class="last">With only one outgoing thing, only that one outgoing thing is
+returned. With multiple outgoing things, they are returned wrapped
+with the wrapper assigned with <a class="reference internal" href="#knife.active.cmpknife.wrap" title="knife.active.cmpknife.wrap"><tt class="xref py py-meth docutils literal"><span class="pre">wrap</span></tt></a> (default wrapper is
+<a class="reference external" href="http://docs.python.org/2.7/library/functions.html#list" title="(in Python v2.7)"><tt class="xref py py-func docutils literal"><span class="pre">list</span></tt></a>).</p>
+</div>
 </dd></dl>
 
 <dl class="method">
 <dt id="knife.active.cmpknife.intersection">
 <tt class="descname">intersection</tt><big>(</big><big>)</big><a class="headerlink" href="#knife.active.cmpknife.intersection" title="Permalink to this definition">¶</a></dt>
-<dd><p>Discover <a class="reference external" href="http://docs.python.org/library/stdtypes.html#set.intersection">intersection</a> within a series of <a class="reference external" href="http://docs.python.org/glossary.html#term-iterable">iterable</a> incoming things.</p>
+<dd><p>Discover intersection within a series of <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-iterable" title="(in Python v2.7)"><em class="xref std std-term">iterable</em></a> incoming
+things.</p>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</td>
+<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body"><a class="reference external" href="http://docs.python.org/2.7/library/functions.html#list" title="(in Python v2.7)"><tt class="xref py py-func docutils literal"><span class="pre">list</span></tt></a></td>
+</tr>
+<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
 </tbody>
 </table>
 <span class="go">[1, 2]</span>
 </pre></div>
 </div>
+<div class="admonition-see-also admonition seealso">
+<p class="first admonition-title">See also</p>
+<dl class="last docutils">
+<dt><a class="reference external" href="http://docs.python.org/2.7/library/stdtypes.html#set.intersection" title="(in Python v2.7)"><tt class="xref py py-meth docutils literal"><span class="pre">set.intersection</span></tt></a></dt>
+<dd>function in Python standard library</dd>
+<dt><a class="reference external" href="http://documentcloud.github.com/underscore/#intersection">intersection</a></dt>
+<dd>function in Underscore.js</dd>
+<dt><a class="reference external" href="http://vti.github.com/underscore-perl/#intersection">intersection</a></dt>
+<dd>function in Underscore.perl</dd>
+<dt><a class="reference external" href="http://brianhaveri.github.com/Underscore.php/#intersection">intersection</a></dt>
+<dd>function in Underscore.php</dd>
+</dl>
+</div>
 </dd></dl>
 
 <dl class="method">
 <dt id="knife.active.cmpknife.oneach">
 <tt class="descname">oneach</tt><big>(</big><big>)</big><a class="headerlink" href="#knife.active.cmpknife.oneach" title="Permalink to this definition">¶</a></dt>
 <dd><p>Toggle whether each outgoing thing should be individually wrapped with
-<a class="reference internal" href="#knife.active.cmpknife.wrap" title="knife.active.cmpknife.wrap"><tt class="xref py py-meth docutils literal"><span class="pre">wrap()</span></tt></a> or whether all outgoing things should be wrapped with
-<a class="reference internal" href="#knife.active.cmpknife.wrap" title="knife.active.cmpknife.wrap"><tt class="xref py py-meth docutils literal"><span class="pre">wrap()</span></tt></a> all at once.</p>
-<p>Default behavior is to <a class="reference internal" href="#knife.active.cmpknife.wrap" title="knife.active.cmpknife.wrap"><tt class="xref py py-meth docutils literal"><span class="pre">wrap()</span></tt></a> everything at once. The default
-behavior is reverted to <strong>after</strong> <a class="reference internal" href="#knife.active.cmpknife.get" title="knife.active.cmpknife.get"><tt class="xref py py-meth docutils literal"><span class="pre">get()</span></tt></a> or <a class="reference internal" href="#knife.active.cmpknife.peek" title="knife.active.cmpknife.peek"><tt class="xref py py-meth docutils literal"><span class="pre">peek()</span></tt></a> is
-invoked.</p>
+the wrapper assigned with <a class="reference internal" href="#knife.active.cmpknife.wrap" title="knife.active.cmpknife.wrap"><tt class="xref py py-meth docutils literal"><span class="pre">wrap</span></tt></a> (default wrapper is <a class="reference external" href="http://docs.python.org/2.7/library/functions.html#list" title="(in Python v2.7)"><tt class="xref py py-func docutils literal"><span class="pre">list</span></tt></a>
+) or whether all outgoing things should be wrapped all at once.</p>
+<div class="admonition note">
+<p class="first admonition-title">Note</p>
+<p class="last"><tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a> default behavior is to wrap all outgoing
+things all at once. <tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a>s reset back to this
+behavior <strong>after</strong> <a class="reference internal" href="#knife.active.cmpknife.get" title="knife.active.cmpknife.get"><tt class="xref py py-meth docutils literal"><span class="pre">get</span></tt></a> or <a class="reference internal" href="#knife.active.cmpknife.peek" title="knife.active.cmpknife.peek"><tt class="xref py py-meth docutils literal"><span class="pre">peek</span></tt></a> is called.</p>
+</div>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</td>
+<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
 </tbody>
 </table>
 <dl class="method">
 <dt id="knife.active.cmpknife.original">
 <tt class="descname">original</tt><big>(</big><big>)</big><a class="headerlink" href="#knife.active.cmpknife.original" title="Permalink to this definition">¶</a></dt>
-<dd><p>Restore incoming things to original snapshot.</p>
+<dd><p>Restore incoming things back to the original snapshot.</p>
+<div class="admonition note">
+<p class="first admonition-title">Note</p>
+<p class="last">THe original snapshot of incoming things is taken following the first
+<tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-method" title="(in Python v2.7)"><em class="xref std std-term">method</em></a> call but before the second <tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt>
+<a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-method" title="(in Python v2.7)"><em class="xref std std-term">method</em></a> call (if there is a second <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-method" title="(in Python v2.7)"><em class="xref std std-term">method</em></a> call)</p>
+</div>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</td>
+<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
 </tbody>
 </table>
 <dl class="method">
 <dt id="knife.active.cmpknife.params">
 <tt class="descname">params</tt><big>(</big><em>*args</em>, <em>**kw</em><big>)</big><a class="headerlink" href="#knife.active.cmpknife.params" title="Permalink to this definition">¶</a></dt>
-<dd><p>Assign <a class="reference external" href="http://docs.python.org/glossary.html#term-positional-argument">positional</a> and <a class="reference external" href="http://docs.python.org/glossary.html#term-keyword-argument">keyword</a> arguments used when <a class="reference internal" href="#knife.active.cmpknife.worker" title="knife.active.cmpknife.worker"><tt class="xref py py-meth docutils literal"><span class="pre">worker()</span></tt></a> is
-invoked.</p>
+<dd><p>Assign <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-positional-argument" title="(in Python v2.7)"><em class="xref std std-term">positional argument</em></a>s and <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-keyword-argument" title="(in Python v2.7)"><em class="xref std std-term">keyword argument</em></a>s
+to be used globally.</p>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</td>
+<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
 </tbody>
 </table>
 <dl class="method">
 <dt id="knife.active.cmpknife.pattern">
 <tt class="descname">pattern</tt><big>(</big><em>pattern</em>, <em>type='parse'</em>, <em>flags=0</em><big>)</big><a class="headerlink" href="#knife.active.cmpknife.pattern" title="Permalink to this definition">¶</a></dt>
-<dd><p>Compile search <cite>pattern</cite> for use as <a class="reference internal" href="#knife.active.cmpknife.worker" title="knife.active.cmpknife.worker"><tt class="xref py py-meth docutils literal"><span class="pre">worker()</span></tt></a>.</p>
-<p>Global <a class="reference external" href="http://docs.python.org/glossary.html#term-positional-argument">positional</a> and <a class="reference external" href="http://docs.python.org/glossary.html#term-keyword-argument">keyword</a><a class="reference internal" href="#knife.active.cmpknife.params" title="knife.active.cmpknife.params"><tt class="xref py py-meth docutils literal"><span class="pre">params()</span></tt></a> are reset when a pattern
-is compiled.</p>
+<dd><p>Compile search <cite>pattern</cite> for use as <a class="reference internal" href="#knife.active.cmpknife.worker" title="knife.active.cmpknife.worker"><tt class="xref py py-meth docutils literal"><span class="pre">worker</span></tt></a>.</p>
+<div class="admonition note">
+<p class="first admonition-title">Note</p>
+<p class="last">Global <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-positional-argument" title="(in Python v2.7)"><em class="xref std std-term">positional argument</em></a>s and <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-keyword-argument" title="(in Python v2.7)"><em class="xref std std-term">keyword argument</em></a>s
+assigned with <a class="reference internal" href="#knife.active.cmpknife.params" title="knife.active.cmpknife.params"><tt class="xref py py-meth docutils literal"><span class="pre">params</span></tt></a> are reset whenever a new <cite>pattern</cite> is
+compiled.</p>
+</div>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
 <tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
-<li><strong>pattern</strong> (<em>string</em>) &#8211; search pattern</li>
-<li><strong>type</strong> (<em>string</em>) &#8211; engine to compile <cite>pattern</cite> with. Valid options
+<li><strong>pattern</strong> (<a class="reference external" href="http://docs.python.org/2.7/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) &#8211; search pattern</li>
+<li><strong>type</strong> (<a class="reference external" href="http://docs.python.org/2.7/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) &#8211; engine to compile <cite>pattern</cite> with. Valid options
 are <a class="reference external" href="http://pypi.python.org/pypi/parse/">&#8216;parse&#8217;</a>, <a class="reference external" href="http://docs.python.org/library/re.html">&#8216;re&#8217;</a>, or <a class="reference external" href="http://docs.python.org/library/fnmatch.html">&#8216;glob&#8217;</a></li>
-<li><strong>flags</strong> (<em>integer</em>) &#8211; regular expression <a class="reference external" href="http://docs.python.org/library/re.html#re.DEBUG">flags</a></li>
+<li><strong>flags</strong> (<a class="reference external" href="http://docs.python.org/2.7/library/functions.html#int" title="(in Python v2.7)"><em>int</em></a>) &#8211; regular expression <a class="reference external" href="http://docs.python.org/library/re.html#re.DEBUG">flags</a></li>
 </ul>
 </td>
 </tr>
-<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><p class="first last"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</p>
+<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><p class="first last"><tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></p>
 </td>
 </tr>
 </tbody>
 <dl class="method">
 <dt id="knife.active.cmpknife.peek">
 <tt class="descname">peek</tt><big>(</big><big>)</big><a class="headerlink" href="#knife.active.cmpknife.peek" title="Permalink to this definition">¶</a></dt>
-<dd><p>Preview current incoming things wrapped with <a class="reference internal" href="#knife.active.cmpknife.wrap" title="knife.active.cmpknife.wrap"><tt class="xref py py-meth docutils literal"><span class="pre">wrap()</span></tt></a>.</p>
-<p>If there&#8217;s only one outgoing thing, only that thing will be returned.
-If there are multiple outgoing things, they will be returned wrapped
-with <a class="reference internal" href="#knife.active.cmpknife.wrap" title="knife.active.cmpknife.wrap"><tt class="xref py py-meth docutils literal"><span class="pre">wrap()</span></tt></a>.</p>
+<dd><p>Preview current incoming things wrapped with <a class="reference internal" href="#knife.active.cmpknife.wrap" title="knife.active.cmpknife.wrap"><tt class="xref py py-meth docutils literal"><span class="pre">wrap</span></tt></a>.</p>
+<div class="admonition note">
+<p class="first admonition-title">Note</p>
+<p class="last">With only one outgoing thing, only that one thing is returned. With
+multiple outgoing things, everything is returned wrapped with the
+wrapper assigned with <a class="reference internal" href="#knife.active.cmpknife.wrap" title="knife.active.cmpknife.wrap"><tt class="xref py py-meth docutils literal"><span class="pre">wrap</span></tt></a> (default wrapper is <a class="reference external" href="http://docs.python.org/2.7/library/functions.html#list" title="(in Python v2.7)"><tt class="xref py py-func docutils literal"><span class="pre">list</span></tt></a>).</p>
+</div>
 </dd></dl>
 
 <dl class="method">
 <dt id="knife.active.cmpknife.pipe">
 <tt class="descname">pipe</tt><big>(</big><em>knife</em><big>)</big><a class="headerlink" href="#knife.active.cmpknife.pipe" title="Permalink to this definition">¶</a></dt>
-<dd><p>Pipe incoming things through another <tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt>.</p>
+<dd><p>Pipe incoming things from some other <tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a>
+through this <tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a>.</p>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>knife</strong> &#8211; another <tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt></td>
+<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>knife</strong> &#8211; another <tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
-<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</td>
+<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
 </tbody>
 </table>
 <tbody valign="top">
 <tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>things</strong> &#8211; incoming things</td>
 </tr>
-<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</td>
+<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
 </tbody>
 </table>
 <dl class="method">
 <dt id="knife.active.cmpknife.snapshot">
 <tt class="descname">snapshot</tt><big>(</big><big>)</big><a class="headerlink" href="#knife.active.cmpknife.snapshot" title="Permalink to this definition">¶</a></dt>
-<dd><p>Take baseline snapshot of current incoming things.</p>
+<dd><p>Take a baseline snapshot of current incoming things.</p>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</td>
+<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
 </tbody>
 </table>
 <dl class="method">
 <dt id="knife.active.cmpknife.undo">
 <tt class="descname">undo</tt><big>(</big><em>snapshot=0</em><big>)</big><a class="headerlink" href="#knife.active.cmpknife.undo" title="Permalink to this definition">¶</a></dt>
-<dd><p>Restore incoming things to a previous snapshot.</p>
-<p>A snapshot of incoming things is automatically taken at the start of
-each <tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt> operation.</p>
+<dd><p>Revert incoming things to a previous snapshot.</p>
+<div class="admonition note">
+<p class="first admonition-title">Note</p>
+<p class="last">A snapshot of current incoming things is taken when a <tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt>
+<a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-method" title="(in Python v2.7)"><em class="xref std std-term">method</em></a> is called but before the main body of the method
+executes.</p>
+</div>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>snapshot</strong> (<em>integer</em>) &#8211; number of steps ago <tt class="docutils literal"><span class="pre">1</span></tt>, <tt class="docutils literal"><span class="pre">2</span></tt>, <tt class="docutils literal"><span class="pre">3</span></tt>,
-etc.</td>
+<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>snapshot</strong> (<a class="reference external" href="http://docs.python.org/2.7/library/functions.html#int" title="(in Python v2.7)"><em>int</em></a>) &#8211; number of steps ago <tt class="docutils literal"><span class="pre">1</span></tt>, <tt class="docutils literal"><span class="pre">2</span></tt>, <tt class="docutils literal"><span class="pre">3</span></tt>, etc.</td>
 </tr>
-<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</td>
+<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
 </tbody>
 </table>
 
 <dl class="method">
 <dt id="knife.active.cmpknife.unicode">
-<tt class="descname">unicode</tt><big>(</big><em>encoding='utf-8'</em>, <em>errors='strict'</em><big>)</big><a class="headerlink" href="#knife.active.cmpknife.unicode" title="Permalink to this definition">¶</a></dt>
-<dd><p><a class="reference external" href="http://docs.python.org/library/functions.html#unicode">unicode</a>
-(<a class="reference external" href="http://docs.python.org/py3k/library/functions.html#str">str</a> under
-Python 3) <a class="reference external" href="http://docs.python.org/py3k/library/stdtypes.html#bytes.decode">decode()</a> outgoing things.</p>
+<tt class="descname">unicode</tt><big>(</big><em>encoding='utf_8'</em>, <em>errors='strict'</em><big>)</big><a class="headerlink" href="#knife.active.cmpknife.unicode" title="Permalink to this definition">¶</a></dt>
+<dd><p><a class="reference internal" href="#knife.active.cmpknife.unicode" title="knife.active.cmpknife.unicode"><tt class="xref py py-func docutils literal"><span class="pre">unicode</span></tt></a> (<a class="reference external" href="http://docs.python.org/2.7/library/functions.html#str" title="(in Python v2.7)"><tt class="xref py py-func docutils literal"><span class="pre">str</span></tt></a> under Python 3) <a class="reference external" href="http://docs.python.org/2.7/library/stdtypes.html#str.decode" title="(in Python v2.7)"><tt class="xref py py-meth docutils literal"><span class="pre">decode</span></tt></a>
+outgoing things.</p>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
 <tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
-<li><strong>encoding</strong> (<em>string</em>) &#8211; Unicode encoding</li>
-<li><strong>errors</strong> (<em>string</em>) &#8211; error handling for decoding issues</li>
+<li><strong>encoding</strong> (<a class="reference external" href="http://docs.python.org/2.7/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) &#8211; <p>Unicode <a class="reference external" href="http://docs.python.org/library/codecs.html#standard-encodings">encoding</a></p>
+</li>
+<li><strong>errors</strong> (<a class="reference external" href="http://docs.python.org/2.7/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) &#8211; <p><a class="reference external" href="http://docs.python.org/library/codecs.html#codec-base-classes">error handling</a> for decoding</p>
+</li>
 </ul>
 </td>
 </tr>
-<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><p class="first last"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</p>
+<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><p class="first last"><tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></p>
 </td>
 </tr>
 </tbody>
 <dl class="method">
 <dt id="knife.active.cmpknife.union">
 <tt class="descname">union</tt><big>(</big><big>)</big><a class="headerlink" href="#knife.active.cmpknife.union" title="Permalink to this definition">¶</a></dt>
-<dd><p>Discover <a class="reference external" href="http://docs.python.org/py3k/library/stdtypes.html#set.union">union</a> within a series of <a class="reference external" href="http://docs.python.org/glossary.html#term-iterable">iterable</a> incoming things.</p>
+<dd><p>Discover union within a series of <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-iterable" title="(in Python v2.7)"><em class="xref std std-term">iterable</em></a> incoming things.</p>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</td>
+<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body"><a class="reference external" href="http://docs.python.org/2.7/library/functions.html#list" title="(in Python v2.7)"><tt class="xref py py-func docutils literal"><span class="pre">list</span></tt></a></td>
+</tr>
+<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
 </tbody>
 </table>
 <span class="go">[1, 10, 3, 2, 101]</span>
 </pre></div>
 </div>
+<div class="admonition-see-also admonition seealso">
+<p class="first admonition-title">See also</p>
+<dl class="last docutils">
+<dt><a class="reference external" href="http://docs.python.org/2.7/library/stdtypes.html#set.union" title="(in Python v2.7)"><tt class="xref py py-meth docutils literal"><span class="pre">set.union</span></tt></a></dt>
+<dd>function in Python standard library</dd>
+<dt><a class="reference external" href="http://documentcloud.github.com/underscore/#union">union</a></dt>
+<dd>function in Underscore.js</dd>
+<dt><a class="reference external" href="http://vti.github.com/underscore-perl/#union">union</a></dt>
+<dd>function in Underscore.perl</dd>
+<dt><a class="reference external" href="http://brianhaveri.github.com/Underscore.php/#union">union</a></dt>
+<dd>function in Underscore.php</dd>
+</dl>
+</div>
 </dd></dl>
 
 <dl class="method">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</td>
+<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
 </tbody>
 </table>
 <span class="go">[1, 2, 3, 4]</span>
 </pre></div>
 </div>
+<div class="admonition-see-also admonition seealso">
+<p class="first admonition-title">See also</p>
+<dl class="last docutils">
+<dt><a class="reference external" href="http://documentcloud.github.com/underscore/#uniq">uniq</a></dt>
+<dd>function in Underscore.js</dd>
+<dt><a class="reference external" href="http://vti.github.com/underscore-perl/#uniq">uniq</a></dt>
+<dd>function in Underscore.perl</dd>
+<dt><a class="reference external" href="http://brianhaveri.github.com/Underscore.php/#uniq">uniq</a></dt>
+<dd>function in Underscore.php</dd>
+</dl>
+</div>
 </dd></dl>
 
 <dl class="method">
 <dt id="knife.active.cmpknife.worker">
 <tt class="descname">worker</tt><big>(</big><em>worker</em><big>)</big><a class="headerlink" href="#knife.active.cmpknife.worker" title="Permalink to this definition">¶</a></dt>
-<dd><p>Assign <a class="reference external" href="http://docs.python.org/library/functions.html#callable">callable</a> used to work on incoming things.</p>
-<p>Global <a class="reference external" href="http://docs.python.org/glossary.html#term-positional-argument">positional</a> and <a class="reference external" href="http://docs.python.org/glossary.html#term-keyword-argument">keyword</a> <a class="reference internal" href="#knife.active.cmpknife.params" title="knife.active.cmpknife.params"><tt class="xref py py-meth docutils literal"><span class="pre">params()</span></tt></a> are reset when a new
-<cite>worker</cite> is assigned.</p>
+<dd><p>Assign <a class="reference external" href="http://docs.python.org/2.7/library/functions.html#callable" title="(in Python v2.7)"><tt class="xref py py-func docutils literal"><span class="pre">callable</span></tt></a> used to work on incoming things.</p>
+<div class="admonition note">
+<p class="first admonition-title">Note</p>
+<p class="last">Global <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-positional-argument" title="(in Python v2.7)"><em class="xref std std-term">positional argument</em></a>s and <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-keyword-argument" title="(in Python v2.7)"><em class="xref std std-term">keyword argument</em></a>s
+assigned with <a class="reference internal" href="#knife.active.cmpknife.params" title="knife.active.cmpknife.params"><tt class="xref py py-meth docutils literal"><span class="pre">params</span></tt></a> are reset whenever a new <cite>worker</cite> is
+assigned.</p>
+</div>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>worker</strong> &#8211; a callable</td>
+<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>worker</strong> &#8211; a <a class="reference external" href="http://docs.python.org/2.7/library/functions.html#callable" title="(in Python v2.7)"><tt class="xref py py-func docutils literal"><span class="pre">callable</span></tt></a></td>
 </tr>
-<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</td>
+<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
 </tbody>
 </table>
 <dl class="method">
 <dt id="knife.active.cmpknife.wrap">
 <tt class="descname">wrap</tt><big>(</big><em>wrapper</em><big>)</big><a class="headerlink" href="#knife.active.cmpknife.wrap" title="Permalink to this definition">¶</a></dt>
-<dd><p>Assign <tt class="xref py py-class docutils literal"><span class="pre">object</span></tt>, <tt class="xref py py-class docutils literal"><span class="pre">type</span></tt>, or <tt class="xref py py-obj docutils literal"><span class="pre">class</span></tt> used to wrap
+<dd><p>Assign <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a>, <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-type" title="(in Python v2.7)"><em class="xref std std-term">type</em></a>, or <a class="reference external" href="http://docs.python.org/2.7/reference/compound_stmts.html#class" title="(in Python v2.7)"><tt class="xref std std-keyword docutils literal"><span class="pre">class</span></tt></a> used to wrap
 outgoing things.</p>
-<p>Default wrapper is <tt class="xref py py-class docutils literal"><span class="pre">list</span></tt>. The default wrapper is reverted to
-after <a class="reference internal" href="#knife.active.cmpknife.get" title="knife.active.cmpknife.get"><tt class="xref py py-meth docutils literal"><span class="pre">get()</span></tt></a> or <a class="reference internal" href="#knife.active.cmpknife.peek" title="knife.active.cmpknife.peek"><tt class="xref py py-meth docutils literal"><span class="pre">peek()</span></tt></a> is invoked.</p>
+<div class="admonition note">
+<p class="first admonition-title">Note</p>
+<p class="last">A <tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a> resets back to its default wrapper
+(<a class="reference external" href="http://docs.python.org/2.7/library/functions.html#list" title="(in Python v2.7)"><tt class="xref py py-func docutils literal"><span class="pre">list</span></tt></a>) after <a class="reference internal" href="#knife.active.cmpknife.get" title="knife.active.cmpknife.get"><tt class="xref py py-meth docutils literal"><span class="pre">get</span></tt></a> or <a class="reference internal" href="#knife.active.cmpknife.peek" title="knife.active.cmpknife.peek"><tt class="xref py py-meth docutils literal"><span class="pre">peek</span></tt></a> is called.</p>
+</div>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>wrapper</strong> &#8211; an <tt class="xref py py-class docutils literal"><span class="pre">object</span></tt>, <tt class="xref py py-class docutils literal"><span class="pre">type</span></tt>, or <tt class="xref py py-obj docutils literal"><span class="pre">class</span></tt></td>
+<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>wrapper</strong> &#8211; an <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a>, <a class="reference external" href="http://docs.python.org/2.7/library/functions.html#type" title="(in Python v2.7)"><tt class="xref py py-func docutils literal"><span class="pre">type</span></tt></a>, or <a class="reference external" href="http://docs.python.org/2.7/reference/compound_stmts.html#class" title="(in Python v2.7)"><tt class="xref std std-keyword docutils literal"><span class="pre">class</span></tt></a></td>
 </tr>
-<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</td>
+<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
 </tbody>
 </table>

File docs/_build/html/activeknife.html

 <dl class="class">
 <dt id="knife.active.activeknife">
 <em class="property">class </em><tt class="descclassname">knife.active.</tt><tt class="descname">activeknife</tt><big>(</big><em>*things</em>, <em>**kw</em><big>)</big><a class="headerlink" href="#knife.active.activeknife" title="Permalink to this definition">¶</a></dt>
-<dd><p>Actively evaluated combo knife.</p>
-<p>Combines features from every other <tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt> knife.</p>
-<p>Aliased as <tt class="xref py py-class docutils literal"><span class="pre">knife</span></tt> when imported from <tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt>.</p>
+<dd><p>Actively evaluated combo knife. Provides every <tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt> method.</p>
+<div class="admonition note">
+<p class="first admonition-title">Note</p>
+<p class="last">Also aliased as <tt class="xref py py-class docutils literal"><span class="pre">knife</span></tt> when imported from <tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt>.</p>
+</div>
 <div class="highlight-python"><div class="highlight"><pre><span class="gp">&gt;&gt;&gt; </span><span class="kn">from</span> <span class="nn">knife</span> <span class="kn">import</span> <span class="n">knife</span>
 </pre></div>
 </div>
 <dl class="method">
 <dt id="knife.active.activeknife.__init__">
 <tt class="descname">__init__</tt><big>(</big><em>*things</em>, <em>snapshots=5</em><big>)</big><a class="headerlink" href="#knife.active.activeknife.__init__" title="Permalink to this definition">¶</a></dt>
-<dd><p>Initialize <tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt>.</p>
-<table class="docutils field-list" frame="void" rules="none">
+<dd><table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
 <dl class="method">
 <dt id="knife.active.activeknife.all">
 <tt class="descname">all</tt><big>(</big><big>)</big><a class="headerlink" href="#knife.active.activeknife.all" title="Permalink to this definition">¶</a></dt>
-<dd><p>Discover if <a class="reference internal" href="#knife.active.activeknife.worker" title="knife.active.activeknife.worker"><tt class="xref py py-meth docutils literal"><span class="pre">worker()</span></tt></a> is <tt class="xref py py-const docutils literal"><span class="pre">True</span></tt> for <strong>every</strong> incoming
-thing.</p>
+<dd><p>Discover if <a class="reference internal" href="#knife.active.activeknife.worker" title="knife.active.activeknife.worker"><tt class="xref py py-meth docutils literal"><span class="pre">worker</span></tt></a> is <a class="reference external" href="http://docs.python.org/2.7/library/constants.html#True" title="(in Python v2.7)"><tt class="xref py py-data docutils literal"><span class="pre">True</span></tt></a> for <strong>all</strong> incoming things.</p>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</td>
+<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body"><a class="reference external" href="http://docs.python.org/2.7/library/functions.html#bool" title="(in Python v2.7)"><tt class="xref py py-func docutils literal"><span class="pre">bool</span></tt></a></td>
+</tr>
+<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
 </tbody>
 </table>
 <span class="go">True</span>
 </pre></div>
 </div>
+<div class="admonition-see-also admonition seealso">
+<p class="first admonition-title">See also</p>
+<dl class="last docutils">
+<dt><a class="reference internal" href="#knife.active.activeknife.all" title="knife.active.activeknife.all"><tt class="xref py py-func docutils literal"><span class="pre">all</span></tt></a></dt>
+<dd>function in Python standard library</dd>
+<dt><a class="reference external" href="http://documentcloud.github.com/underscore/#all">all</a></dt>
+<dd>function in Underscore.js</dd>
+<dt><a class="reference external" href="http://mirven.github.com/underscore.lua/#all">all</a></dt>
+<dd>function in Underscore.lua</dd>
+<dt><a class="reference external" href="http://vti.github.com/underscore-perl/#all">all</a></dt>
+<dd>function in Underscore.perl</dd>
+<dt><a class="reference external" href="http://brianhaveri.github.com/Underscore.php/#all">all</a></dt>
+<dd>function in Underscore.php</dd>
+</dl>
+</div>
 </dd></dl>
 
 <dl class="method">
 <dt id="knife.active.activeknife.any">
 <tt class="descname">any</tt><big>(</big><big>)</big><a class="headerlink" href="#knife.active.activeknife.any" title="Permalink to this definition">¶</a></dt>
-<dd><p>Discover if <a class="reference internal" href="#knife.active.activeknife.worker" title="knife.active.activeknife.worker"><tt class="xref py py-meth docutils literal"><span class="pre">worker()</span></tt></a> is <tt class="xref py py-const docutils literal"><span class="pre">True</span></tt> for <strong>any</strong> incoming thing.</p>
+<dd><p>Discover if <a class="reference internal" href="#knife.active.activeknife.worker" title="knife.active.activeknife.worker"><tt class="xref py py-meth docutils literal"><span class="pre">worker</span></tt></a> is <a class="reference external" href="http://docs.python.org/2.7/library/constants.html#True" title="(in Python v2.7)"><tt class="xref py py-data docutils literal"><span class="pre">True</span></tt></a> for <strong>any</strong> incoming thing.</p>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</td>
+<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body"><a class="reference external" href="http://docs.python.org/2.7/library/functions.html#bool" title="(in Python v2.7)"><tt class="xref py py-func docutils literal"><span class="pre">bool</span></tt></a></td>
+</tr>
+<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
 </tbody>
 </table>
 <span class="go">True</span>
 </pre></div>
 </div>
+<div class="admonition-see-also admonition seealso">
+<p class="first admonition-title">See also</p>
+<dl class="last docutils">
+<dt><a class="reference internal" href="#knife.active.activeknife.any" title="knife.active.activeknife.any"><tt class="xref py py-func docutils literal"><span class="pre">any</span></tt></a></dt>
+<dd>function in Python standard library</dd>
+<dt><a class="reference external" href="http://documentcloud.github.com/underscore/#any">any</a></dt>
+<dd>function in Underscore.js</dd>
+<dt><a class="reference external" href="http://mirven.github.com/underscore.lua/#any">any</a></dt>
+<dd>function in Underscore.lua</dd>
+<dt><a class="reference external" href="http://vti.github.com/underscore-perl/#ant">any</a></dt>
+<dd>function in Underscore.perl</dd>
+<dt><a class="reference external" href="http://brianhaveri.github.com/Underscore.php/#any">any</a></dt>
+<dd>function in Underscore.php</dd>
+</dl>
+</div>
 </dd></dl>
 
 <dl class="method">
 <tbody valign="top">
 <tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>things</strong> &#8211; incoming things</td>
 </tr>
-<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</td>
+<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
 </tbody>
 </table>
 </dd></dl>
 
 <dl class="method">
-<dt id="knife.active.activeknife.argmap">
-<tt class="descname">argmap</tt><big>(</big><em>merge=False</em><big>)</big><a class="headerlink" href="#knife.active.activeknife.argmap" title="Permalink to this definition">¶</a></dt>
-<dd><p>Feed each incoming thing to <a class="reference internal" href="#knife.active.activeknife.worker" title="knife.active.activeknife.worker"><tt class="xref py py-meth docutils literal"><span class="pre">worker()</span></tt></a> as <a class="reference external" href="http://docs.python.org/reference/compound_stmts.html#function">wildcard</a> <a class="reference external" href="http://docs.python.org/glossary.html#term-positional-argument">positional
-arguments</a>.</p>
+<dt id="knife.active.activeknife.apply">
+<tt class="descname">apply</tt><big>(</big><em>worker</em>, <em>*args</em>, <em>**kw</em><big>)</big><a class="headerlink" href="#knife.active.activeknife.apply" title="Permalink to this definition">¶</a></dt>
+<dd><p>Assign <a class="reference external" href="http://docs.python.org/2.7/library/functions.html#callable" title="(in Python v2.7)"><tt class="xref py py-func docutils literal"><span class="pre">callable</span></tt></a> used to work on incoming things plus any
+<a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-positional-argument" title="(in Python v2.7)"><em class="xref std std-term">positional argument</em></a>s and <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-keyword-argument" title="(in Python v2.7)"><em class="xref std std-term">keyword argument</em></a>s
+it will use.</p>
+<div class="admonition note">
+<p class="first admonition-title">Note</p>
+<p class="last">Global <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-positional-argument" title="(in Python v2.7)"><em class="xref std std-term">positional argument</em></a>s and <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-keyword-argument" title="(in Python v2.7)"><em class="xref std std-term">keyword argument</em></a>s
+assigned with <a class="reference internal" href="#knife.active.activeknife.params" title="knife.active.activeknife.params"><tt class="xref py py-meth docutils literal"><span class="pre">params</span></tt></a> are reset whenever <a class="reference internal" href="#knife.active.activeknife.apply" title="knife.active.activeknife.apply"><tt class="xref py py-func docutils literal"><span class="pre">apply</span></tt></a> is
+called.</p>
+</div>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>merge</strong> (<em>boolean</em>) &#8211; merge global positional <a class="reference internal" href="#knife.active.activeknife.params" title="knife.active.activeknife.params"><tt class="xref py py-meth docutils literal"><span class="pre">params()</span></tt></a> with
-positional arguments derived from incoming things</td>
+<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>worker</strong> &#8211; a <a class="reference external" href="http://docs.python.org/2.7/library/functions.html#callable" title="(in Python v2.7)"><tt class="xref py py-func docutils literal"><span class="pre">callable</span></tt></a></td>
 </tr>
-<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</td>
+<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
+</tr>
+</tbody>
+</table>
+</dd></dl>
+
+<dl class="method">
+<dt id="knife.active.activeknife.argmap">
+<tt class="descname">argmap</tt><big>(</big><em>merge=False</em><big>)</big><a class="headerlink" href="#knife.active.activeknife.argmap" title="Permalink to this definition">¶</a></dt>
+<dd><p>Feed each incoming thing to <a class="reference internal" href="#knife.active.activeknife.worker" title="knife.active.activeknife.worker"><tt class="xref py py-meth docutils literal"><span class="pre">worker</span></tt></a> as <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-positional-argument" title="(in Python v2.7)"><em class="xref std std-term">positional
+argument</em></a>s.</p>
+<table class="docutils field-list" frame="void" rules="none">
+<col class="field-name" />
+<col class="field-body" />
+<tbody valign="top">
+<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>merge</strong> (<a class="reference external" href="http://docs.python.org/2.7/library/functions.html#bool" title="(in Python v2.7)"><em>bool</em></a>) &#8211; merge global positional <a class="reference internal" href="#knife.active.activeknife.params" title="knife.active.activeknife.params"><tt class="xref py py-meth docutils literal"><span class="pre">params</span></tt></a> with
+positional arguments derived from incoming things when passed to
+<a class="reference internal" href="#knife.active.activeknife.worker" title="knife.active.activeknife.worker"><tt class="xref py py-meth docutils literal"><span class="pre">worker</span></tt></a></td>
+</tr>
+<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
 </tbody>
 </table>
 <span class="go">[1008, 3024, 6048]</span>
 </pre></div>
 </div>
+<div class="admonition-see-also admonition seealso">
+<p class="first admonition-title">See also</p>
+<dl class="last docutils">
+<dt><a class="reference external" href="http://docs.python.org/2.7/library/itertools.html#itertools.starmap" title="(in Python v2.7)"><tt class="xref py py-func docutils literal"><span class="pre">itertools.starmap</span></tt></a></dt>
+<dd>function in Python standard library</dd>
+</dl>
+</div>
 </dd></dl>
 
 <dl class="method">
 <dt id="knife.active.activeknife.ascii">
 <tt class="descname">ascii</tt><big>(</big><em>errors='strict'</em><big>)</big><a class="headerlink" href="#knife.active.activeknife.ascii" title="Permalink to this definition">¶</a></dt>
-<dd><p><a class="reference external" href="http://docs.python.org/py3k/library/functions.html#bytes">byte</a>
-<a class="reference external" href="http://docs.python.org/py3k/library/stdtypes.html#str.encode">encode()</a> outgoing things with the <tt class="docutils literal"><span class="pre">'ascii'</span></tt> codec.</p>
+<dd><p><a class="reference external" href="http://docs.python.org/2.7/library/stdtypes.html#str.encode" title="(in Python v2.7)"><tt class="xref py py-meth docutils literal"><span class="pre">encode</span></tt></a> outgoing things as <a class="reference external" href="http://docs.python.org/py3k/library/functions.html#bytes">bytes</a> with the <tt class="docutils literal"><span class="pre">'latin-1'</span></tt> codec.</p>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>errors</strong> (<em>string</em>) &#8211; error handling for decoding issues</td>
+<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>errors</strong> (<a class="reference external" href="http://docs.python.org/2.7/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) &#8211; <a class="reference external" href="http://docs.python.org/library/codecs.html#codec-base-classes">error handling</a> for encoding</td>
 </tr>
-<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</td>
+<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
 </tbody>
 </table>
 <dl class="method">
 <dt id="knife.active.activeknife.at">
 <tt class="descname">at</tt><big>(</big><em>n</em>, <em>default=None</em><big>)</big><a class="headerlink" href="#knife.active.activeknife.at" title="Permalink to this definition">¶</a></dt>
-<dd><p><a class="reference external" href="http://docs.python.org/glossary.html#term-slice">Slice</a> off
-incoming thing found at index <cite>n</cite>.</p>
+<dd><p><a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-slice" title="(in Python v2.7)"><em class="xref std std-term">Slice</em></a> off incoming thing found at index <cite>n</cite>.</p>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
 <tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
-<li><strong>n</strong> (<em>integer</em>) &#8211; index of some incoming thing</li>
+<li><strong>n</strong> (<a class="reference external" href="http://docs.python.org/2.7/library/functions.html#int" title="(in Python v2.7)"><em>int</em></a>) &#8211; index of some incoming thing</li>
 <li><strong>default</strong> &#8211; default returned if nothing is found at <cite>n</cite></li>
 </ul>
 </td>
 </tr>
-<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><p class="first last"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</p>
+<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><p class="first last"><tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></p>
 </td>
 </tr>
 </tbody>
 <span class="go">11</span>
 </pre></div>
 </div>
+<div class="admonition-see-also admonition seealso">
+<p class="first admonition-title">See also</p>
+<dl class="last docutils">
+<dt><a class="reference external" href="http://docs.python.org/library/itertools.html#recipes">&#8220;nth&#8221;</a></dt>
+<dd>Itertools Recipes</dd>
+</dl>
+</div>
 </dd></dl>
 
 <dl class="method">
 <dt id="knife.active.activeknife.attrs">
 <tt class="descname">attrs</tt><big>(</big><em>*names</em><big>)</big><a class="headerlink" href="#knife.active.activeknife.attrs" title="Permalink to this definition">¶</a></dt>
-<dd><p>Collect <a class="reference external" href="http://docs.python.org/glossary.html#term-attribute">attribute</a> values from incoming things that match an attribute <em>name</em>
-found in <cite>names</cite>.</p>
+<dd><p>Collect <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-attribute" title="(in Python v2.7)"><em class="xref std std-term">attribute</em></a> values from incoming things that match an
+<strong>attribute name</strong> found in <cite>names</cite>.</p>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>names</strong> (<em>string</em>) &#8211; attribute names</td>
+<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>names</strong> (<a class="reference external" href="http://docs.python.org/2.7/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) &#8211; attribute names</td>
 </tr>
-<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</td>
+<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
 </tbody>
 </table>
 <span class="go">[]</span>
 </pre></div>
 </div>
+<div class="admonition-see-also admonition seealso">
+<p class="first admonition-title">See also</p>
+<dl class="last docutils">
+<dt><a class="reference external" href="http://docs.python.org/2.7/library/operator.html#operator.attrgetter" title="(in Python v2.7)"><tt class="xref py py-func docutils literal"><span class="pre">operator.attrgetter</span></tt></a></dt>
+<dd>function in Python standard library</dd>
+<dt><a class="reference external" href="http://documentcloud.github.com/underscore/#pick">pick</a></dt>
+<dd>function in Underscore.js</dd>
+</dl>
+</div>
 </dd></dl>
 
 <dl class="method">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</td>
+<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">a number</td>
+</tr>
+<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
 </tbody>
 </table>
 <dl class="method">
 <dt id="knife.active.activeknife.back">
 <tt class="descname">back</tt><big>(</big><big>)</big><a class="headerlink" href="#knife.active.activeknife.back" title="Permalink to this definition">¶</a></dt>
-<dd><p>Switch back to the previous <tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt> object that piped its incoming
-things through this <tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt>.</p>
+<dd><p>Switch back to <tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a> that piped its incoming
+things through this <tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a>.</p>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</td>
+<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
 </tbody>
 </table>
 <dl class="method">
 <dt id="knife.active.activeknife.baseline">
 <tt class="descname">baseline</tt><big>(</big><big>)</big><a class="headerlink" href="#knife.active.activeknife.baseline" title="Permalink to this definition">¶</a></dt>
-<dd><p>Restore incoming things to baseline <a class="reference internal" href="#knife.active.activeknife.snapshot" title="knife.active.activeknife.snapshot"><tt class="xref py py-meth docutils literal"><span class="pre">snapshot()</span></tt></a>.</p>
+<dd><p>Restore incoming things back to the baseline <a class="reference internal" href="#knife.active.activeknife.snapshot" title="knife.active.activeknife.snapshot"><tt class="xref py py-meth docutils literal"><span class="pre">snapshot</span></tt></a>.</p>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</td>
+<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
 </tbody>
 </table>
 
 <dl class="method">
 <dt id="knife.active.activeknife.bytes">
-<tt class="descname">bytes</tt><big>(</big><em>encoding='utf-8'</em>, <em>errors='strict'</em><big>)</big><a class="headerlink" href="#knife.active.activeknife.bytes" title="Permalink to this definition">¶</a></dt>
-<dd><p><a class="reference external" href="http://docs.python.org/py3k/library/functions.html#bytes">byte</a>
-<a class="reference external" href="http://docs.python.org/py3k/library/stdtypes.html#str.encode">encode()</a> outgoing things.</p>
+<tt class="descname">bytes</tt><big>(</big><em>encoding='utf_8'</em>, <em>errors='strict'</em><big>)</big><a class="headerlink" href="#knife.active.activeknife.bytes" title="Permalink to this definition">¶</a></dt>
+<dd><p><a class="reference external" href="http://docs.python.org/2.7/library/stdtypes.html#str.encode" title="(in Python v2.7)"><tt class="xref py py-meth docutils literal"><span class="pre">encode</span></tt></a> outgoing things as <a class="reference external" href="http://docs.python.org/py3k/library/functions.html#bytes">bytes</a>.</p>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
 <tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
-<li><strong>encoding</strong> (<em>string</em>) &#8211; Unicode encoding</li>
-<li><strong>errors</strong> (<em>string</em>) &#8211; error handling for encoding issues</li>
+<li><strong>encoding</strong> (<a class="reference external" href="http://docs.python.org/2.7/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) &#8211; character <a class="reference external" href="http://docs.python.org/library/codecs.html#standard-encodings">encoding</a></li>
+<li><strong>errors</strong> (<a class="reference external" href="http://docs.python.org/2.7/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) &#8211; <p><a class="reference external" href="http://docs.python.org/library/codecs.html#codec-base-classes">error handling</a> for encoding</p>
+</li>
 </ul>
 </td>
 </tr>
-<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><p class="first last"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</p>
+<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><p class="first last"><tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></p>
 </td>
 </tr>
 </tbody>
 <dl class="method">
 <dt id="knife.active.activeknife.choice">
 <tt class="descname">choice</tt><big>(</big><big>)</big><a class="headerlink" href="#knife.active.activeknife.choice" title="Permalink to this definition">¶</a></dt>
-<dd><p>Randomly <a class="reference external" href="http://docs.python.org/glossary.html#term-slice">slice</a>
-off <strong>one</strong> incoming thing.</p>
+<dd><p>Randomly <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-slice" title="(in Python v2.7)"><em class="xref std std-term">slice</em></a> off <strong>one</strong> incoming thing.</p>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</td>
+<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
 </tbody>
 </table>
 <span class="go">3</span>
 </pre></div>
 </div>
+<div class="admonition-see-also admonition seealso">
+<p class="first admonition-title">See also</p>
+<dl class="last docutils">
+<dt><a class="reference external" href="http://docs.python.org/2.7/library/random.html#random.choice" title="(in Python v2.7)"><tt class="xref py py-func docutils literal"><span class="pre">random.choice</span></tt></a></dt>
+<dd>function in Python standard library</dd>
+</dl>
+</div>
 </dd></dl>
 
 <dl class="method">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</td>
+<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-mod docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
 </tbody>
 </table>
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>n</strong> (<em>integer</em>) &#8211; number of incoming things to generate
-combinations from</td>
+<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>n</strong> (<a class="reference external" href="http://docs.python.org/2.7/library/functions.html#int" title="(in Python v2.7)"><em>int</em></a>) &#8211; number of incoming things to derive combinations from</td>
 </tr>
-<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</td>
+<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
 </tbody>
 </table>
 <span class="go">[(40, 50), (40, 60), (50, 60)]</span>
 </pre></div>
 </div>
+<div class="admonition-see-also admonition seealso">
+<p class="first admonition-title">See also</p>
+<dl class="last docutils">
+<dt><a class="reference external" href="http://docs.python.org/2.7/library/itertools.html#itertools.combinations" title="(in Python v2.7)"><tt class="xref py py-func docutils literal"><span class="pre">itertools.combinations</span></tt></a></dt>
+<dd>function in Python standard library</dd>
+</dl>
+</div>
 </dd></dl>
 
 <dl class="method">
 <dt id="knife.active.activeknife.copy">
 <tt class="descname">copy</tt><big>(</big><big>)</big><a class="headerlink" href="#knife.active.activeknife.copy" title="Permalink to this definition">¶</a></dt>
-<dd><p>Duplicate (by deep copying) each incoming thing.</p>
+<dd><p>Duplicate each incoming thing.</p>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</td>
+<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
 </tbody>
 </table>
 <span class="go">[[1, [2, 3]], [4, [5, 6]]]</span>
 </pre></div>
 </div>
+<div class="admonition-see-also admonition seealso">
+<p class="first admonition-title">See also</p>
+<dl class="last docutils">
+<dt><a class="reference external" href="http://docs.python.org/2.7/library/copy.html#copy.deepcopy" title="(in Python v2.7)"><tt class="xref py py-func docutils literal"><span class="pre">copy.deepcopy</span></tt></a></dt>
+<dd>function in Python standard library</dd>
+</dl>
+</div>
 </dd></dl>
 
 <dl class="method">
 <dt id="knife.active.activeknife.count">
 <tt class="descname">count</tt><big>(</big><big>)</big><a class="headerlink" href="#knife.active.activeknife.count" title="Permalink to this definition">¶</a></dt>
-<dd><p>Discover how common each incoming thing is.</p>
-<p>Collects <tt class="xref py py-class docutils literal"><span class="pre">tuple</span></tt> of
-(<em>least common thing</em>, <em>most common thing</em>, [<em>counts of everything</em>
-(a <tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <tt class="xref py py-class docutils literal"><span class="pre">tuple</span></tt> pairs of (<em>thing</em>, <em>count</em>))]).</p>
+<dd><p>Discover how common each incoming thing is and the overall count of
+each incoming thing.</p>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</td>
+<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">Collects <a class="reference external" href="http://docs.python.org/2.7/library/collections.html#collections.namedtuple" title="(in Python v2.7)"><tt class="xref py py-func docutils literal"><span class="pre">namedtuple</span></tt></a> <tt class="docutils literal"><span class="pre">Count(least=int,</span>
+<span class="pre">most=int,</span> <span class="pre">overall=[(thing1,</span> <span class="pre">int),</span> <span class="pre">(thing2,</span> <span class="pre">int),</span> <span class="pre">...])</span></tt></td>
+</tr>
+<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
 </tbody>
 </table>
 <dl class="method">
 <dt id="knife.active.activeknife.dice">
 <tt class="descname">dice</tt><big>(</big><em>n</em>, <em>fill=None</em><big>)</big><a class="headerlink" href="#knife.active.activeknife.dice" title="Permalink to this definition">¶</a></dt>
-<dd><p><a class="reference external" href="http://docs.python.org/glossary.html#term-slice">Slice</a> one
-<a class="reference external" href="http://docs.python.org/glossary.html#term-iterable">iterable</a>
-incoming thing into <cite>n</cite> iterable incoming things.</p>
+<dd><p><a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-slice" title="(in Python v2.7)"><em class="xref std std-term">Slice</em></a> one <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-iterable" title="(in Python v2.7)"><em class="xref std std-term">iterable</em></a> incoming thing into <cite>n</cite> iterable
+incoming things.</p>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
 <tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
-<li><strong>n</strong> (<em>integer</em>) &#8211; number of incoming things per slice</li>
+<li><strong>n</strong> (<a class="reference external" href="http://docs.python.org/2.7/library/functions.html#int" title="(in Python v2.7)"><em>int</em></a>) &#8211; number of incoming things per slice</li>
 <li><strong>fill</strong> &#8211; value to pad out incomplete iterables</li>
 </ul>
 </td>
 </tr>
-<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><p class="first last"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</p>
+<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><p class="first last"><tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></p>
 </td>
 </tr>
 </tbody>
 <span class="go">[(&#39;moe&#39;, &#39;larry&#39;), (&#39;curly&#39;, 30), (40, 50), (True, &#39;x&#39;)]</span>
 </pre></div>
 </div>
+<div class="admonition-see-also admonition seealso">
+<p class="first admonition-title">See also</p>
+<dl class="last docutils">
+<dt><a class="reference external" href="http://docs.python.org/library/itertools.html#recipes">&#8220;grouper&#8221;</a></dt>
+<dd>Itertools Recipes</dd>
+</dl>
+</div>
 </dd></dl>
 
 <dl class="method">
 <dt id="knife.active.activeknife.difference">
 <tt class="descname">difference</tt><big>(</big><em>symmetric=False</em><big>)</big><a class="headerlink" href="#knife.active.activeknife.difference" title="Permalink to this definition">¶</a></dt>
-<dd><p>Discover <a class="reference external" href="http://docs.python.org/library/stdtypes.html#set.difference">difference</a> within a series of <a class="reference external" href="http://docs.python.org/glossary.html#term-iterable">iterable</a> incoming things.</p>
+<dd><p>Discover difference within a series of <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-iterable" title="(in Python v2.7)"><em class="xref std std-term">iterable</em></a> incoming
+things.</p>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>symmetric</strong> (<em>boolean</em>) &#8211; use <a class="reference external" href="http://docs.python.org/library/stdtypes.html#set.symmetric_difference">symmetric</a> difference</td>
+<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>symmetric</strong> (<a class="reference external" href="http://docs.python.org/2.7/library/functions.html#bool" title="(in Python v2.7)"><em>bool</em></a>) &#8211; return symmetric difference</td>
 </tr>
-<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</td>
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><a class="reference external" href="http://docs.python.org/2.7/library/functions.html#list" title="(in Python v2.7)"><tt class="xref py py-func docutils literal"><span class="pre">list</span></tt></a></td>
+</tr>
+<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
 </tbody>
 </table>
 <span class="go">[1, 2, 3, 4, 11]</span>
 </pre></div>
 </div>
+<div class="admonition-see-also admonition seealso">
+<p class="first admonition-title">See also</p>
+<dl class="last docutils">
+<dt><a class="reference external" href="http://docs.python.org/2.7/library/stdtypes.html#set.difference" title="(in Python v2.7)"><tt class="xref py py-meth docutils literal"><span class="pre">set.difference</span></tt></a></dt>
+<dd>function in Python standard library</dd>
+<dt><a class="reference external" href="http://docs.python.org/2.7/library/stdtypes.html#set.symmetric_difference" title="(in Python v2.7)"><tt class="xref py py-meth docutils literal"><span class="pre">set.symmetric_difference</span></tt></a></dt>
+<dd>function in Python standard library</dd>
+<dt><a class="reference external" href="http://documentcloud.github.com/underscore/#difference">difference</a></dt>
+<dd>function in Underscore.js</dd>
+<dt><a class="reference external" href="http://vti.github.com/underscore-perl/#difference">difference</a></dt>
+<dd>function in Underscore.perl</dd>
+<dt><a class="reference external" href="http://brianhaveri.github.com/Underscore.php/#difference">difference</a></dt>
+<dd>function in Underscore.php</dd>
+</dl>
+</div>
 </dd></dl>
 
 <dl class="method">
 <dt id="knife.active.activeknife.duality">
 <tt class="descname">duality</tt><big>(</big><big>)</big><a class="headerlink" href="#knife.active.activeknife.duality" title="Permalink to this definition">¶</a></dt>
-<dd><p>Divide incoming things into two <a class="reference external" href="http://docs.python.org/glossary.html#term-iterable">iterables</a>, the first everything <a class="reference internal" href="#knife.active.activeknife.worker" title="knife.active.activeknife.worker"><tt class="xref py py-meth docutils literal"><span class="pre">worker()</span></tt></a> is
-<tt class="xref py py-const docutils literal"><span class="pre">True</span></tt> for and the second everything <a class="reference internal" href="#knife.active.activeknife.worker" title="knife.active.activeknife.worker"><tt class="xref py py-meth docutils literal"><span class="pre">worker()</span></tt></a> is
-<tt class="xref py py-const docutils literal"><span class="pre">False</span></tt> for.</p>
+<dd><p>Divide incoming things into two <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-iterable" title="(in Python v2.7)"><em class="xref std std-term">iterable</em></a>s, the first
+everything <a class="reference internal" href="#knife.active.activeknife.worker" title="knife.active.activeknife.worker"><tt class="xref py py-meth docutils literal"><span class="pre">worker</span></tt></a> is <a class="reference external" href="http://docs.python.org/2.7/library/constants.html#True" title="(in Python v2.7)"><tt class="xref py py-data docutils literal"><span class="pre">True</span></tt></a> for and the second
+everything <a class="reference internal" href="#knife.active.activeknife.worker" title="knife.active.activeknife.worker"><tt class="xref py py-meth docutils literal"><span class="pre">worker</span></tt></a> is <a class="reference external" href="http://docs.python.org/2.7/library/constants.html#False" title="(in Python v2.7)"><tt class="xref py py-data docutils literal"><span class="pre">False</span></tt></a> for.</p>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</td>
+<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
 </tbody>
 </table>
 <dl class="method">
 <dt id="knife.active.activeknife.filter">
 <tt class="descname">filter</tt><big>(</big><em>invert=False</em><big>)</big><a class="headerlink" href="#knife.active.activeknife.filter" title="Permalink to this definition">¶</a></dt>
-<dd><p>Collect incoming things matched by <a class="reference internal" href="#knife.active.activeknife.worker" title="knife.active.activeknife.worker"><tt class="xref py py-meth docutils literal"><span class="pre">worker()</span></tt></a>.</p>
+<dd><p>Collect incoming things matched by <a class="reference internal" href="#knife.active.activeknife.worker" title="knife.active.activeknife.worker"><tt class="xref py py-meth docutils literal"><span class="pre">worker</span></tt></a>.</p>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>invert</strong> (<em>boolean</em>) &#8211; collect things <a class="reference internal" href="#knife.active.activeknife.worker" title="knife.active.activeknife.worker"><tt class="xref py py-meth docutils literal"><span class="pre">worker()</span></tt></a> is
-<tt class="xref py py-const docutils literal"><span class="pre">False</span></tt> rather than <tt class="xref py py-const docutils literal"><span class="pre">True</span></tt> for</td>
+<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>invert</strong> (<a class="reference external" href="http://docs.python.org/2.7/library/functions.html#bool" title="(in Python v2.7)"><em>bool</em></a>) &#8211; collect incoming things <a class="reference internal" href="#knife.active.activeknife.worker" title="knife.active.activeknife.worker"><tt class="xref py py-meth docutils literal"><span class="pre">worker</span></tt></a> is
+<a class="reference external" href="http://docs.python.org/2.7/library/constants.html#False" title="(in Python v2.7)"><tt class="xref py py-data docutils literal"><span class="pre">False</span></tt></a> rather than <a class="reference external" href="http://docs.python.org/2.7/library/constants.html#True" title="(in Python v2.7)"><tt class="xref py py-data docutils literal"><span class="pre">True</span></tt></a> for</td>
 </tr>
-<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</td>
+<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
 </tbody>
 </table>
 <span class="go">[1, 3, 5]</span>
 </pre></div>
 </div>
+<div class="admonition-see-also admonition seealso">
+<p class="first admonition-title">See also</p>
+<dl class="last docutils">
+<dt><a class="reference external" href="http://docs.python.org/2.7/library/itertools.html#itertools.ifilter" title="(in Python v2.7)"><tt class="xref py py-func docutils literal"><span class="pre">itertools.ifilter</span></tt></a></dt>
+<dd>function in Python standard library (replaces <a class="reference internal" href="#knife.active.activeknife.filter" title="knife.active.activeknife.filter"><tt class="xref py py-func docutils literal"><span class="pre">filter</span></tt></a> in Python 3)</dd>
+<dt><a class="reference external" href="http://docs.python.org/2.7/library/itertools.html#itertools.ifilterfalse" title="(in Python v2.7)"><tt class="xref py py-func docutils literal"><span class="pre">itertools.ifilterfalse</span></tt></a></dt>
+<dd>function in Python standard library (<tt class="xref py py-func docutils literal"><span class="pre">filterfalse</span></tt> in Python 3)</dd>
+<dt><a class="reference external" href="http://documentcloud.github.com/underscore/#filter">filter</a></dt>
+<dd>function in Underscore.js</dd>
+<dt><a class="reference external" href="http://documentcloud.github.com/underscore/#reject">reject</a></dt>
+<dd>function in Underscore.js</dd>
+<dt><a class="reference external" href="http://mirven.github.com/underscore.lua/#filter">filter</a></dt>
+<dd>function in Underscore.lua</dd>
+<dt><a class="reference external" href="http://mirven.github.com/underscore.lua/#reject">reject</a></dt>
+<dd>function in Underscore.lua</dd>
+<dt><a class="reference external" href="http://vti.github.com/underscore-perl/#filter">filter</a></dt>
+<dd>function in Underscore.perl</dd>
+<dt><a class="reference external" href="http://vti.github.com/underscore-perl/#reject">reject</a></dt>
+<dd>function in Underscore.perl</dd>
+<dt><a class="reference external" href="http://brianhaveri.github.com/Underscore.php/#filter">filter</a></dt>
+<dd>function in Underscore.php</dd>
+<dt><a class="reference external" href="http://brianhaveri.github.com/Underscore.php/#reject">reject</a></dt>
+<dd>function in Underscore.php</dd>
+</dl>
+</div>
 </dd></dl>
 
 <dl class="method">
 <dt id="knife.active.activeknife.first">
 <tt class="descname">first</tt><big>(</big><em>n=0</em><big>)</big><a class="headerlink" href="#knife.active.activeknife.first" title="Permalink to this definition">¶</a></dt>
-<dd><p>Slice off <cite>n</cite> things from the <strong>starting</strong> end of incoming things or
-just the <strong>first</strong> incoming thing.</p>
+<dd><p><a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-slice" title="(in Python v2.7)"><em class="xref std std-term">Slice</em></a>  off <cite>n</cite> things from the <strong>starting</strong> end of incoming
+things or just the <strong>first</strong> incoming thing.</p>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>n</strong> (<em>integer</em>) &#8211; number of incoming things</td>
+<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>n</strong> (<a class="reference external" href="http://docs.python.org/2.7/library/functions.html#int" title="(in Python v2.7)"><em>int</em></a>) &#8211; number of incoming things</td>
 </tr>
-<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</td>
+<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
 </tbody>
 </table>
 <span class="go">[5, 4]</span>
 </pre></div>
 </div>
+<div class="admonition-see-also admonition seealso">
+<p class="first admonition-title">See also</p>
+<dl class="last docutils">
+<dt><a class="reference external" href="http://documentcloud.github.com/underscore/#first">first</a></dt>
+<dd>function in Underscore.js</dd>
+<dt><a class="reference external" href="http://mirven.github.com/underscore.lua/#first">first</a></dt>
+<dd>function in Underscore.lua</dd>
+<dt><a class="reference external" href="http://vti.github.com/underscore-perl/#first">first</a></dt>
+<dd>function in Underscore.perl</dd>
+<dt><a class="reference external" href="http://brianhaveri.github.com/Underscore.php/#first">first</a></dt>
+<dd>function in Underscore.php</dd>
+</dl>
+</div>
 </dd></dl>
 
 <dl class="method">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</td>
+<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
 </tbody>
 </table>
 <span class="go">[1, 2, 3, 4, &#39;here&#39;]</span>
 </pre></div>
 </div>
+<div class="admonition-see-also admonition seealso">
+<p class="first admonition-title">See also</p>
+<dl class="last docutils">
+<dt><a class="reference external" href="http://documentcloud.github.com/underscore/#flatten">flatten</a></dt>
+<dd>function in Underscore.js</dd>
+<dt><a class="reference external" href="http://mirven.github.com/underscore.lua/#flatten">flatten</a></dt>
+<dd>function in Underscore.lua</dd>
+<dt><a class="reference external" href="http://vti.github.com/underscore-perl/#flatten">flatten</a></dt>
+<dd>function in Underscore.perl</dd>
+<dt><a class="reference external" href="http://brianhaveri.github.com/Underscore.php/#flatten">flatten</a></dt>
+<dd>function in Underscore.php</dd>
+</dl>
+</div>
 </dd></dl>
 
 <dl class="method">
 <dt id="knife.active.activeknife.get">
 <tt class="descname">get</tt><big>(</big><big>)</big><a class="headerlink" href="#knife.active.activeknife.get" title="Permalink to this definition">¶</a></dt>
-<dd><p>Return outgoing things wrapped with <a class="reference internal" href="#knife.active.activeknife.wrap" title="knife.active.activeknife.wrap"><tt class="xref py py-meth docutils literal"><span class="pre">wrap()</span></tt></a>.</p>
-<p>If there&#8217;s only one outgoing thing, only that thing will be returned.
-If there are multiple outgoing things, they will be returned wrapped
-with <a class="reference internal" href="#knife.active.activeknife.wrap" title="knife.active.activeknife.wrap"><tt class="xref py py-meth docutils literal"><span class="pre">wrap()</span></tt></a>.</p>
+<dd><p>Return outgoing things wrapped with <a class="reference internal" href="#knife.active.activeknife.wrap" title="knife.active.activeknife.wrap"><tt class="xref py py-meth docutils literal"><span class="pre">wrap</span></tt></a>.</p>
+<div class="admonition note">
+<p class="first admonition-title">Note</p>
+<p class="last">With only one outgoing thing, only that one outgoing thing is
+returned. With multiple outgoing things, they are returned wrapped
+with the wrapper assigned with <a class="reference internal" href="#knife.active.activeknife.wrap" title="knife.active.activeknife.wrap"><tt class="xref py py-meth docutils literal"><span class="pre">wrap</span></tt></a> (default wrapper is
+<a class="reference external" href="http://docs.python.org/2.7/library/functions.html#list" title="(in Python v2.7)"><tt class="xref py py-func docutils literal"><span class="pre">list</span></tt></a>).</p>
+</div>
 </dd></dl>
 
 <dl class="method">
 <dt id="knife.active.activeknife.group">
 <tt class="descname">group</tt><big>(</big><big>)</big><a class="headerlink" href="#knife.active.activeknife.group" title="Permalink to this definition">¶</a></dt>
-<dd><p>Group incoming things using <a class="reference internal" href="#knife.active.activeknife.worker" title="knife.active.activeknife.worker"><tt class="xref py py-meth docutils literal"><span class="pre">worker()</span></tt></a> as the <a class="reference external" href="http://docs.python.org/glossary.html#term-key-function">key function</a>.</p>
+<dd><p>Group incoming things using <a class="reference internal" href="#knife.active.activeknife.worker" title="knife.active.activeknife.worker"><tt class="xref py py-meth docutils literal"><span class="pre">worker</span></tt></a> as the <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-key-function" title="(in Python v2.7)"><em class="xref std std-term">key function</em></a>.</p>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</td>
+<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body"><a class="reference external" href="http://docs.python.org/2.7/library/collections.html#collections.namedtuple" title="(in Python v2.7)"><tt class="xref py py-func docutils literal"><span class="pre">namedtuple</span></tt></a> <tt class="docutils literal"><span class="pre">Group(keys=keys,</span>
+<span class="pre">groups=tuple)</span></tt></td>
+</tr>
+<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
 </tbody>
 </table>
 <span class="go">[Group(keys=1.0, groups=(1.3,)), Group(keys=2.0, groups=(2.1, 2.4))]</span>
 </pre></div>
 </div>
+<div class="admonition-see-also admonition seealso">
+<p class="first admonition-title">See also</p>
+<dl class="last docutils">
+<dt><a class="reference external" href="http://docs.python.org/2.7/library/itertools.html#itertools.groupby" title="(in Python v2.7)"><tt class="xref py py-func docutils literal"><span class="pre">itertools.groupby</span></tt></a></dt>
+<dd>function in Python standard library</dd>
+<dt><a class="reference external" href="http://documentcloud.github.com/underscore/#groupBy">groupBy</a></dt>
+<dd>function in Underscore.js</dd>
+<dt><a class="reference external" href="http://vti.github.com/underscore-perl/#groupBy">groupBy</a></dt>
+<dd>function in Underscore.perl</dd>
+<dt><a class="reference external" href="http://brianhaveri.github.com/Underscore.php/#groupBy">groupBy</a></dt>
+<dd>function in Underscore.php</dd>
+</dl>
+</div>
 </dd></dl>
 
 <dl class="method">
 <dt id="knife.active.activeknife.initial">
 <tt class="descname">initial</tt><big>(</big><big>)</big><a class="headerlink" href="#knife.active.activeknife.initial" title="Permalink to this definition">¶</a></dt>
-<dd><p><a class="reference external" href="http://docs.python.org/glossary.html#term-slice">Slice</a> off
-everything except the <strong>last</strong> incoming thing.</p>
+<dd><p><a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-slice" title="(in Python v2.7)"><em class="xref std std-term">Slice</em></a> off every incoming thing except the <strong>last</strong> incoming
+thing.</p>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-const docutils literal"><span class="pre">self</span></tt> (<tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> object)</td>
+<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-obj docutils literal"><span class="pre">knife</span></tt> <a class="reference external" href="http://docs.python.org/2.7/glossary.html#term-object" title="(in Python v2.7)"><em class="xref std std-term">object</em></a></td>
 </tr>
 </tbody>