[py-svn] r8122 - py/dist/py/documentation

[hpk at codespeak.net]

Author: hpk
Date: Fri Jan  7 00:46:19 2005
New Revision: 8122

Modified:
   py/dist/py/documentation/test.txt
Log:
added a warning about cusotmizihng py.test at deeper levels 


Modified: py/dist/py/documentation/test.txt
==============================================================================
--- py/dist/py/documentation/test.txt	(original)
+++ py/dist/py/documentation/test.txt	Fri Jan  7 00:46:19 2005
@@ -424,6 +424,11 @@
 Customizing the collection process in a module
 ---------------------------------------------- 
 
+*Warning: details of the collection process are subject to refactorings 
+and thus details may change.  If you are customizing py.test at 
+"Item" level then you definitely want to be subscribed to
+the `py-dev mailing list`_.*
+
 If you have a module where you want to take responsibility for
 collecting your own test Items and possibly even for executing
 a test then you can provide `generative tests`_ that yield 
@@ -441,7 +446,7 @@
 to determine appropriate collectors at ``Directory``, ``Module`` 
 or ``Class`` level by looking for these very names. 
 
-When providing ``Items`` you have to deal with ``py.path.extpy()`` 
+When providing ``Items`` you may have to deal with ``py.path.extpy()`` 
 paths.  In general, an extpy-path allows to address a python object 
 on a filesystem.  *Addressability of test Items* is a major concern 
 because we want to memorize failing tests across py.test invocations.  
@@ -469,3 +474,4 @@
   allow classes to simply mean "grouping" of tests. 
 
 .. _`getting started`: getting_started.html
+.. _`py-dev mailing list`: http://codespeak.net/mailman/listinfo/py-dev