added a pytest_helpconfig plugin which groups --version and the new "--help-config" option. rename options and configuration names. streamlines docs.

--HG--
branch : 1.0.x

doc/test/plugin/capture.txt

@@ -38,7 +38,7 @@ You can influence output capturing mechanisms from the command line::
 If you set capturing values in a conftest file like this::
 
     # conftest.py
-    conf_capture = 'fd'
+    option_capture = 'fd'
 
 then all tests in that directory will execute with "fd" style capturing. 
 

doc/test/plugin/helpconfig.txt

@@ -0,0 +1,31 @@
+
+pytest_helpconfig plugin
+========================
+
+provide version info, conftest/environment config names.
+
+.. contents::
+  :local:
+
+
+
+command line options
+--------------------
+
+
+``--help-config``
+    show available conftest.py and ENV-variable names.
+``--version``
+    display py lib version and import information.
+
+Start improving this plugin in 30 seconds
+=========================================
+
+
+1. Download `pytest_helpconfig.py`_ plugin source code 
+2. put it somewhere as ``pytest_helpconfig.py`` into your import path 
+3. a subsequent ``py.test`` run will use your local version
+
+Checkout customize_, other plugins_ or `get in contact`_. 
+
+.. include:: links.txt

doc/test/plugin/index.txt

@@ -1,6 +1,6 @@
 
-Plugins related to Python test functions and programs
-=====================================================
+plugins for Python test functions
+=================================
 
 xfail_ mark python test functions as expected-to-fail and report them separately.
 
@@ -13,7 +13,7 @@ capture_ configurable per-test stdout/stderr capturing mechanisms.
 recwarn_ helpers for asserting deprecation and other warnings.
 
 
-Plugins for other testing styles and languages
+plugins for other testing styles and languages
 ==============================================
 
 oejskit_ run javascript tests in real life browsers
@@ -27,7 +27,7 @@ doctest_ collect and execute doctests from modules and test files.
 restdoc_ perform ReST syntax, local and remote reference tests on .rst/.txt files.
 
 
-Plugins for generic reporting and failure logging
+plugins for generic reporting and failure logging
 =================================================
 
 pastebin_ submit failure or test session information to a pastebin service.
@@ -37,8 +37,20 @@ resultlog_ resultlog plugin for machine-readable logging of test results.
 terminal_ Implements terminal reporting of the full testing process.
 
 
-internal plugins / core functionality
-=====================================
+plugins for generic reporting and failure logging
+=================================================
+
+pastebin_ submit failure or test session information to a pastebin service.
+
+resultlog_ resultlog plugin for machine-readable logging of test results.
+
+terminal_ Implements terminal reporting of the full testing process.
+
+
+misc plugins / core functionality
+=================================
+
+helpconfig_ provide version info, conftest/environment config names.
 
 pdb_ interactive debugging with the Python Debugger.
 

doc/test/plugin/links.txt

@@ -1,3 +1,4 @@
+.. _`helpconfig`: helpconfig.html
 .. _`terminal`: terminal.html
 .. _`pytest_recwarn.py`: http://bitbucket.org/hpk42/py-trunk/raw/1.0.1/py/test/plugin/pytest_recwarn.py
 .. _`unittest`: unittest.html
@@ -15,6 +16,7 @@
 .. _`pytest_figleaf.py`: http://bitbucket.org/hpk42/py-trunk/raw/1.0.1/py/test/plugin/pytest_figleaf.py
 .. _`pytest_hooklog.py`: http://bitbucket.org/hpk42/py-trunk/raw/1.0.1/py/test/plugin/pytest_hooklog.py
 .. _`checkout the py.test development version`: ../../download.html#checkout
+.. _`pytest_helpconfig.py`: http://bitbucket.org/hpk42/py-trunk/raw/1.0.1/py/test/plugin/pytest_helpconfig.py
 .. _`oejskit`: oejskit.html
 .. _`doctest`: doctest.html
 .. _`get in contact`: ../../contact.html