From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Lars Ingebrigtsen Newsgroups: gmane.emacs.bugs Subject: bug#46702: Link symbol name in Help Date: Thu, 25 Feb 2021 16:15:03 +0100 Message-ID: <87tuq041s8.fsf@gnus.org> References: <874ki4kuy8.fsf@gnus.org> <838s7gw0zf.fsf@gnu.org> <87y2ffeqh0.fsf@gnus.org> <83im6jv4we.fsf@gnu.org> <83blcavlzp.fsf@gnu.org> <87lfbda1ms.fsf@gnus.org> <83eeh5to93.fsf@gnu.org> <875z2h766y.fsf@gnus.org> <837dmxtmz1.fsf@gnu.org> 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="34381"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) Cc: laszlomail@protonmail.com, 46702@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Feb 25 16:16:45 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 1lFINh-0008nG-2p for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 25 Feb 2021 16:16:45 +0100 Original-Received: from localhost ([::1]:49986 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lFINg-0001jZ-4I for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 25 Feb 2021 10:16:44 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:44502) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lFIN0-0001EO-V8 for bug-gnu-emacs@gnu.org; Thu, 25 Feb 2021 10:16:02 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:55674) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1lFIN0-00084S-OF for bug-gnu-emacs@gnu.org; Thu, 25 Feb 2021 10:16:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1lFIN0-0004cH-Ka for bug-gnu-emacs@gnu.org; Thu, 25 Feb 2021 10:16:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 25 Feb 2021 15:16:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 46702 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: fixed Original-Received: via spool by 46702-submit@debbugs.gnu.org id=B46702.161426611617642 (code B ref 46702); Thu, 25 Feb 2021 15:16:02 +0000 Original-Received: (at 46702) by debbugs.gnu.org; 25 Feb 2021 15:15:16 +0000 Original-Received: from localhost ([127.0.0.1]:38979 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lFIMF-0004aU-LU for submit@debbugs.gnu.org; Thu, 25 Feb 2021 10:15:15 -0500 Original-Received: from quimby.gnus.org ([95.216.78.240]:54676) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lFIMD-0004aD-Jd for 46702@debbugs.gnu.org; Thu, 25 Feb 2021 10:15:14 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnus.org; s=20200322; h=Content-Transfer-Encoding:Content-Type:MIME-Version:Message-ID :In-Reply-To:Date:References:Subject:Cc:To:From:Sender:Reply-To:Content-ID: Content-Description:Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc :Resent-Message-ID:List-Id:List-Help:List-Unsubscribe:List-Subscribe: List-Post:List-Owner:List-Archive; bh=HlquHUrBrwjHgxcwUS+1gVZW4O9HJIyCZRvsc2+0JPg=; b=q7mJsEexPtOtH1F5QYzEBze0fG 4wgefGX5YIlak9PaOtBI2Ixngy5fV1vzPU38z4sa1v4Zy5TtZ2ZrK1bZ67fMdE4tA94E6SWnA75D8 j2bf6vrSt1MI3ruZ+5HOpF7GroxVWcsoGNi/52ZJDEg1kfMEm35rKP3Ij+cP/xYXSBvM=; Original-Received: from cm-84.212.220.105.getinternet.no ([84.212.220.105] helo=xo) by quimby.gnus.org with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1lFIM4-0000fS-Hz; Thu, 25 Feb 2021 16:15:07 +0100 Face: iVBORw0KGgoAAAANSUhEUgAAADAAAAAwAgMAAAAqbBEUAAAABGdBTUEAALGPC/xhBQAAACBj SFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAADFBMVEWsWEigk2I7Jh7/ ///Ow/J8AAAAAWJLR0QDEQxM8gAAAAd0SU1FB+UCGQ8FOm2rAS4AAAFvSURBVCjPXdKxSsRAEAbg PyER2SpKFvQqFYUjTxFBQayi3FhYWecpcodapIqFjdUqQTb/Uzq7uUMxRcKXmcnO7AYoUbHDfFmR NsA4hQQ4JPRJPcNr6nQR0q5bMu05+W0NDfX6h3e5q8gqoAPp5VZvQOXA/kXuuemk1gXIF1mRa6nP ZojhgcQ0H5EoPHpnZWV8Io1GDp02VPlcmtAhGtg37+RJscZlubrzsGGINaxtLrvjKzHPOEcu98mQ p6XiVOd7SIYihemwrGEfUoeISqe42rhkr1O0QJ69urwojDbewZZ7Y6n7g5BpmwXLLKDVJuqFjlxo daszpgHPYVgir8MGVyx0uCFpdINlyVFfjBHIqkkjE8AI6pNaorPARHTff8BJYZESfYQfcJLuIt9D 5nZoP0YsEeDJx37CzQynn570jCN8wDiDXDAuNOMInJ52OPnip3boEc5Wi5zfRjZc/kLPlV/7SLcR w8xvoX9LiBv+AJmh1aT6MaJrAAAAJXRFWHRkYXRlOmNyZWF0ZQAyMDIxLTAyLTI1VDE1OjA1OjU4 KzAwOjAw3GOQMAAAACV0RVh0ZGF0ZTptb2RpZnkAMjAyMS0wMi0yNVQxNTowNTo1OCswMDowMK0+ KIwAAAAASUVORK5CYII= X-Now-Playing: Casino Music's _Jungle Love_: "C'est Extraordinaire" In-Reply-To: <837dmxtmz1.fsf@gnu.org> (Eli Zaretskii's message of "Wed, 24 Feb 2021 19:05:54 +0200") 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:200784 Archived-At: Eli Zaretskii writes: > Its value is =E2=80=98grow-only=E2=80=99 > > You can customize this variable. > This variable was introduced, or its default value was changed, in > version 25.1 of Emacs. > Probably introduced at or before Emacs version 21.1. > > How to resize mini-windows (the minibuffer and the echo area). > A value of nil means don=E2=80=99t automatically resize mini-windows. > A value of t means resize them to fit the text displayed in them. > A value of =E2=80=98grow-only=E2=80=99, the default, means let mini-win= dows grow only; > they return to their normal size when the minibuffer is closed, or the > echo area becomes empty. > > The "How to resize mini-windows..." part begins "out of the blue". > It's actually incorrect English (incomplete sentence), AFAIK. It > reads okay-ish when the first line is alone, or when the text follows > some heading, like "Documentation:", but that is gone now. I don't think the "Documentation:" line helps much here, though. It's just an awkward first line. We've previously discussed rearranging the function/variable output in a more "readerly" way -- for instance, it's odd that the block of indented things come before the doc string, because those indented things aren't what's most vital for normal users to know. But even if the buffer started with: resize-mini-windows is a variable defined in =E2=80=98C source code=E2=80= =99. How to resize mini-windows (the minibuffer and the echo area). A value of nil means don=E2=80=99t automatically resize mini-windows. It'd still be an awkward doc string, because it's just an awkward semi-sentence. --=20 (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no