From: Eli Zaretskii <eliz@gnu.org>
Date: Sat, 14 Jan 2023 08:52:06 +0000 (+0200)
Subject: ; * etc/PROBLEMS: Describe problems with MuPDF 1.21.  (Bug#60308)
X-Git-Tag: emacs-29.0.90~739
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=f102145d381f975e937dd4512a2ac53af604be4a;p=emacs.git

; * etc/PROBLEMS: Describe problems with MuPDF 1.21.  (Bug#60308)
---

diff --git a/etc/PROBLEMS b/etc/PROBLEMS
index 1b796b11caf..69c42e9bed0 100644
--- a/etc/PROBLEMS
+++ b/etc/PROBLEMS
@@ -628,6 +628,18 @@ To work around the problem, customize the option
 'window-adjust-process-window-size-function' to "Do not adjust process
 window sizes" (Lisp value 'ignore').
 
+*** Displaying PDF files in DocView produces an empty buffer.
+
+This can happen if your Emacs is configured to convert PDF to SVG for
+display, and the version of the MuPDF package you have installed has a
+a known bug, whereby it sometimes produces invalid SVG images.
+Version 1.21 of MuPDF is known to be affected.
+
+The solution is either to upgrade or downgrade to a version of MuPDF
+that doesn't have this bug, or to disable conversion of PDF files to
+SVG images by customizing the user option 'doc-view-mupdf-use-svg'.
+Emacs will then convert PDF to PNG images instead.
+
 *** In Inferior Python mode, input is echoed and native completion doesn't work.
 <https://debbugs.gnu.org/cgi/bugreport.cgi?bug=25753>