From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#3801: 23.0.96; Emacs manual: add index entry for "notation, keys" or "key notation" Date: Tue, 12 Jul 2011 09:27:55 -0700 Message-ID: <95D5526B48D74870BE3EFD9A49582EE2@us.oracle.com> References: <24283042333245E1B171C4CE64003E7B@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1310492084 30706 80.91.229.12 (12 Jul 2011 17:34:44 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Tue, 12 Jul 2011 17:34:44 +0000 (UTC) Cc: 3801@debbugs.gnu.org To: Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Jul 12 19:34:40 2011 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([140.186.70.17]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1Qggr2-0001l1-3w for geb-bug-gnu-emacs@m.gmane.org; Tue, 12 Jul 2011 19:34:40 +0200 Original-Received: from localhost ([::1]:47912 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Qggr0-0001lz-Nk for geb-bug-gnu-emacs@m.gmane.org; Tue, 12 Jul 2011 13:34:39 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]:59937) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QgfpZ-00019w-2d for bug-gnu-emacs@gnu.org; Tue, 12 Jul 2011 12:29:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1QgfpX-0000sT-9v for bug-gnu-emacs@gnu.org; Tue, 12 Jul 2011 12:29:04 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:34311) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QgfpX-0000sO-14 for bug-gnu-emacs@gnu.org; Tue, 12 Jul 2011 12:29:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1QgfpW-0006ur-Gp; Tue, 12 Jul 2011 12:29:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 12 Jul 2011 16:29:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 3801 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 3801-submit@debbugs.gnu.org id=B3801.131048809626526 (code B ref 3801); Tue, 12 Jul 2011 16:29:02 +0000 Original-Received: (at 3801) by debbugs.gnu.org; 12 Jul 2011 16:28:16 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qgfol-0006tn-Gv for submit@debbugs.gnu.org; Tue, 12 Jul 2011 12:28:15 -0400 Original-Received: from rcsinet15.oracle.com ([148.87.113.117]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qgfoi-0006ta-O0 for 3801@debbugs.gnu.org; Tue, 12 Jul 2011 12:28:13 -0400 Original-Received: from rtcsinet21.oracle.com (rtcsinet21.oracle.com [66.248.204.29]) by rcsinet15.oracle.com (Switch-3.4.4/Switch-3.4.4) with ESMTP id p6CGS4IR006203 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Tue, 12 Jul 2011 16:28:06 GMT Original-Received: from acsmt356.oracle.com (acsmt356.oracle.com [141.146.40.156]) by rtcsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id p6CGS3qQ016459 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Tue, 12 Jul 2011 16:28:03 GMT Original-Received: from abhmt113.oracle.com (abhmt113.oracle.com [141.146.116.65]) by acsmt356.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id p6CGRvfd010407; Tue, 12 Jul 2011 11:27:57 -0500 Original-Received: from dradamslap1 (/10.159.35.193) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Tue, 12 Jul 2011 09:27:57 -0700 X-Mailer: Microsoft Office Outlook 11 In-Reply-To: X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6109 Thread-Index: AcxAqGbIc6QwFAyCRXaDMpSemjR6rgABwICQ X-Source-IP: rtcsinet21.oracle.com [66.248.204.29] X-CT-RefId: str=0001.0A090202.4E1C7616.013B:SCFSTAT5015188, ss=1, re=-4.000, fgs=0 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Tue, 12 Jul 2011 12:29:02 -0400 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 140.186.70.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-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:48758 Archived-At: > > I tried looking for the place in the Emacs manual where the notation > > for key sequences (the one used in the doc) is described. I tried > > `notation' and found there was only one match: > > `gdb-use-colon-colon-notation'. Users should be able to find this by > > looking for terms such as `notation' and `conventions'. > > In what circumstances does Emacs talk about notations for key > sequences? The conventions used in the doc should be described. They are, for the Elisp manual: see node `Conventions' and its subnodes. See how detailed those nodes are, and how well they explain the notations used in the Elisp manual. The Emacs manual should also describe the notations it uses. In particular, key-sequence notation. There should be a description of how the manual indicates key sequences, including for different kinds of keys (e.g. angle-bracket notation vs no angle brackets). If there is not yet such a desciption, it should be added. And then it should be indexed (this bug report).