From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: martin rudalics Newsgroups: gmane.emacs.bugs Subject: bug#30792: 26.0.91; improve docstring of with-help-window Date: Wed, 14 Mar 2018 09:14:33 +0100 Message-ID: <5AA8D9E9.2090204@gmx.at> References: <5AA7A52D.6060808@gmx.at> <83zi3brk6r.fsf@gnu.org> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-Trace: blaine.gmane.org 1521015203 18858 195.159.176.226 (14 Mar 2018 08:13:23 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Wed, 14 Mar 2018 08:13:23 +0000 (UTC) Cc: 30792@debbugs.gnu.org To: Nick Helm , Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Mar 14 09:13:18 2018 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ew1X8-0004fs-7G for geb-bug-gnu-emacs@m.gmane.org; Wed, 14 Mar 2018 09:13:14 +0100 Original-Received: from localhost ([::1]:44905 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ew1ZA-0004qw-Va for geb-bug-gnu-emacs@m.gmane.org; Wed, 14 Mar 2018 04:15:21 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:40042) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ew1Yx-0004ln-Tf for bug-gnu-emacs@gnu.org; Wed, 14 Mar 2018 04:15:10 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ew1Yu-0006F7-0Y for bug-gnu-emacs@gnu.org; Wed, 14 Mar 2018 04:15:07 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:52475) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1ew1Yt-0006F2-Tp for bug-gnu-emacs@gnu.org; Wed, 14 Mar 2018 04:15:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1ew1Ys-000827-KG for bug-gnu-emacs@gnu.org; Wed, 14 Mar 2018 04:15:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: martin rudalics Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 14 Mar 2018 08:15:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 30792 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 30792-submit@debbugs.gnu.org id=B30792.152101529630843 (code B ref 30792); Wed, 14 Mar 2018 08:15:02 +0000 Original-Received: (at 30792) by debbugs.gnu.org; 14 Mar 2018 08:14:56 +0000 Original-Received: from localhost ([127.0.0.1]:60371 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ew1Ym-00081O-1e for submit@debbugs.gnu.org; Wed, 14 Mar 2018 04:14:56 -0400 Original-Received: from mout.gmx.net ([212.227.15.18]:48245) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ew1Yk-00081A-C9 for 30792@debbugs.gnu.org; Wed, 14 Mar 2018 04:14:54 -0400 Original-Received: from [192.168.1.100] ([46.125.249.49]) by mail.gmx.com (mrgmx001 [212.227.17.190]) with ESMTPSA (Nemesis) id 0LzskF-1eaf4b0EBH-0150FT; Wed, 14 Mar 2018 09:14:42 +0100 In-Reply-To: X-Provags-ID: V03:K0:hGN2QR6PJ1vCtt4JHWwhKoW4p1CLQP9I57Djq2mWMUl+6CeJ0bw 3vgyvf3d7qtHVvdL2D6m457+aKHX70KgZQ+aN5Hed+nzbFnw4POx/AyyJ7g7zO1+7OT8IEe C7kX4iFdbQvr0JaqPMRMmaB/Z9A7HLvA4vm29OpjQS70oHgxAzPVkJ+DhI6q8ovR/JlABaB a8axT8aGHWZy9Sc5jXRZA== X-UI-Out-Filterresults: notjunk:1;V01:K0:twsDD8FIBgc=:StP3J1/lajlzIcaiFDGluF bc0qg+xHCrzTWORECntkr5wRRAdqToyrOV9wask0DsUEzRq16UG1LI956mqUW2LBOjN03lIWN 2XbwO5tIn0k+2hGZW6sdKyVcgnqBiNUi4/p288xoY6c/vQDQAC8M6ZmXPGich8p+d81leL+wP w90Mjnbv+ZE/weJlqm5rNKyPO+gY/OwsBT4Sb3GZLHE9bsoxW0ZGQ479BcPl+3y3QZCgGDdv1 fHGOrkTx06qSIn5ZawaH06ZYZmfUdUnFb+Kj2U1GqQGlHEEaxjSRabeAFsX7Jw81Uo+bJ6ar3 gxEPBzLSkVmCh3ZR2fyPcUKOYWXZfGcWEviMCezz6zOCcBgFPNhTc3mYZ2I/Z5ZHGSaDPir8s EnPSCT0RdBhk60AHo2VIz9ad/BghJi1dxOrrI+Ac/+3wwBD9wpiLvsUCOhhPMd3Ot/Y7bwncd EVhK2zKI/kEG6DEDnfnJtCJP/wuIxcXShBEg17x8f9QsRogviuhcfTb6pMND5iKS1AN+yYJq1 0o8mvkQ340qMUDKhLXJseAehNyMQowZhBzbPw1hST4xoNiayF4GckJIqzO3jKYkUFfnadTp+i TMn5CAuLDcyPgyM3w4poBexK/RI55RM7YyBXrr2pE+XPN2yrTf5bQM5OMS+aXD672wn9kJFBq Ya+5TbFs7fs/dWetOzF7H5cTlHIVe51ZTn3JGjcS87Lfu4HLiOC8nt59jetoEklyUAbwmXjT/ u8Eic13GsHFZqTYVv2muoELJuK+zCoGzCoz+PTzjSgsHKrwyIamJgVouBLsdnlAVFEieiQoC X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.43 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.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:144247 Archived-At: >> It strikes me that instead of repeating most of what >> with-temp-buffer-window's doc string says, it might be better to >> simply refer to there. Like this: >> >> Display the output produced by evaluating BODY, like >> `with-temp-buffer-window' does, then put the window in >> `help-mode' [...] Neither `with-temp-buffer-window' nor `help-mode' are of any relevance here. The distinctive aspect of `with-help-window' is provided by `help-window-setup' which sets up the help window for quitting it later. Earlier macros failed miserably in this regard. (I have to admit that many people are still ignorant of this fact and believe they could resolve the quitting problem by saving and restoring window configurations. So the old doc-string probably failed to provide this rather crucial information as well.) > +This construct is like `with-current-buffer-window' but unlike that IIUC it does not make the buffer current when running BODY. martin