From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Kevin Vigouroux via "Bug reports for GNU Emacs, the Swiss army knife of text editors" Newsgroups: gmane.emacs.bugs Subject: bug#52537: [DOC] =?UTF-8?Q?=E2=80=98top-visible=E2=80=99?= and =?UTF-8?Q?=E2=80=98bottom-visible=E2=80=99?= (erroneous indications) Date: Thu, 16 Dec 2021 06:58:35 +0100 Message-ID: <87v8zp8510.fsf@laposte.net> Reply-To: Kevin Vigouroux Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="36339"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.2 (gnu/linux) To: 52537@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Dec 16 07:03:16 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 1mxjrG-00098S-H1 for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 16 Dec 2021 07:03:14 +0100 Original-Received: from localhost ([::1]:51272 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mxjrF-0000ZU-FP for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 16 Dec 2021 01:03:13 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:33846) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mxjoA-0006l5-Oo for bug-gnu-emacs@gnu.org; Thu, 16 Dec 2021 01:00:02 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:50961) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mxjoA-0001oi-FJ for bug-gnu-emacs@gnu.org; Thu, 16 Dec 2021 01:00:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1mxjoA-0005gP-DM for bug-gnu-emacs@gnu.org; Thu, 16 Dec 2021 01:00:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Kevin Vigouroux Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 16 Dec 2021 06:00:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 52537 X-GNU-PR-Package: emacs X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.163963434121681 (code B ref -1); Thu, 16 Dec 2021 06:00:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 16 Dec 2021 05:59:01 +0000 Original-Received: from localhost ([127.0.0.1]:34274 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mxjnB-0005dZ-7J for submit@debbugs.gnu.org; Thu, 16 Dec 2021 00:59:01 -0500 Original-Received: from lists.gnu.org ([209.51.188.17]:48332) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mxjn5-0005dG-Sr for submit@debbugs.gnu.org; Thu, 16 Dec 2021 00:58:59 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:33582) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mxjn5-0005Zu-Fh for bug-gnu-emacs@gnu.org; Thu, 16 Dec 2021 00:58:55 -0500 Original-Received: from smtp-outgoing-1601.laposte.net ([160.92.124.96]:34116) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mxjmx-0001eW-JB for bug-gnu-emacs@gnu.org; Thu, 16 Dec 2021 00:58:55 -0500 X-mail-filterd: {"version":"1.3.4", "queueID":"4JF1d90bmWznTV2", "contextId":"6097ce3e-c9ff-4dcb-b2d9-046afa369b25"} Original-Received: from outgoing-mail.laposte.net (localhost.localdomain [127.0.0.1]) by mlpnf0113.laposte.net (SMTP Server) with ESMTP id 4JF1d90bmWznTV2 for ; Thu, 16 Dec 2021 06:58:37 +0100 (CET) X-mail-filterd: {"version":"1.3.4", "queueID":"4JF1d86QLTznTV1", "contextId":"bb999f2c-cc33-4534-b9c5-f7521b76369c"} X-lpn-mailing: LEGIT X-lpn-spamrating: 50 X-lpn-spamlevel: not-spam X-lpn-spamcause: OK, (0)(0000)gggruggvucftvghtrhhoucdtuddrgedvuddrleefgdekjecutefuodetggdotefrodftvfcurfhrohhfihhlvgemucfntefrqffuvffgpdggtfgfnhhsuhgsshgtrhhisggvnecuuegrihhlohhuthemuceftddtnecunecujfgurhephffvufffkfgfgggtgfesthhqredttderjeenucfhrhhomhepmfgvvhhinhcugghighhouhhrohhugicuoehkvgdrvhhighhouhhrohhugieslhgrphhoshhtvgdrnhgvtheqnecuggftrfgrthhtvghrnhepkeetveetvdevtdduudffvddvleduvedtffeliedtgeejfedtkeevjeehuefgudevnecukfhppedvrddugedrudeiiedrvdefleenucevlhhushhtvghrufhiiigvpedtnecurfgrrhgrmhepihhnvghtpedvrddugedrudeiiedrvdefledphhgvlhhopegrrhgrghhoghdpmhgrihhlfhhrohhmpehkvgdrvhhighhouhhrohhugieslhgrphhoshhtvgdrnhgvthdprhgtphhtthhopegsuhhgqdhgnhhuqdgvmhgrtghssehgnhhurdhorhhgpdhmohguvgepshhmthhpohhuth Original-Received: from aragog (arennes-652-1-268-239.w2-14.abo.wanadoo.fr [2.14.166.239]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mlpnf0113.laposte.net (SMTP Server) with ESMTPSA id 4JF1d86QLTznTV1 for ; Thu, 16 Dec 2021 06:58:36 +0100 (CET) Mail-Followup-To: bug-gnu-emacs@gnu.org DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=laposte.net; s=lpn-wlmd; t=1639634317; bh=4rgfQyqjlP1X3cZduEUvMZsEyqlGpjFP0oadt+3Tl7s=; h=From:To:Subject:Date:Message-ID:MIME-Version:Content-Type:Content-Transfer-Encoding; b=Qt2fcpmzVYunc/ncB/F516m6MABfcNE7xVxo8JjSoXySJJNUhLG/64HzLRBt/1DinzFOCSYWuBln0Tz4xfis/W+nqnOmfrtWdDfbloU2h9owJ+zKqVM/ZvseoBumVVeKzHHKrJlt7+R13NbeFDIqOUPrgXdFN4HJ56jAMBq5cMIVLmS1PObWLIpU7TdWoRPISsX0sOEX0pgKPIsWWhBvKJKNYCZk6NM4mZs7zD3NUpK9jmS6yC9sLKkGincH1sV+1sMxHKRX4GxhXixU1dmUOm7Z/4ZMdeUXL1wt8CvBEyp0ZG2ytlJNCX2GwHsFofU2IpQe5Keqxypboy9jhouGEA==; Received-SPF: pass client-ip=160.92.124.96; envelope-from=ke.vigouroux@laposte.net; helo=smtp-outgoing-1601.laposte.net X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, T_SPF_TEMPERROR=0.01 autolearn=ham autolearn_force=no X-Spam_action: no action 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:222461 Archived-At: In the Emacs Lisp Reference Manual, section 29.14 Child Frames, a paragraph contains some errors about =E2=80=98top-visible=E2=80=99 and =E2= =80=98bottom-visible=E2=80=99. #+begin_quote The =E2=80=98top-visible=E2=80=99 parameter specifies the >>number of pixel= s at the top of the frame that always remain visible<< within the parent=E2=80=99s nativ= e frame during dragging and should be set when specifying a non-=E2=80=98nil=E2=80= =99 =E2=80=98drag-with-header-line=E2=80=99 parameter. The =E2=80=98bottom-vis= ible=E2=80=99 parameter specifies the >>number of pixels at the bottom of the frame that always remain visible<< within the parent=E2=80=99s native frame during dragging a= nd should be preferred when specifying a non-=E2=80=98nil=E2=80=99 =E2=80=98dr= ag-with-mode-line=E2=80=99 parameter. #+end_quote The correct description is given in the Emacs Lisp Reference Manual, section 29.4.3.7 Mouse Dragging Parameters. #+begin_quote =E2=80=98top-visible=E2=80=99 If this parameter is a number, >>the top edge of the frame never appears above the top edge<< of its display or parent frame. Moreover, as many pixels of the frame as specified by that number will remain visible >>when the frame is moved against any of the remaining edges<< of its display or parent frame. Setting this parameter is useful to guard against dragging a child frame with a non-=E2=80=98nil=E2=80=99 =E2=80=98drag-with-header-line=E2=80=99 para= meter completely out of the area of its parent frame. =E2=80=98bottom-visible=E2=80=99 If this parameter is a number, >>the bottom edge of the frame never appears below the bottom edge<< of its display or parent frame. Moreover, as many pixels of the frame as specified by that number will remain visible >>when the frame is moved against any of the remaining edges<< of its display or parent frame. Setting this parameter is useful to guard against dragging a child frame with a non-=E2=80=98nil=E2=80=99 =E2=80=98drag-with-mode-line=E2=80=99 parame= ter completely out of the area of its parent frame. #+end_quote We may move the child frame with the mouse but not above (below) the top (bottom) edge of the native frame of the parent frame: this is the role of =E2=80=98top-visible=E2=80=99 (=E2=80=98bottom-visible=E2=80=99) paramet= er. --=20 Best regards, Kevin Vigouroux