Commits

Jonathan Eunice  committed bb0efa5

doc tweaks

  • Participants
  • Parent commits dad0bfc

Comments (0)

Files changed (2)

 assume. ``Text`` objects have both ``text`` and ``lines`` properties which
 can be either accessed or assigned to.
     
-In the example above, the``+=`` assignment isn't strictly necessary; the
-``Text(...)`` constructor will itself accept a string or set of lines. If you
-want to preserve leading white space (no dedent), you can use the ``|=``
-operator instead. Or, if you don't want the string iterpreted at all, use
+In the example above, the ``+=`` assignment shows how text can be incrementally
+added, but it isn't strictly necessary in this instance, because the
+``Text(...)`` constructor can itself accept a string or set of lines.
+
+Other in-place operators are available. If you
+want to preserve leading white space (no dedent), use ``|=``.
+If you don't want the string iterpreted at all, use
 ``&=``. There is a ``read_from`()` method as well as the demonstrated
 ``write_to()``.
 
  *  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,
+ *  The ``show`` debug printing functions previously in this package
+    have been split into a separate package,
     `show <http://pypi.python.org/pypi/show>`_.
+    
+ *  A new text aggregation class, ``Text`` is now available.
    
  *  Automated multi-version testing is managed with the wonderful
     `pytest <http://pypi.python.org/pypi/pytest>`_
     Python: 2.6, 2.7, 3.2, and 3.3, as well as PyPy 1.9 (based on 2.7.2).
  
  *  ``say`` has greater ambitions than just simple template printing. It's part
-    of a larger rethinking of how output should be formatted. ``show()``
-    is an initial down-payment. Stay tuned for more.
+    of a larger rethinking of how output should be formatted. ``show()`` and ``Text``
+    are down-payments on this larger vision. Stay tuned for more.
  
  *  In addition to being a practical module in its own right, ``say`` is
     testbed for `options <http://pypi.python.org/pypi/options>`_, a package
 
 setup(
     name='say',
-    version=verno("0.869"),
+    version=verno("0.871"),
     author='Jonathan Eunice',
     author_email='jonathan.eunice@gmail.com',
     description='Super-simple templated printing. E.g.: say("Hello, {whoever}!", indent=1)',