say / README.rst

Diff from to

README.rst

  *  Indentation and wrapping (to help stucture output)
  *  Convenience printing functions for horizontal rules (lines), titles, and
     vertical whitespace.
- *  A parallel function, ``show()``,  that displays the current value of
-    variables.
 
 Usage
 =====
 invocation, the more valuable having it stated in-line becomes. Note that full
 expressions are are supported. They are evaluated in the context of the caller.
 
-Debug Printing
-==============
-
-Sometimes programs print so that users can see things, and sometimes they print
-so that develpopers can. ``say()`` is the API for standard printing functions. A
-parallel API, ``show()``, helps rapidly print the current state of variables. It
-enables "debugging print statements" that don't require the craptastic
-repetition of ``print "x = {x}".format(x)``. Instead, just::
-
-    show(x)
-    show(nums)
-    show(x, nums, len(nums))
-    
-yields::
-
-    x: 12
-    nums: [0, 1, 2, 3]
-    x: 12  nums: [0, 1, 2, 3]  len(nums): 4
-
-All of the standard keyword options for ``say()`` work for ``show()`` as well.
-If you'd like to see where the data is being produced, ``show.set(where=True)``
-will turn on location reporting.
-
-Sadly, because Python provides weaker introspection during
-interactive operation, (see e.g. `this <http://stackoverflow.com/questions/13204161/how-to-access-the-calling-source-line-from-interactive-shell>`_)
-``show()`` is somewhat limited in interactive use. It works at the main
-level and usually in imported modules, but does work within the body of functions defined
-interactively.
-
 Printing Where You Like
 =======================
 
 
  *  The ``say`` name was inspired by Perl's `say <http://perldoc.perl.org/functions/say.html>`_,
     but the similarity stops there.
+    
+ *  The ``show`` debug printing functions have been split into a separate package,
+    `show <http://pypi.python.org/pypi/show>`_.
    
- *  Automated multi-version testing with the wonderful
+ *  Automated multi-version testing is managed with the wonderful
     `pytest <http://pypi.python.org/pypi/pytest>`_
-    and `tox <http://pypi.python.org/pypi/tox>`_ modules has commenced. ``say`` is now
+    and `tox <http://pypi.python.org/pypi/tox>`_. ``say`` is now
     successfully packaged for, and tested against, all late-model verions of
     Python: 2.6, 2.7, 3.2, and 3.3, as well as PyPy 1.9 (based on 2.7.2).
  
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.