From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Alan Mackenzie Newsgroups: gmane.emacs.bugs Subject: bug#51590: follow-mode is broken with header-line and tab-line Date: Mon, 8 Nov 2021 17:59:44 +0000 Message-ID: References: <86bl31xfl9.fsf@mail.linkov.net> <83h7ctgk93.fsf@gnu.org> <86pmrf3l9m.fsf_-_@mail.linkov.net> <835yt7g3my.fsf@gnu.org> <8335o9dazn.fsf@gnu.org> <83bl2xbhz1.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="7062"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 51590@debbugs.gnu.org, juri@linkov.net To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Mon Nov 08 19:00:14 2021 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1mk8wI-0001eh-7O for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 08 Nov 2021 19:00:14 +0100 Original-Received: from localhost ([::1]:46190 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mk8wH-0005h6-1X for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 08 Nov 2021 13:00:13 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:38208) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mk8w7-0005gb-59 for bug-gnu-emacs@gnu.org; Mon, 08 Nov 2021 13:00:04 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:47829) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mk8w6-0005ZF-TD for bug-gnu-emacs@gnu.org; Mon, 08 Nov 2021 13:00:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1mk8w6-0007ON-RT for bug-gnu-emacs@gnu.org; Mon, 08 Nov 2021 13:00:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Alan Mackenzie Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 08 Nov 2021 18:00:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 51590 X-GNU-PR-Package: emacs Original-Received: via spool by 51590-submit@debbugs.gnu.org id=B51590.163639439328359 (code B ref 51590); Mon, 08 Nov 2021 18:00:02 +0000 Original-Received: (at 51590) by debbugs.gnu.org; 8 Nov 2021 17:59:53 +0000 Original-Received: from localhost ([127.0.0.1]:59369 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mk8vx-0007NL-EV for submit@debbugs.gnu.org; Mon, 08 Nov 2021 12:59:53 -0500 Original-Received: from colin.muc.de ([193.149.48.1]:57912 helo=mail.muc.de) by debbugs.gnu.org with smtp (Exim 4.84_2) (envelope-from ) id 1mk8vv-0007N3-6N for 51590@debbugs.gnu.org; Mon, 08 Nov 2021 12:59:52 -0500 Original-Received: (qmail 21265 invoked by uid 3782); 8 Nov 2021 17:59:44 -0000 Original-Received: from acm.muc.de (p4fe15aa5.dip0.t-ipconnect.de [79.225.90.165]) (using STARTTLS) by colin.muc.de (tmda-ofmipd) with ESMTP; Mon, 08 Nov 2021 18:59:44 +0100 Original-Received: (qmail 7502 invoked by uid 1000); 8 Nov 2021 17:59:44 -0000 Content-Disposition: inline In-Reply-To: <83bl2xbhz1.fsf@gnu.org> X-Submission-Agent: TMDA/1.3.x (Ph3nix) X-Primary-Address: acm@muc.de X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:219369 Archived-At: Hello, Eli and Martin. On Sat, Nov 06, 2021 at 14:12:50 +0200, Eli Zaretskii wrote: > > Date: Sat, 6 Nov 2021 11:50:48 +0000 > > Cc: juri@linkov.net, 51590@debbugs.gnu.org > > From: Alan Mackenzie [ .... ] > > OK. But I think there's confusion in the manual and doc strings, and > > even the code, and that it's not just me. This confusion being the meanings of "window body" and "window text area", in particular as to whether or not they include any header line or tab line. > _After_ my today's changes? If so, please show where is the confusing > text. I've done a survey of window.c, keyboard.c, window.el for all occurrences of "text area" and "body" in function names, doc strings, some comments, and parameter names. The source I've grepped is an almost up to date copy of the emacs-28 branch. The function name is at the left, followed by annotations for text area and body. "BIG" means the term includes the header and tab lines, "small" means it does not, "?" means it is not immediately clear, blank means it is irrelevant or not mentioned. Function Text Area Body -------- --------- ---- Fwindow_body_width Fwindow_body_height small (small) Fwindow_old_body_pixel_width Fwindow_old_body_pixel_height ? Fwindow_lines_pixel_dimensions confused. Fwindow_text_height small Fset_window_fringes window_body_height small window_body_width window_change_record_windows ? run_window_change_functions Vwindow_size_change_functions Vwindow_state_change_functions Vwindow_state_change_hook Vwindow_configuration_change_hook make_lispy_position small make_lispy_event ? read_key_sequence small Fposn_at_x_y BIG window-body-size ? window-edges ? ? window-absolute-body-pixel-edges ? ? window-largest-empty-rectangle ? window-preserve-size ? window-body-edges ? window-body-pixel-edges ? It seems clear that, at least in the places where the meaning of "text area" and "body" are clear, that they refer to the area which doesn't include the header line and tab line. Fposn_at_x_y stands out as the only function with BIG. Maybe the picture would change on examining the elisp manual. Maybe some of the unclear annotations would resolve to BIG, but that doesn't seem all that likely. Given this, it seems it would be better to amend the documentation of Fposn_at_x_y to refer to the "text area _plus_ any header line or tab line". -- Alan Mackenzie (Nuremberg, Germany).