[py-svn] r65822 - in py/trunk/doc: . announce test

[hpk at codespeak.net]

Author: hpk
Date: Fri Jun 19 12:24:11 2009
New Revision: 65822

Modified:
   py/trunk/doc/announce/release-1.0.0.txt
   py/trunk/doc/download.txt
   py/trunk/doc/index.txt
   py/trunk/doc/test/extend.txt
Log:
merge to svn 


Modified: py/trunk/doc/announce/release-1.0.0.txt
==============================================================================
--- py/trunk/doc/announce/release-1.0.0.txt	(original)
+++ py/trunk/doc/announce/release-1.0.0.txt	Fri Jun 19 12:24:11 2009
@@ -6,8 +6,7 @@
 Welcome to the 1.0.0 py lib release - a python library aiming
 to support agile and test-driven development.  
 
-It passes tests against Linux, OSX and Win32, on Python 
-2.3, 2.4, 2.5 and 2.6.
+It works with Linux, OSX and Win32, on Python 2.3, 2.4, 2.5 and 2.6.
 
 Main API/Tool Features: 
 

Modified: py/trunk/doc/download.txt
==============================================================================
--- py/trunk/doc/download.txt	(original)
+++ py/trunk/doc/download.txt	Fri Jun 19 12:24:11 2009
@@ -2,6 +2,8 @@
 Downloading
 ==============
 
+Latest Release: 1.0.0b2
+
 "easy_install py"
 ===================================================
 

Modified: py/trunk/doc/index.txt
==============================================================================
--- py/trunk/doc/index.txt	(original)
+++ py/trunk/doc/index.txt	Fri Jun 19 12:24:11 2009
@@ -1,6 +1,8 @@
 py lib: Main tools and APIs
 ===================================
 
+Latest Release: 1.0.0b2
+
 `py.test`_ write and deploy unit- and functional tests to multiple machines. 
 
 `py.execnet`_ rapidly deploy local or remote processes from your program. 

Modified: py/trunk/doc/test/extend.txt
==============================================================================
--- py/trunk/doc/test/extend.txt	(original)
+++ py/trunk/doc/test/extend.txt	Fri Jun 19 12:24:11 2009
@@ -8,11 +8,11 @@
 hooks`_.  Python modules which contain such hook functions are called 
 plugins.  Hook functions are discovered in ``conftest.py`` files or
 in **named** plugins.  ``conftest.py`` files are sometimes called "anonymous"
-or "local" plugins if they contain hooks.  They allow to write and distribute
-some extensions along with the test suite or the application package easily. 
-Named plugins are python modules or packages that have an all lowercase 
-``pytest_`` prefixed name and who are imported during tool startup or 
-the testing process.  
+or conftest plugins. They are useful for keeping test extensions close
+to the application package.  Named plugins are normal python modules or packages 
+that can be distributed separately.   Named plugins need to follow a naming pattern;
+they have an all lowercase ``pytest_`` prefixed name.  While conftest plugins are
+discovered automatically, named plugins must be explicitely specified. 
 
 .. _`tool startup`:
 .. _`test tool starts up`: 
@@ -61,7 +61,7 @@
 --------------------------------------------------
 
 The purpose of ``conftest.py`` files is to allow `project-specific 
-test configuration`_.  But they also make for a good place to implement 
+test configuration`_.  They thus make for a good place to implement 
 project-specific test related features through hooks.  For example you may 
 set the `collect_ignore`_ variable depending on a command line option
 by defining the following hook in a ``conftest.py`` file:
@@ -91,7 +91,9 @@
 strict checking on contained hook functions.  Function and argument names 
 need to match exactly one of `hook definition specification`_. It thus 
 provides useful error reporting on mistyped hook or argument names
-and minimizes version incompatibilites. 
+and minimizes version incompatibilites.  Below you find some introductory 
+information on particular hooks.  It's sensible to look at existing 
+plugins so see example usages and start off with your own plugin. 
 
 .. _`hook definition specification`: http://bitbucket.org/hpk42/py-trunk/src/tip/py/test/plugin/hookspec.py