From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#46702: Link symbol name in Help Date: Wed, 24 Feb 2021 19:05:54 +0200 Message-ID: <837dmxtmz1.fsf@gnu.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> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="13058"; mail-complaints-to="usenet@ciao.gmane.io" Cc: laszlomail@protonmail.com, 46702@debbugs.gnu.org To: Lars Ingebrigtsen Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Wed Feb 24 18:26:53 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 1lExw4-0003He-8b for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 24 Feb 2021 18:26:52 +0100 Original-Received: from localhost ([::1]:56114 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lExw3-0004Ce-BG for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 24 Feb 2021 12:26:51 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:46260) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lExcu-00025i-6o for bug-gnu-emacs@gnu.org; Wed, 24 Feb 2021 12:07:04 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:52490) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1lExcs-0001LY-Ez for bug-gnu-emacs@gnu.org; Wed, 24 Feb 2021 12:07:03 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1lExcs-0007lk-8q for bug-gnu-emacs@gnu.org; Wed, 24 Feb 2021 12:07:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 24 Feb 2021 17:07: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.161418638129815 (code B ref 46702); Wed, 24 Feb 2021 17:07:02 +0000 Original-Received: (at 46702) by debbugs.gnu.org; 24 Feb 2021 17:06:21 +0000 Original-Received: from localhost ([127.0.0.1]:35803 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lExcD-0007kp-HB for submit@debbugs.gnu.org; Wed, 24 Feb 2021 12:06:21 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:56470) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lExcC-0007kb-FT for 46702@debbugs.gnu.org; Wed, 24 Feb 2021 12:06:20 -0500 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:37776) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lExc7-0001AV-7z; Wed, 24 Feb 2021 12:06:15 -0500 Original-Received: from 84.94.185.95.cable.012.net.il ([84.94.185.95]:1374 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1lExc2-0006dW-Cl; Wed, 24 Feb 2021 12:06:14 -0500 In-Reply-To: <875z2h766y.fsf@gnus.org> (message from Lars Ingebrigtsen on Wed, 24 Feb 2021 17:59:17 +0100) 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:200743 Archived-At: > From: Lars Ingebrigtsen > Cc: Peter Dean , 46702@debbugs.gnu.org > Date: Wed, 24 Feb 2021 17:59:17 +0100 > > Eli Zaretskii writes: > > > I think we are splitting hair and painting the bike shed here. > > Indeed, so I've just removed the "Documentation:" line. This makes the > output both more compact and less awkward to read, in my opinion. I think this change may require rewording the beginning of the doc strings. E.g., look at this random sample: resize-mini-windows is a variable defined in ‘C source code’. Its value is ‘grow-only’ 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’t automatically resize mini-windows. A value of t means resize them to fit the text displayed in them. A value of ‘grow-only’, the default, means let mini-windows 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.