Fix genscript deprecation version and document reasons for such

This commit is contained in:
Bruno Oliveira 2015-12-01 22:57:01 -02:00
parent 095abfd035
commit 5040dde0c5
1 changed files with 15 additions and 1 deletions

View File

@ -250,7 +250,21 @@ is equivalent to running ``py.test --durations=5``.
(deprecated) Create a pytest standalone script
-----------------------------------------------
.. deprecated:: 2.7
.. deprecated:: 2.8
.. note::
``genscript`` has been deprecated because:
* It cannot support plugins, rendering its usefulness extremely limited;
* Tooling has become much better since ``genscript`` was introduced;
* It is possible to build a zipped ``pytest`` application without the
shortcomings above (this will be documented in more detail in a later
version of this documentation).
There's no planned version in which this command will be removed
at the moment of this writing, but its use is discouraged for new
applications.
If you are a maintainer or application developer and want people
who don't deal with python much to easily run tests you may generate