[Checkins] SVN: zope.pytest/trunk/doc/samples.rst Tell about (not-existing) doctest support.

[Uli Fouquet]

Log message for revision 120764:
  Tell about (not-existing) doctest support.
  

Changed:
  U   zope.pytest/trunk/doc/samples.rst

-=-
Modified: zope.pytest/trunk/doc/samples.rst
===================================================================
--- zope.pytest/trunk/doc/samples.rst	2011-03-05 10:52:10 UTC (rev 120763)
+++ zope.pytest/trunk/doc/samples.rst	2011-03-05 15:11:08 UTC (rev 120764)
@@ -63,7 +63,7 @@
 We prepared several such projects in the sources of :mod:`zope.pytest`
 (see ``sample_fixtures/`` in `zope.pytest`s ``tests/``
 directory). There we have different versions of a package called
-``mypkg`` which we will use here.
+``mypkg`` (or ``mypkg2`` or similar) which we will use here.
 
 .. doctest::
    :hide:
@@ -347,6 +347,16 @@
     >>> unregister_fixture(mypkg_dir)
 
 
+Writing and running doctests
+----------------------------
+
+:mod:`zope.pytest` currently has no specific support for
+doctesting. That means you can write and run regular doctests but
+there is currently no special hook or similar included for setting up
+Zope-geared environments/ZCML parsing and the like. We hope to provide
+doctest support in some future release.
+
+
 .. _ZCML: http://docs.zope.org/zopetoolkit/codingstyle/zcml-style.html
 .. _pytest: http://pytest.org/
 .. _py.test: http://pytest.org/