From: Po Lu <luangruo@yahoo.com>
Date: Mon, 16 May 2022 09:28:36 +0000 (+0800)
Subject: Document recent tooltip changes on NS
X-Git-Tag: emacs-29.0.90~1910^2~649
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=1f76f50a049bcbd43ff2c0dbe1e73b6fa5efc8b5;p=emacs.git

Document recent tooltip changes on NS

* doc/emacs/frames.texi (Tooltips):
* etc/NEWS: Announce that non-system tooltips are now available
on Nextstep.
---

diff --git a/doc/emacs/frames.texi b/doc/emacs/frames.texi
index 7c564a87763..0008112b8c8 100644
--- a/doc/emacs/frames.texi
+++ b/doc/emacs/frames.texi
@@ -1651,11 +1651,15 @@ For additional customization options for displaying tooltips, use
 @kbd{M-x customize-group @key{RET} tooltip @key{RET}}.
 
 @vindex use-system-tooltips
-  If Emacs is built with the GTK+ toolkit or Haiku windowing support,
-it displays tooltips via the toolkit, using the default appearance of
-the toolkit's tooltips.  To disable this, change the variable
+  If Emacs is built with the GTK+ toolkit, Nextstep windowing, or
+Haiku windowing support, it displays tooltips via the toolkit, using
+the default appearance of the toolkit's tooltips.@footnote{The
+foreground and background colors of toolkit-created tooltips on
+Nextstep can also be customized by setting the @code{foreground} and
+@code{background} frame parameters inside
+@code{tooltip-frame-parameters}} To disable this, change the variable
 @code{use-system-tooltips} to @code{nil}.  If you do this, or if Emacs
-is built without GTK+ or Haiku windowing support, most attributes of
+is built without the appropriate windowing support, most attributes of
 the tooltip text are specified by the @code{tooltip} face, and by X
 resources (@pxref{X Resources}).
 
diff --git a/etc/NEWS b/etc/NEWS
index c53b896edd2..c0874dcd115 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -391,10 +391,16 @@ instead of XIM input methods.
 ** New user option 'use-system-tooltips'.
 This controls whether to use the toolkit tooltips, or Emacs's own
 native implementation of tooltips as small frames.  This option is
-only meaningful if Emacs was built with GTK+ or Haiku support, and
-defaults to t, which makes Emacs use the toolkit tooltips.  The
-existing GTK-specific option 'x-gtk-use-system-tooltips' is now an
-alias of this new option.
+only meaningful if Emacs was built with GTK+, Nextstep, or Haiku
+support, and defaults to t, which makes Emacs use the toolkit
+tooltips.  The existing GTK-specific option
+'x-gtk-use-system-tooltips' is now an alias of this new option.
+
++++
+** Non-native tooltips are now supported on Nextstep.
+This means Emacs built with GNUstep or built on macOS is now able to
+display different faces and images inside tooltips when the
+'use-system-tooltips' variable is nil.
 
 ** Connection-local variables