Update documentation and NEWS with SVG changes (bug#77841)

* doc/lispref/display.texi (SVG Images):
* etc/NEWS: Document changes to SVG foreground color handling.

2 files changed, 12 insertions, 1 deletions

diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index 25ef83935c1..d044763523b 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -6502,7 +6502,7 @@ properties:
 @table @code
 @item :foreground @var{foreground}
 @var{foreground}, if non-@code{nil}, should be a string specifying a
-color, which is used as the image's foreground color.  If the value is
+color, which is used as the CSS `currentcolor' value.  If the value is
 @code{nil}, it defaults to the current face's foreground color.
 
 @item :background @var{background}
diff --git a/etc/NEWS b/etc/NEWS
index f4e64c0851f..11b5b38fa9c 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -511,6 +511,17 @@ or strings.  If set to 'on-mismatch', mismatched parens inside comments
 and strings will not be highlighted.  If set to nil (the default),
 highlight the parens wherever they are.
 
+** Change in SVG foreground color handling.
+SVG images no longer have the 'fill' attribute set to the value of
+':foreground' or the current text foreground color.  The 'currentcolor'
+CSS attribute continues to be set as before.
+
+This change should result in more consistent display of SVG images.
+
+To use the :foreground or current text color ensure the 'fill' attribute
+in the SVG is set to 'currentcolor', or set the image spec's ':css'
+value to 'svg {fill: currentcolor;}'.
+
 
 * Editing Changes in Emacs 31.1