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 17:38:49 -0700 (PDT) Message-ID: <4fc08e13-4c43-4f4b-a9ad-0ce221b9d4ea@default> References: <87a7sica2g.fsf@gmail.com> <524f86f7-78e2-44a5-89fd-5df5fde0dda6@default> <877enmc846.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 1527640631 27978 195.159.176.226 (30 May 2018 00:37:11 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Wed, 30 May 2018 00:37:11 +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 02:37:07 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 1fNp6w-0007Ad-SV for geb-bug-gnu-emacs@m.gmane.org; Wed, 30 May 2018 02:37:07 +0200 Original-Received: from localhost ([::1]:35600 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fNp92-00028I-Do for geb-bug-gnu-emacs@m.gmane.org; Tue, 29 May 2018 20:39:16 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:39118) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fNp8r-00028B-HY for bug-gnu-emacs@gnu.org; Tue, 29 May 2018 20:39:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fNp8o-0004JN-Qn for bug-gnu-emacs@gnu.org; Tue, 29 May 2018 20:39:05 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:46581) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1fNp8o-0004JH-MJ for bug-gnu-emacs@gnu.org; Tue, 29 May 2018 20:39:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1fNp8o-0003XR-Dc for bug-gnu-emacs@gnu.org; Tue, 29 May 2018 20:39: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 00:39:02 +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.152764074013593 (code B ref 31623); Wed, 30 May 2018 00:39:02 +0000 Original-Received: (at 31623) by debbugs.gnu.org; 30 May 2018 00:39:00 +0000 Original-Received: from localhost ([127.0.0.1]:54478 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fNp8l-0003XA-S1 for submit@debbugs.gnu.org; Tue, 29 May 2018 20:39:00 -0400 Original-Received: from aserp2120.oracle.com ([141.146.126.78]:56866) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fNp8k-0003Wx-Bb for 31623@debbugs.gnu.org; Tue, 29 May 2018 20:38:58 -0400 Original-Received: from pps.filterd (aserp2120.oracle.com [127.0.0.1]) by aserp2120.oracle.com (8.16.0.22/8.16.0.22) with SMTP id w4U0ccqR075272; Wed, 30 May 2018 00:38:51 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=ab80YG4//BnpXgx0RN9HJeEsM7yAtuYzbUotK4J8nac=; b=S1OYGdwMI1hgbA/WNG/UzdL9GqBgu5XLGCwk3Lib1FwoisoJEEXS7X1dEZvpeAxe2Ray 8f44eg7Vgg9VdZ8MJc767S72i0SySlnuKRCrz6iQvoOSxdwYwHnzjiQPoBb+/VzkQMfR K3q8o2V6ojbT433QbRatBO4WxAM7vPEgp8mdlJZTAXN6CQIGbnVHf6Scrso/JXmh55bk wj6C1D6jGw7XG4FEaF06L0hn2Jcb/3Pe97lXZGk+m0+wVKM9bL82WfeRmCq/MxSiBiap Xcn5ls8DtbNNElfQZzr7qmNvvTbOlSQci2qPH/6Y9WIkV1TRbK5QXTT5bbmuoN3KCwXt Iw== Original-Received: from aserv0021.oracle.com (aserv0021.oracle.com [141.146.126.233]) by aserp2120.oracle.com with ESMTP id 2j9ev88agp-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Wed, 30 May 2018 00:38:51 +0000 Original-Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by aserv0021.oracle.com (8.14.4/8.14.4) with ESMTP id w4U0cpnL002615 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Wed, 30 May 2018 00:38:51 GMT Original-Received: from abhmp0008.oracle.com (abhmp0008.oracle.com [141.146.116.14]) by aserv0121.oracle.com (8.14.4/8.13.8) with ESMTP id w4U0co0l007021; Wed, 30 May 2018 00:38:51 GMT In-Reply-To: <877enmc846.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-1805300005 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:146727 Archived-At: > > OK, if you say so. ;-) I was thinking more about "in" > > meaning after `comment-start'. But yes, I guess that's > > what was intended. > > > > 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 > A later sentence in `(elisp) Comments' has: >=20 > The Lisp reader discards comments; they do not become part of the > Lisp objects which represent the program within the Lisp system. >=20 > The discarded comment includes the leading ";", so I don't think it > makes sense to treat the comment starter as being outside the comment. Of course. I didn't mean anything different. My point was that seeing an index entry "; in comment" I thought it likely referred to a `;' char in the commented text. I did not think that it was likely to be about the places where a `;' char is considered to be a `comment-start' char. But certainly the `;' that starts a comment is part of the comment itself. No one would doubt that, I think. > > In any case, that statement is not really true: a semicolon > > does not always start a comment in Lisp whenever it is not > > within a string or a character constant. There is also the > > case of it being escaped in a symbol name. E.g., > > > > (setq a\;b 42) > > > > (Dunno whether there are additional cases - perhaps not.) >=20 > I think not. So add "unescaped"? >=20 > In Lisp, an unescaped semicolon (`;') starts a comment > if it is not within a string or character constant. Fine by me. Thanks in advance for making that change. But I really think the index entry leaves something to be desired - which is what this bug report is about. The entry should indicate something about the subject indexed. "; in comment" does not do that, for me, at least. In the case of the intended indexing, it's about where `;' can start a Lisp comment - or more precisely, in which contexts it does _not_ start a comment. Someone looking that up might look for an entry such as just ";" (you'd expect the subject to cover what `;' can be used for in Lisp - which it does: comment start, char constant, escaped char). Or perhaps an entry such as "; as comment start" (but that doesn't really suggest that the text will also talk about other contexts for `;'). Or perhaps an entry such as "; used for commenting". Or perhaps you have a suggestion.