From: Lars Ingebrigtsen <larsi@gnus.org>
Date: Thu, 24 Mar 2022 08:59:40 +0000 (+0100)
Subject: Mention frame-text-* function in frame-pixel-* doc strings
X-Git-Tag: emacs-29.0.90~1931^2~944
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=9856290806a449d35380135adabd607b6612dd98;p=emacs.git

Mention frame-text-* function in frame-pixel-* doc strings

* src/frame.c (Fframe_native_width, Fframe_native_height): Link to
`frame-text-*' functions.
---

diff --git a/src/frame.c b/src/frame.c
index 8f8df8f8e0d..e531891a8a3 100644
--- a/src/frame.c
+++ b/src/frame.c
@@ -3495,7 +3495,10 @@ DEFUN ("frame-native-width", Fframe_native_width,
        Sframe_native_width, 0, 1, 0,
        doc: /* Return FRAME's native width in pixels.
 For a terminal frame, the result really gives the width in characters.
-If FRAME is omitted or nil, the selected frame is used.  */)
+If FRAME is omitted or nil, the selected frame is used.
+
+If you're interested only in the width of the text portion of the
+frame, see `frame-text-width' instead.  */)
   (Lisp_Object frame)
 {
   struct frame *f = decode_any_frame (frame);
@@ -3519,6 +3522,9 @@ minibuffer or echo area), mode line, and header line.  It does not
 include the tool bar or menu bar.  With other graphical versions, it may
 also include the tool bar and the menu bar.
 
+If you're interested only in the height of the text portion of the
+frame, see `frame-text-height' instead.
+
 For a text terminal, it includes the menu bar.  In this case, the
 result is really in characters rather than pixels (i.e., is identical
 to `frame-height'). */)