From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.devel Subject: RE: Why isn't C-m listed here? Date: Mon, 16 Apr 2007 07:54:10 -0700 Message-ID: References: <87d524l7mx.fsf@catnip.gol.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: sea.gmane.org 1176735325 10101 80.91.229.12 (16 Apr 2007 14:55:25 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Mon, 16 Apr 2007 14:55:25 +0000 (UTC) To: Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Apr 16 16:55:19 2007 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1HdSbi-0004Ip-Kj for ged-emacs-devel@m.gmane.org; Mon, 16 Apr 2007 16:55:06 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1HdSgK-0003uk-QT for ged-emacs-devel@m.gmane.org; Mon, 16 Apr 2007 10:59:52 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1HdSgH-0003ud-B7 for emacs-devel@gnu.org; Mon, 16 Apr 2007 10:59:49 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1HdSgF-0003uP-20 for emacs-devel@gnu.org; Mon, 16 Apr 2007 10:59:48 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1HdSgE-0003uM-Tf for emacs-devel@gnu.org; Mon, 16 Apr 2007 10:59:46 -0400 Original-Received: from agminet01.oracle.com ([141.146.126.228]) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1HdSbb-0004f6-Ss for emacs-devel@gnu.org; Mon, 16 Apr 2007 10:55:00 -0400 Original-Received: from rgmgw1.us.oracle.com (rgmgw1.us.oracle.com [138.1.186.110]) by agminet01.oracle.com (Switch-3.2.4/Switch-3.1.7) with ESMTP id l3GEsupL011332 for ; Mon, 16 Apr 2007 09:54:57 -0500 Original-Received: from acsmt351.oracle.com (acsmt351.oracle.com [141.146.40.151]) by rgmgw1.us.oracle.com (Switch-3.2.4/Switch-3.1.7) with ESMTP id l3GEaWU8022784 for ; Mon, 16 Apr 2007 08:54:56 -0600 Original-Received: from dhcp-amer-csvpn-gw1-141-144-67-160.vpn.oracle.com by acsmt350.oracle.com with ESMTP id 2617216661176735268; Mon, 16 Apr 2007 07:54:28 -0700 X-Priority: 3 (Normal) X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook IMO, Build 9.0.6604 (9.0.2911.0) In-Reply-To: <87d524l7mx.fsf@catnip.gol.com> Importance: Normal X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.3028 X-Whitelist: TRUE X-Whitelist: TRUE X-Brightmail-Tracker: AAAAAQAAAAI= X-detected-kernel: Linux 2.4-2.6 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:69495 Archived-At: > > As the topic says: Why isn't C-m listed here: > > and if it was, what would its description be? Alias for ? > > It's not an alias for RET, it _is_ RET. > > RET == C-m It is good, but not enough, to teach others here (emacs-devel). Pointing something out here cannot be an alternative to the manual teaching the same thing or (in this case) facilitating access to the same information. Precisely because this user was missing that knowledge, C-m (and C-i, C-j, and so on) should appear explicitly in the index. And the index link should target a manual section where the equivalence is pointed out. In general (please don't follow up with "Where do you draw the line?"), when there are multiple names for the same thing, an index should provide corresponding multiple entries. That applies even for incorrect names and faux amis. Users look things up under different names, and they don't always think in terms of the standard terminology. That is why "paste" belongs in the index, pointing to a section about yanking, even though "paste" and "yank" are not exactly synonymous. It is why "window, window-manager" and "window-manager window" could also be index entries, pointing to a section that described Emacs frames and the term "frame". I'm sure (i.e. I hope) that I'm preaching to the choir on this, but it's unfortunately too easy to just answer a question here and not follow up by improving the manual. I must say that Eli is very diligent in thinking about what needs to be done to improve the manual. Practically every time a user mentions in help-gnu-emacs that s?he couldn't find something in the manual, Eli inquires about how to make manual lookup easier for that case. Kudos for that, Eli.