From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Juri Linkov Newsgroups: gmane.emacs.bugs Subject: bug#38601: describe-mode never says the most important thing Date: Mon, 16 Dec 2019 23:36:24 +0200 Organization: LINKOV.NET Message-ID: <874ky0p24n.fsf@mail.linkov.net> References: <87d0crpzxg.5.fsf@jidanni.org> <23f279f3-f2a6-6327-b1eb-0d167cdfad22@orcon.net.nz> <877e2xtfkk.fsf@fliptop.i-did-not-set--mail-host-address--so-tickle-me> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="156903"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (x86_64-pc-linux-gnu) Cc: Tomas Nordin , 38601@debbugs.gnu.org To: Phil Sainty Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Dec 16 23:53:17 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1igzEp-000ef4-T8 for geb-bug-gnu-emacs@m.gmane.org; Mon, 16 Dec 2019 23:53:16 +0100 Original-Received: from localhost ([::1]:33006 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1igzEo-0002x8-Gb for geb-bug-gnu-emacs@m.gmane.org; Mon, 16 Dec 2019 17:53:14 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:33096) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1igzEf-0002ug-LI for bug-gnu-emacs@gnu.org; Mon, 16 Dec 2019 17:53:06 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1igzEe-0002dA-IB for bug-gnu-emacs@gnu.org; Mon, 16 Dec 2019 17:53:05 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:34510) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1igzEe-0002cT-F2 for bug-gnu-emacs@gnu.org; Mon, 16 Dec 2019 17:53:04 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1igzEe-00070N-Ch for bug-gnu-emacs@gnu.org; Mon, 16 Dec 2019 17:53:04 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Juri Linkov Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 16 Dec 2019 22:53:04 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 38601 X-GNU-PR-Package: emacs Original-Received: via spool by 38601-submit@debbugs.gnu.org id=B38601.157653675826800 (code B ref 38601); Mon, 16 Dec 2019 22:53:04 +0000 Original-Received: (at 38601) by debbugs.gnu.org; 16 Dec 2019 22:52:38 +0000 Original-Received: from localhost ([127.0.0.1]:40466 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1igzED-0006yC-Sq for submit@debbugs.gnu.org; Mon, 16 Dec 2019 17:52:38 -0500 Original-Received: from bonobo.elm.relay.mailchannels.net ([23.83.212.22]:35931) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1igzEC-0006y4-8Q for 38601@debbugs.gnu.org; Mon, 16 Dec 2019 17:52:36 -0500 X-Sender-Id: dreamhost|x-authsender|jurta@jurta.org Original-Received: from relay.mailchannels.net (localhost [127.0.0.1]) by relay.mailchannels.net (Postfix) with ESMTP id C2430141EFB; Mon, 16 Dec 2019 22:52:34 +0000 (UTC) Original-Received: from pdx1-sub0-mail-a19.g.dreamhost.com (100-96-89-10.trex.outbound.svc.cluster.local [100.96.89.10]) (Authenticated sender: dreamhost) by relay.mailchannels.net (Postfix) with ESMTPA id 096F0141F00; Mon, 16 Dec 2019 22:52:34 +0000 (UTC) X-Sender-Id: dreamhost|x-authsender|jurta@jurta.org Original-Received: from pdx1-sub0-mail-a19.g.dreamhost.com ([TEMPUNAVAIL]. [64.90.62.162]) (using TLSv1.2 with cipher DHE-RSA-AES256-GCM-SHA384) by 0.0.0.0:2500 (trex/5.18.5); Mon, 16 Dec 2019 22:52:34 +0000 X-MC-Relay: Neutral X-MailChannels-SenderId: dreamhost|x-authsender|jurta@jurta.org X-MailChannels-Auth-Id: dreamhost X-Name-Interest: 037c26d1591e05f9_1576536754270_1541069724 X-MC-Loop-Signature: 1576536754270:1708730243 X-MC-Ingress-Time: 1576536754269 Original-Received: from pdx1-sub0-mail-a19.g.dreamhost.com (localhost [127.0.0.1]) by pdx1-sub0-mail-a19.g.dreamhost.com (Postfix) with ESMTP id 844D27F035; Mon, 16 Dec 2019 14:52:28 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=linkov.net; h=from:to:cc :subject:references:date:in-reply-to:message-id:mime-version :content-type; s=linkov.net; bh=cfGv/++kagHfOe4rGiquNhyIu58=; b= 0rqf1k3/H0cuAKTeRMwGgCRxpjB7sPGuaS+aJBPg2htZkWz4g0WZdyx7zmiaip13 FlhJSXpvhePlWwDic1TPyaA362ve2Ftt3+7XDhwfZxmpYq25WGG41uJXCIGuvMc0 T6+6/wPwhLYNtxvf8rl0NZh7ahxW3e2/qAdhBQe3Hec= Original-Received: from mail.jurta.org (m91-129-107-186.cust.tele2.ee [91.129.107.186]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) (Authenticated sender: jurta@jurta.org) by pdx1-sub0-mail-a19.g.dreamhost.com (Postfix) with ESMTPSA id 2EFE17EFC4; Mon, 16 Dec 2019 14:52:23 -0800 (PST) X-DH-BACKEND: pdx1-sub0-mail-a19 In-Reply-To: (Phil Sainty's message of "Mon, 16 Dec 2019 11:32:24 +1300") X-VR-OUT-STATUS: OK X-VR-OUT-SCORE: -100 X-VR-OUT-SPAMCAUSE: gggruggvucftvghtrhhoucdtuddrgedufedrvddtiedgtdegucetufdoteggodetrfdotffvucfrrhhofhhilhgvmecuggftfghnshhusghstghrihgsvgdpffftgfetoffjqffuvfenuceurghilhhouhhtmecufedttdenucesvcftvggtihhpihgvnhhtshculddquddttddmnecujfgurhephffvufhofhffjgfkfgggtgesthdtredttdertdenucfhrhhomheplfhurhhiucfnihhnkhhovhcuoehjuhhriheslhhinhhkohhvrdhnvghtqeenucfkphepledurdduvdelrddutdejrddukeeinecurfgrrhgrmhepmhhouggvpehsmhhtphdphhgvlhhopehmrghilhdrjhhurhhtrgdrohhrghdpihhnvghtpeeluddruddvledruddtjedrudekiedprhgvthhurhhnqdhprghthheplfhurhhiucfnihhnkhhovhcuoehjuhhriheslhhinhhkohhvrdhnvghtqedpmhgrihhlfhhrohhmpehjuhhriheslhhinhhkohhvrdhnvghtpdhnrhgtphhtthhopehpshgrihhnthihsehorhgtohhnrdhnvghtrdhniienucevlhhushhtvghrufhiiigvpedu 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: 209.51.188.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:173452 Archived-At: >>> (I do think there's an argument for showing the mode symbol rather >>> than a capitalised variant of the name in the `describe-mode' help; >>> but that's a different conversation.) >> >> A different conversation but I didn't see that so I take the >> opportunity to agree here. The capitalized variants of the command >> name was always confusing to me -- is it the command name, only >> with a big letter in the beginning, or is it some sort of doxy >> description that is not the same as the command name. Easy to check, >> but anyway. > > For the major mode it's just the `mode-name' value. > > For the minor modes it's the symbol name, sans "-minor-mode"/"-mode", > passed through `capitalize': "foo-bar-mode" becomes "Foo-Bar". At least, minor modes have links to their Help buffers where the symbol name is displayed and available for e.g. copying etc, but the major mode has no such link in the `describe-mode' help, that's the problem that should be fixed.