From: Eli Zaretskii <eliz@gnu.org>
Date: Sat, 14 Jan 2023 08:26:40 +0000 (+0200)
Subject: Disable and document 'doc-view-mupdf-use-svg' (bug#58041)
X-Git-Tag: emacs-29.0.90~740
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=79971ebacc7ea114cbb9210d3505a576c95b2964;p=emacs.git

Disable and document 'doc-view-mupdf-use-svg' (bug#58041)

* lisp/doc-view.el (doc-view-mupdf-use-svg): Disable by default.
* etc/NEWS: Document.  Patch by Visuwesh <visuweshm@gmail.com>.
Do not merge to master.
---

diff --git a/etc/NEWS b/etc/NEWS
index 08c7f8a4dd6..fa28ba465f8 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -1636,6 +1636,20 @@ randomness as before, or to use a bag).
 *** New user option 'battery-update-functions'.
 This can be used to trigger actions based on the battery status.
 
+** DocView
+
+*** doc-view can now generate SVG images when viewing PDF files.
+If Emacs is built with SVG support, doc-view can generate SVG files
+when using MuPDF as the converter for PDF files, which generally leads
+to sharper images (especially when zooming), and allows customization
+of background and foreground color of the page via the new user
+options 'doc-view-svg-background' and 'doc-view-svg-foreground'.  To
+activate this behaviour, set 'doc-view-mupdf-use-svg' to non-nil if
+your Emacs has SVG support.  Note that, with some versions of MuPDF,
+SVG generation is known to sometimes produce SVG files that are buggy
+or can take a long time to render.
+
+
 ** Enriched Mode
 
 +++
diff --git a/lisp/doc-view.el b/lisp/doc-view.el
index 7c272f52fb3..427da557d23 100644
--- a/lisp/doc-view.el
+++ b/lisp/doc-view.el
@@ -209,8 +209,8 @@ are available (see Info node `(emacs)Document View')."
           function)
   :version "24.4")
 
-(defcustom doc-view-mupdf-use-svg (image-type-available-p 'svg)
-  "Whether to use svg images for PDF files."
+(defcustom doc-view-mupdf-use-svg nil
+  "Whether to use SVG images for PDF files."
   :type 'boolean
   :version "29.1")