From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: martin rudalics 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 09:43:01 +0100 Message-ID: <86e81f5d-f00a-2f23-afc7-f3f26f26cbdb@gmx.at> References: <87v8zp8510.fsf@laposte.net> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="5402"; mail-complaints-to="usenet@ciao.gmane.io" 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 09:44:15 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 1mxmN5-0001Dz-Je for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 16 Dec 2021 09:44:15 +0100 Original-Received: from localhost ([::1]:39296 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mxmN3-0008Ev-TQ for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 16 Dec 2021 03:44:13 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:33960) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mxmMs-0008Ef-W4 for bug-gnu-emacs@gnu.org; Thu, 16 Dec 2021 03:44:03 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:51174) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mxmMs-000363-OF for bug-gnu-emacs@gnu.org; Thu, 16 Dec 2021 03:44:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1mxmMs-0002s7-GI for bug-gnu-emacs@gnu.org; Thu, 16 Dec 2021 03:44:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: martin rudalics Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 16 Dec 2021 08:44:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 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.163964419510956 (code B ref -1); Thu, 16 Dec 2021 08:44:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 16 Dec 2021 08:43:15 +0000 Original-Received: from localhost ([127.0.0.1]:34487 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mxmM7-0002qe-HF for submit@debbugs.gnu.org; Thu, 16 Dec 2021 03:43:15 -0500 Original-Received: from lists.gnu.org ([209.51.188.17]:40942) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mxmM1-0002qQ-Fg for submit@debbugs.gnu.org; Thu, 16 Dec 2021 03:43:14 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:33766) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mxmM1-0008BV-9V for bug-gnu-emacs@gnu.org; Thu, 16 Dec 2021 03:43:09 -0500 Original-Received: from mout.gmx.net ([212.227.17.20]:54287) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mxmLy-00030g-8i for bug-gnu-emacs@gnu.org; Thu, 16 Dec 2021 03:43:09 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=badeba3b8450; t=1639644184; bh=yQM6/qokP0GMrq+vu4w5sOQ/gQf4HKOH5xk5cyYWCcc=; h=X-UI-Sender-Class:Subject:To:References:From:Date:In-Reply-To; b=Y3qXUzTDuz2yOghOw+Cs+j5PQQYNhZXKP7uTTBnvDtJXuCW1pCFJ7Gz6+V65zwmTy UHFjKLMMe4f65Adu0GCyDOcnw9U2bgR2EFbSSncC9rNzBRoMQOBc/d5uqMm/vsSgdJ HG2j+5x4hoUN/1y1YFYxmqdUSZ7ENWxyixvJWGDI= X-UI-Sender-Class: 01bb95c1-4bf8-414a-932a-4f6e2808ef9c Original-Received: from [192.168.1.101] ([213.142.96.21]) by mail.gmx.net (mrgmx105 [212.227.17.168]) with ESMTPSA (Nemesis) id 1MuDXp-1mf8bi3A33-00ud7I for ; Thu, 16 Dec 2021 09:43:04 +0100 In-Reply-To: <87v8zp8510.fsf@laposte.net> Content-Language: en-US X-Provags-ID: V03:K1:sc3HK/ODLXYN02meUndclbgJOhEAKFTLWyXQ3PU6yu19gTp8sj5 ClOR47YlBID/FQ9uOY776i7nder1CM7tQiAqx+yEiH//fTiiGeNTg6O5hkSxY7wDDBmujc+ 6RNwW8+SjLZuMxx90q1RcUSuzeOKU4tt8e9HBzwJWVxp/6qqi7xz8H9yVdE36DQOp3OfECv 79muL6Fbkn9IEFxeon9Rg== X-UI-Out-Filterresults: notjunk:1;V03:K0:NT0K2yvt/gY=:284UHVmuJ6qnwOoTNtvj86 3LqzhHoZRSk9/SkYev8G1sR2W+r0Q4BUE/dP8fR+Lw0L3PpSZ72vNdyVxBAu2zpHfpjkRMK+O NbfxtOCXj6JwKQMNgeCj+gRbYPC54llB2EtdU3AoKF2IuY6nC/95TSmEt9RjDC/2gNItb91JJ ePgNtWO0R3Mfu0bD6WJMHmMyH7NlacJDABCPxUrC7bMdSSaNBo1hPRmPUVEPq4HJ505NLNrL/ IWqpTttZRN71hv8NLI2NXL2ITytMmgndb6oVC/G/dLhCMjkZf7VQr9gm6gzRAjnXOWFK7tCgX X8HWWINW3enuXmxJBRIm4Pxof+AiOPLubmz26hMLGXjlYGdfbeGM1LqaqyaUDnvW/w4OdLc52 B0sjq/tjZBRT6It1W9oTub/e/DaNH3ftdvS0aTfDa+1Aj2hLi3/tgSASmM4UeCkn30pel3qFx N0tWji2AzUb1PLmHRdxFyHaFqKfCGDkHpqAEPSE9xiT3eZGsfoRga4RDEXxVnTu5AHaefRyXB TZVTzo+xWvgpgLy4DOtw+iIkp5Iw2x82Y+RT9sSUcUFyON3fzmOVguRRzBcNXm09p8ZzGXTCq o2Yrsco9NcW8ZhSljj4Km0PCU6JI1nhqaG7VoAKdQIBU/yj8t/yTGaeUHIf92Mqs7EE9a4i+w UiRyCGTVKrljC4YoUujMBhIm8Agxbs1PQ2Mi5y3HWPyLgugC5T6oFLURvi8MUFqJTPAx7CuRZ kqWPDh5ejAYTaUjCpT0c6c/GeHzOhOuCo/99ReybszleXxid4cJCiQ1u6CZLrTBGX/Pw95Ej Received-SPF: pass client-ip=212.227.17.20; envelope-from=rudalics@gmx.at; helo=mout.gmx.net X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 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:222470 Archived-At: > In the Emacs Lisp Reference Manual, section 29.14 Child Frames, This is section 30.14 in Emacs 28. > 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 = pixels at the top > of the frame that always remain visible<< within the parent=E2=80=99s = native 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. Although the description is not overly exhaustive, I cannot see an error here. When I do (set-frame-parameter nil 'top-visible 100) for a child frame with a header line and mouse-drag that frame via the header line towards the bottom edge of its parent frame, at least 100 pixels of that frame will remain visible. > The =E2=80=98bottom-visible=E2=80=99 parameter > specifies the >>number of pixels at the bottom of the frame that alway= s > remain visible<< within the parent=E2=80=99s native frame during dragg= ing and > should be preferred when specifying a non-=E2=80=98nil=E2=80=99 =E2=80= =98drag-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. Which has become section 30.4.3.7 in Emacs 28. > #+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. Do you mean this part should be mentioned in section 30.14 too ... > Moreover, as many pixels of the frame as specified by that numbe= r > 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= parameter 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 ne= ver > appears below the bottom edge<< of its display or parent frame. =2E.. and also this part? > Moreover, as many pixels of the frame as specified by that numbe= r > 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 = parameter 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 t= op > (bottom) edge of the native frame of the parent frame: this is the rol= e > of =E2=80=98top-visible=E2=80=99 (=E2=80=98bottom-visible=E2=80=99) pa= rameter. Please elaborate: Is it "just" that these two parts are missing from the Child Frames section (in which case I will happily add them there) or is there a more intrinsic error in that section? Thanks, martin