[Checkins] SVN: zope.pytest/trunk/README.txt Markup fixes, minor corrections.

[Uli Fouquet]

Log message for revision 120766:
  Markup fixes, minor corrections.
  

Changed:
  U   zope.pytest/trunk/README.txt

-=-
Modified: zope.pytest/trunk/README.txt
===================================================================
--- zope.pytest/trunk/README.txt	2011-03-05 15:22:31 UTC (rev 120765)
+++ zope.pytest/trunk/README.txt	2011-03-05 15:28:42 UTC (rev 120766)
@@ -4,22 +4,25 @@
 Introduction
 ============
 
-This package contains a set of helper functions to test zope/grok using pytest
+This package contains a set of helper functions to test Zope/Grok
+using `pytest`_. It currently lacks special support for doctesting.
 
+
 Core functions
 ==============
 
-zope.pytest.setup.create_app
+`zope.pytest.setup.create_app`
 
- * this function creates a wsgi app object which utilize a temporary db.
+ * this function creates a WSGI app object which utilizes a temporary db.
 
-zope.pytest.setup.configure
+`zope.pytest.setup.configure`
 
- * this function parses zcml file and initialize the component registry
+ * this function parses ZCML files and initializes the component registry
 
 
 Simple example::
 
+    import my.project
     from zope.pytest import create_app, configure
     from my.project import Root
 
@@ -30,7 +33,7 @@
         return configure(request, my.project, 'ftesting.zcml')
 
     def test_hello(app, config):
-        pass
+        assert 1 == 1
 
 Documentation
 =============
@@ -38,3 +41,5 @@
 Complete documentation can be found on
 
 http://packages.python.org/zope.pytest
+
+.. _pytest: http://pytest.org/