From ae61fa40409d5c3f6e0cb17f10e3d86c528a454a Mon Sep 17 00:00:00 2001
From: Ran Benita <ran@unusedvar.com>
Date: Sat, 19 Sep 2020 21:06:40 +0300
Subject: [PATCH] Merge pull request #7773 from
 nicoddemus/xml-properties-xdist-docs

Warning about record_testsuite_property not working with xdist

(cherry picked from commit 4e460cdd9e5966dfe3f505836055ed56249aea21)
---
 src/_pytest/junitxml.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/src/_pytest/junitxml.py b/src/_pytest/junitxml.py
index 8c68d196a..d1e98ad36 100644
--- a/src/_pytest/junitxml.py
+++ b/src/_pytest/junitxml.py
@@ -377,6 +377,12 @@ def record_testsuite_property(request: FixtureRequest) -> Callable[[str, object]
             record_testsuite_property("STORAGE_TYPE", "CEPH")
 
     ``name`` must be a string, ``value`` will be converted to a string and properly xml-escaped.
+
+    .. warning::
+
+        Currently this fixture **does not work** with the
+        `pytest-xdist <https://github.com/pytest-dev/pytest-xdist>`__ plugin. See issue
+        `#7767 <https://github.com/pytest-dev/pytest/issues/7767>`__ for details.
     """
 
     __tracebackhide__ = True