refine release announcement

doc/Makefile

@@ -39,8 +39,8 @@ help:
 clean:
 	-rm -rf $(BUILDDIR)/*
 
-install: html
+install: clean html
-	rsync -avz _build/html/ code:public_html/pytest
+	rsync -avz _build/html/ code:www-pytest/2.0.0
 
 html:
 	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html

doc/announce/release-2.0.0.txt

@@ -1,24 +1,23 @@
-py.test 2.0.0: standalone, features++, implementation++, docs++
+py.test 2.0.0: improved asserts, unittest, reporting, config, docs
 ===========================================================================
 
-XXX PENDING
+Welcome to pytest-2.0.0, a major new release of "py.test", the rapid
+easy Python testing tool.  There are many new features and a lot of
+long-deprecated code is removed, resulting in a much smaller and cleaner
+implementation.  If you had a test suite using non-deprecated
+functionality 2.0.0 is very likely to continue to work for you without
+requiring changes.
 
-Welcome to pytest-2.0.0, rapid and easy testing for and with Python.
+Check out the revised the improved documentation and examples:
-py.test now comes as its own PyPI distribution named ``pytest`` which
-installs the ``py.test`` tool.  It removes most long-deprecated code,
-providing for a much smaller and easier to understand code base.  There
-are also many new features and much improved documentation. See
 
-    http://pytest.org
+    http://pytest.org/2.0.0/index.html
-
-for details or below for some more information.
 
 Thanks to all issue reporters and people asking questions or
 complaining.  Particular thanks to Floris Bruynooghe and Ronny Pfannschmidt
-for their great coding contributions.
+for their great coding contributions and may others for feedback and help.
 
 best,
-holger
+holger krekel
 
 
 New Features
@@ -30,7 +29,7 @@ New Features
 
   or from a python program::
 
-    import pytest ; pytest.main(args, plugins)
+    import pytest ; pytest.main(arglist, pluginlist)
 
   see http://pytest.org/2.0.0/usage.html for details.
 
@@ -48,14 +47,17 @@ New Features
 
   see http://pytest.org/2.0.0/customize.html
 
-- improved standard unittest support.  For example you can now run
+- improved standard unittest support.  In general py.test should now
-  the tests of an installed 'unittest' package with py.test::
+  better run custom TestCases like twisted trial or Django based
+  TestCases.  Also you can now run the tests of an installed
+  'unittest' package with py.test::
 
     py.test --pyargs unittest
 
 - new "-q" option which decreases verbosity and prints a more
   nose/unittest-style "dot" output.
 
+- many more improvements in details
 
 Fixes
 -----------------------
@@ -72,14 +74,24 @@ Fixes
 - fix bug: unittest collected functions now also can have "pytestmark"
   applied at class/module level
 
-Important Note on importing "pytest" versus "py.test"
+Notes
--------------------------------------------------------
+--------------------
 
-The usual way in pre-2.0 times to use py.test in python code was
+* The usual way in pre-2.0 times to use py.test in python code was
-to import "py" and then e.g. use "py.test.raises" for the helper.
+  to import "py" and then e.g. use "py.test.raises" for the helper.
-This remains valid and is not planned to be deprecated.  However,
+  This remains valid and is not planned to be deprecated.  However,
-in most examples and internal code you'll find "import pytest"
+  in most examples and internal code you'll find "import pytest"
-and "pytest.raises" used as the recommended default way.
+  and "pytest.raises" used as the recommended default way.
+
+* pytest now first performs collection of the complete test suite
+  before running any test. This changes for example the semantics of when
+  pytest_collectstart/pytest_collectreport are called.  Some plugins may
+  need upgrading.
+
+* The pytest package consists of a 400 LOC core.py and about 20 builtin plugins,
+  summing up to roughly 5000 LOCs, including docstrings. To be fair, it also
+  uses generic code from the "pylib", and the new "py" package to help
+  with filesystem and introspection/code manipulation.
 
 (Incompatible) Removals
 -----------------------------
@@ -99,7 +111,7 @@ and "pytest.raises" used as the recommended default way.
 
 - py.test.collect.Directory does not exist anymore and it
   is not possible to provide an own "Directory" object.
-  If you have used this and don#t know what to do, get
+  If you have used this and don't know what to do, get
   in contact.  We'll figure someting out.
 
   Note that pytest_collect_directory() is still called but

doc/conf.py

@@ -51,7 +51,9 @@ copyright = u'2010, holger krekel et aliter'
 # The short X.Y version.
 version = '2.0.0'
 # The full version, including alpha/beta/rc tags.
-release = '2.0.0dev0'
+import py, pytest
+assert py.path.local().relto(py.path.local(pytest.__file__).dirpath().dirpath())
+release = pytest.__version__
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.