Improve user guidance regarding ``--resultlog`` deprecation

Fix #2739

1 files changed, 7 insertions, 0 deletions

diff --git a/doc/en/usage.rst b/doc/en/usage.rst
index 9360a8ed2..a8c6d40a0 100644
--- a/doc/en/usage.rst
+++ b/doc/en/usage.rst
@@ -311,6 +311,13 @@ Creating resultlog format files
 
     This option is rarely used and is scheduled for removal in 4.0.
 
+    An alternative for users which still need similar functionality is to use the
+    `pytest-tap <https://pypi.python.org/pypi/pytest-tap>`_ plugin which provides
+    a stream of test data.
+
+    If you have any concerns, please don't hesitate to
+    `open an issue <https://github.com/pytest-dev/pytest/issues>`_.
+
 To create plain-text machine-readable result files you can issue::
 
     pytest --resultlog=path