Source

say / README.rst

Diff from to

File README.rst

     print "There are {} things.".format(x)
     print "Nums has {} items: {}".format(len(nums), nums)
     
-(NB in Python 2.6
-one must number each of the ``{}`` placeholders--e.g. ``"Nums has {0} items: {1}"``--
-in order to avoid a ``ValueError: zero length field name in format`` error. Python 2.7
-and later assume the placeholders are sequential.)
+(NB in Python 2.6 one must number each of the ``{}`` placeholders--e.g. ``"Nums
+has {0} items: {1}"``-- in order to avoid a ``ValueError: zero length field name
+in format`` error. Python 2.7 and later assume the placeholders are sequential.)
     
 The more items that are being printed, and the complicated the ``format``
 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.
 
-There is also a built-in facility, ``show()``, for outputing the current state of
-variables. It is designed for "debugging print statements" that don't require the
-craptastic repetition of ``print "x = {x}".format(x)``. Instead, just::
+``say()`` is the API for standard printing functions. A parallel API,
+``show()``, is for 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)
     x: 12  nums: [0, 1, 2, 3]  len(nums): 4
 
 All of the standard keyword options for ``say()`` work for ``show()`` as well.
-It's a very quick way of adding in debug printing statements.
 
 Printing Where You Like
 =======================