From 5040dde0c546f28a439af4e0c598bab613d32863 Mon Sep 17 00:00:00 2001 From: Bruno Oliveira Date: Tue, 1 Dec 2015 22:57:01 -0200 Subject: [PATCH] Fix genscript deprecation version and document reasons for such --- doc/en/goodpractises.rst | 16 +++++++++++++++- 1 file changed, 15 insertions(+), 1 deletion(-) diff --git a/doc/en/goodpractises.rst b/doc/en/goodpractises.rst index fe3f41bd7..2359c562c 100644 --- a/doc/en/goodpractises.rst +++ b/doc/en/goodpractises.rst @@ -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