From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#31623: 27.0; Elisp manual, index entry "; in comment" Date: Tue, 29 May 2018 19:23:12 -0700 (PDT) Message-ID: <768edb20-d1d3-4c9b-9f44-4c17a8df8e41@default> References: <87a7sica2g.fsf@gmail.com> <524f86f7-78e2-44a5-89fd-5df5fde0dda6@default> <877enmc846.fsf@gmail.com> <4fc08e13-4c43-4f4b-a9ad-0ce221b9d4ea@default> <871sdtdhvx.fsf@gmail.com> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1527646929 16383 195.159.176.226 (30 May 2018 02:22:09 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Wed, 30 May 2018 02:22:09 +0000 (UTC) Cc: 31623@debbugs.gnu.org To: Noam Postavsky Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed May 30 04:22:05 2018 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fNqkT-00046H-V9 for geb-bug-gnu-emacs@m.gmane.org; Wed, 30 May 2018 04:22:02 +0200 Original-Received: from localhost ([::1]:35844 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fNqmb-0002yv-16 for geb-bug-gnu-emacs@m.gmane.org; Tue, 29 May 2018 22:24:13 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:53843) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fNqmT-0002yo-M2 for bug-gnu-emacs@gnu.org; Tue, 29 May 2018 22:24:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fNqmQ-0002Bv-ER for bug-gnu-emacs@gnu.org; Tue, 29 May 2018 22:24:05 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:46610) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1fNqmQ-0002Ba-7R for bug-gnu-emacs@gnu.org; Tue, 29 May 2018 22:24:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1fNqmP-00060X-VX for bug-gnu-emacs@gnu.org; Tue, 29 May 2018 22:24:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 30 May 2018 02:24:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 31623 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 31623-submit@debbugs.gnu.org id=B31623.152764700423023 (code B ref 31623); Wed, 30 May 2018 02:24:01 +0000 Original-Received: (at 31623) by debbugs.gnu.org; 30 May 2018 02:23:24 +0000 Original-Received: from localhost ([127.0.0.1]:54507 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fNqlo-0005zH-CK for submit@debbugs.gnu.org; Tue, 29 May 2018 22:23:24 -0400 Original-Received: from userp2120.oracle.com ([156.151.31.85]:56400) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fNqlm-0005z3-Ke for 31623@debbugs.gnu.org; Tue, 29 May 2018 22:23:23 -0400 Original-Received: from pps.filterd (userp2120.oracle.com [127.0.0.1]) by userp2120.oracle.com (8.16.0.22/8.16.0.22) with SMTP id w4U2LNQY078577; Wed, 30 May 2018 02:23:15 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : cc : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2017-10-26; bh=UxppGw58dW2sRKsAe5I2GzZGI4Y2eBlFZw3HD3N+m4U=; b=gfehwLWhq7pWZXpK4XxanMYSusS+jARtx9/vu6eFyFFneBM953ioAeIQGeZyLw1OH4dG CZWSa16YO5Zhu0ZP0WWgZL1rZpAHtSVI+JqtPUCQww4u6KIuNP+nFTutuBIk2oF9ln71 M42K9krsfC1r4C1EBYiH/k79RuDnPLRWmULgQoIXbuzOPKdzrRJYrONAu0SScR8fStxF m7uL24ORn6ZwkifaTlSPqNPHJmATZyeiL4XO+mlYbi9qsYRDDnHxwdqLkWRLx72rNfbd tSQBaDbA7CHSvtpLbrJerqrl/RbpYBR9CMsT2GEGUNp75YKywIzbgUD9QjomnRrTxYVa sw== Original-Received: from userv0022.oracle.com (userv0022.oracle.com [156.151.31.74]) by userp2120.oracle.com with ESMTP id 2j9ev80fj0-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Wed, 30 May 2018 02:23:15 +0000 Original-Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by userv0022.oracle.com (8.14.4/8.14.4) with ESMTP id w4U2NFIX005456 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Wed, 30 May 2018 02:23:15 GMT Original-Received: from abhmp0008.oracle.com (abhmp0008.oracle.com [141.146.116.14]) by userv0121.oracle.com (8.14.4/8.13.8) with ESMTP id w4U2NEuM009818; Wed, 30 May 2018 02:23:15 GMT In-Reply-To: <871sdtdhvx.fsf@gmail.com> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4690.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=5900 definitions=8908 signatures=668702 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1805220000 definitions=main-1805300023 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: 208.118.235.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:146730 Archived-At: > >> > If that's the intention then I think it might be clearer > >> > if the index entry were "; outside a comment" or maybe > >> > "; not in a comment". >=20 > > But certainly the `;' that starts a comment is part of the > > comment itself. No one would doubt that, I think. >=20 > I'm a bit puzzled then. How would "; outside a comment" make sense for > a page which talks about comments? That seems to be the opposite of > what it's about. That's not a great index entry either. The target text is not at all about `;' in text that is commented. It is only about `;' used as a comment-start char. > > The entry should indicate something about the subject > > indexed. "; in comment" does not do that, for me, at > > least. >=20 > What do you think about the "(...) in lists" entry? Never noticed it. At least it's not a character. If I had to guess naively, I'd probably expect that to take me to some text about nested lists. IMO, it too is a bad index entry. It's not clear at all what someone might be looking for who would find that a description that might help her find what is sought. > > Or perhaps you have a suggestion. >=20 > I don't really see a problem with the current one, but I guess "; for > commenting" (in the same vein as "' for quoting") could be okay.