From 5bcbfcc6f0ce34082c6cc34b2dc95b58b2c1b58e Mon Sep 17 00:00:00 2001
From: Julian Smith <julian.smith@artifex.com>
Date: Fri, 11 Nov 2022 18:28:56 +0000
Subject: [PATCH] tests/README.md: added a note about test failure with
 non-default build of MuPDF.

---
 tests/README.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/tests/README.md b/tests/README.md
index 4f4764cb7..4842ff48f 100644
--- a/tests/README.md
+++ b/tests/README.md
@@ -79,3 +79,13 @@ TOTAL                                                      6714   1422    79%
 
 ============================ 79 passed in 5.76s ==============================
 ```
+
+## Known test failure with non-default build of MuPDF
+
+If PyMuPDF has been built with a non-default build of MuPDF (using
+environmental variable ``PYMUPDF_SETUP_MUPDF_BUILD``), it is possible that
+``tests/test_textbox.py:test_textbox3()`` will fail, because it relies on MuPDF
+having been built with PyMuPDF's customized configuration, ``fitz/_config.h``.
+
+One can skip this particular test by adding ``-k 'not test_textbox3'`` to the
+pytest command line.