adding a release announcement and some doc fixes

CHANGELOG

@@ -1,6 +1,8 @@
-Unreleased
+2.5.1
 -----------------------------------
 
+- merge new documentation styling PR from Tobias Bieniek.
+
 - fix issue403: allow parametrize of multiple same-name functions within
   a collection node.  Thanks Andreas Kloeckner and Alex Gaynor for reporting
   and analysis.
@@ -16,6 +18,7 @@ Unreleased
   optparse. Thanks Daniel D. Wright.
 
 
+
 2.5.0
 -----------------------------------
 

doc/en/_templates/links.html

@@ -3,7 +3,7 @@
   <li><a href="{{ pathto('index') }}">The pytest Website</a></li>
   <li><a href="https://pypi.python.org/pypi/pytest">pytest @ PyPI</a></li>
   <li><a href="https://bitbucket.org/hpk42/pytest/">pytest @ Bitbucket</a></li>
-  <li><a href="https://bitbucket.org/hpk42/pytest/issues">Issue Tracker</a></li>
+  <li><a href="https://bitbucket.org/hpk42/py/issues?status=new&status=open">Issue Tracker</a></li>
   <li><a href="http://pytest.org/latest/pytest.pdf">PDF Documentation</a>
 </ul>
 

doc/en/announce/index.txt

@@ -5,6 +5,7 @@ Release announcements
 .. toctree::
    :maxdepth: 2
 
+   release-2.5.1
    release-2.5.0
    release-2.4.2
    release-2.4.1

doc/en/announce/release-2.5.1.txt

@@ -0,0 +1,45 @@
+pytest-2.5.1: fixes and new home page styling
+===========================================================================
+
+pytest-2.5.1, a mature testing tool with more than a 1000 tests 
+against itself, maintains the "zero-reported-bugs" promise by fixing
+the three bugs reported since the last release a few days ago.  It also 
+features a new home page styling implemented by Tobias Bieniek, based on
+original work from Armin Ronacher.  Check it out:
+
+    http://pytest.org
+
+If you have anything more to improve styling and docs, 
+we'd be very happy to merge further pull requests.
+
+On the coding side, the release also contains a little enhancement to
+fixture decorators allowing to directly influence generation of test
+ids, thanks to Floris Bruynooghe.  Other thanks for helping with 
+this release also go to Anatoly Bubenkoff and Ronny Pfannschmidt.
+
+As usual, you can upgrade from pypi via::
+
+    pip install -U pytest
+
+have fun and a nice remaining time of the year!
+holger krekel
+
+2.5.1
+-----------------------------------
+
+- merge new documentation styling PR from Tobias Bieniek.
+
+- fix issue403: allow parametrize of multiple same-name functions within
+  a collection node.  Thanks Andreas Kloeckner and Alex Gaynor for reporting
+  and analysis.
+
+- Allow parameterized fixtures to specify the ID of the parameters by
+  adding an ids argument to pytest.fixture() and pytest.yield_fixture().
+  Thanks Floris Bruynooghe. 
+
+- fix issue404 by always using the binary xml escape in the junitxml
+  plugin.  Thanks Ronny Pfannschmidt.
+
+- fix issue407: fix addoption docstring to point to argparse instead of
+  optparse. Thanks Daniel D. Wright.
+

doc/en/fixture.txt

@@ -626,6 +626,7 @@ into an ini-file::
     usefixtures = cleandir
 
 
+.. _`autouse`:
 .. _`autouse fixtures`:
 
 autouse fixtures (xUnit setup on steroids)

doc/en/goodpractises.txt

@@ -69,7 +69,7 @@ Important notes relating to both schemes:
 
 - **avoid "__init__.py" files in your test directories**.
   This way your tests can run easily against an installed version 
-  of ``mypkg``, independently from if the installed version contains 
+  of ``mypkg``, independently from if the installed package contains 
   the tests or not.  
 
 - With inlined tests you might put ``__init__.py`` into test 
@@ -96,16 +96,14 @@ required configurations.
 .. note::
 
     You can use Python3 namespace packages (PEP420) for your application
-    but pytest will still perform `package name`_ discovery based on the
+    but pytest will still perform `test package name`_ discovery based on the
-    presence of ``__init__.py`` files.  If you use one of the above
+    presence of ``__init__.py`` files.  If you use one of the 
-    two recommended file system layouts but leave away the ``__init__.py``
+    two recommended file system layouts above but leave away the ``__init__.py``
-    files it should just work on Python3.3 and above.  When using 
+    files from your directories it should just work on Python3.3 and above.  From 
     "inlined tests", however, you will need to use absolute imports for
-    getting at your application code because the test modules will be
+    getting at your application code.
-    imported directly, without any application context.  The latter allows
-    your tests to run against an installed version of your package.
 
-.. _`package name`:
+.. _`test package name`:
 
 .. note::
 

doc/en/index.txt

@@ -9,44 +9,43 @@ pytest: helps you write better programs
 **a mature full-featured Python testing tool**
 
  - runs on Posix/Windows, Python 2.5-3.3, PyPy and Jython-2.5.1
+ - **zero-reported-bugs** policy with >1000 tests against itself
+ - **strict backward compatibility policy** for safe pytest upgrades
  - :ref:`comprehensive online <toc>` and `PDF documentation <pytest.pdf>`_
- - many :ref:`third party plugins <extplugins>` and 
+ - many :ref:`third party plugins <extplugins>`, 
-   :ref:`builtin helpers <pytest helpers>`
+   :ref:`builtin helpers <pytest helpers>`, 
- - used in :ref:`many projects and organisations <projects>`, in test
+ - used in :ref:`many small and large projects and organisations <projects>`
-   suites with up to twenty thousand tests
- - strict policy of remaining backward compatible across releases
  - comes with many :ref:`tested examples <examples>`
 
 **provides easy no-boilerplate testing**
 
  - makes it :ref:`easy to get started <getstarted>`, 
-   many :ref:`usage options <usage>`
+   has many :ref:`usage options <usage>`
  - :ref:`assert with the assert statement`
  - helpful :ref:`traceback and failing assertion reporting <tbreportdemo>`
- - allows :ref:`print debugging <printdebugging>` and :ref:`the
+ - :ref:`print debugging <printdebugging>` and :ref:`the
    capturing of standard output during test execution <captures>`
 
 **scales from simple unit to complex functional testing**
 
  - :ref:`modular parametrizeable fixtures <fixture>` (new in 2.3,
-   improved in 2.4)
+   continously improved)
  - :ref:`parametrized test functions <parametrized test functions>`
  - :ref:`mark`
  - :ref:`skipping` (improved in 2.4)
- - can :ref:`distribute tests to multiple CPUs <xdistcpu>` through :ref:`xdist plugin <xdist>`
+ - :ref:`distribute tests to multiple CPUs <xdistcpu>` through :ref:`xdist plugin <xdist>`
- - can :ref:`continuously re-run failing tests <looponfailing>`
+ - :ref:`continuously re-run failing tests <looponfailing>`
  - flexible :ref:`Python test discovery`
 
-**integrates many common testing methods**:
+**integrates with other testing methods and tools**:
 
- - multi-paradigm: pytest can run many ``nose``, ``unittest.py`` and
+ - multi-paradigm: pytest can run ``nose``, ``unittest`` and 
-   ``doctest.py`` style test suites, including running testcases made for
+   ``doctest`` style test suites, including running testcases made for
    Django and trial
  - supports :ref:`good integration practises <goodpractises>`
  - supports extended :ref:`xUnit style setup <xunitsetup>`
  - supports domain-specific :ref:`non-python tests`
  - supports the generation of testing coverage reports
- - `Javascript unit- and functional testing`_
  - supports :pep:`8` compliant coding styles in tests
 
 **extensive plugin and customization system**:
@@ -56,8 +55,6 @@ pytest: helps you write better programs
  - it is easy to add command line options or customize existing behaviour
 
 
-.. _`Javascript unit- and functional testing`: http://pypi.python.org/pypi/oejskit
-
 .. _`easy`: http://bruynooghe.blogspot.com/2009/12/skipping-slow-test-by-default-in-pytest.html