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 16:47:07 -0700 (PDT) Message-ID: <524f86f7-78e2-44a5-89fd-5df5fde0dda6@default> References: <87a7sica2g.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 1527637568 20686 195.159.176.226 (29 May 2018 23:46:08 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Tue, 29 May 2018 23:46:08 +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 01:46:04 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 1fNoJX-0005Ir-Mi for geb-bug-gnu-emacs@m.gmane.org; Wed, 30 May 2018 01:46:03 +0200 Original-Received: from localhost ([::1]:35493 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fNoLc-0003bJ-Qa for geb-bug-gnu-emacs@m.gmane.org; Tue, 29 May 2018 19:48:12 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:58305) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fNoLV-0003bB-PQ for bug-gnu-emacs@gnu.org; Tue, 29 May 2018 19:48:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fNoLS-0008QJ-JY for bug-gnu-emacs@gnu.org; Tue, 29 May 2018 19:48:05 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:46547) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1fNoLS-0008QC-Fm for bug-gnu-emacs@gnu.org; Tue, 29 May 2018 19:48:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1fNoLS-0002Js-1j for bug-gnu-emacs@gnu.org; Tue, 29 May 2018 19:48: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: Tue, 29 May 2018 23:48: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.15276376398860 (code B ref 31623); Tue, 29 May 2018 23:48:01 +0000 Original-Received: (at 31623) by debbugs.gnu.org; 29 May 2018 23:47:19 +0000 Original-Received: from localhost ([127.0.0.1]:54444 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fNoKk-0002Iq-U1 for submit@debbugs.gnu.org; Tue, 29 May 2018 19:47:19 -0400 Original-Received: from aserp2130.oracle.com ([141.146.126.79]:55712) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fNoKi-0002Ic-Cs for 31623@debbugs.gnu.org; Tue, 29 May 2018 19:47:17 -0400 Original-Received: from pps.filterd (aserp2130.oracle.com [127.0.0.1]) by aserp2130.oracle.com (8.16.0.22/8.16.0.22) with SMTP id w4TNlAVq114600; Tue, 29 May 2018 23:47:10 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=FnP3HFGToX6rXpxleUo1hvVa+vWSUqRjadQXhn/qEJA=; b=VG7zH8q5E1Thkm6gqKUv7gVt2lHmv/jv5nlcqCrDe+pt82aHquCY52t03Me9fs42jEG9 MES9Tjr91k5WiBKMf55PX/kOFNkkR8yDloBGYisJzU429ixBjAdU/Ojr4vhbE8TefZjh AXTLSsc560AObJU9lKeGqsjfyBjfdsjEwkM2K9Pxqt90cMjSoMciVJsisi/4BHja23zM R3x7zIMqHHdCoqhPAcLonVSmx5rmRWzNp7Xm6+pjnWp6NdR+3/KWy21thKnjStFqf6Qi sLmTBF0t+Zy/E3qwQnqp5Igy5eqonXTSA2hSQbYgrH2D6/KeCb9/C7g0xjnQPRCJQwq+ Hg== Original-Received: from aserv0022.oracle.com (aserv0022.oracle.com [141.146.126.234]) by aserp2130.oracle.com with ESMTP id 2j9ev8885b-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 29 May 2018 23:47:10 +0000 Original-Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by aserv0022.oracle.com (8.14.4/8.14.4) with ESMTP id w4TNl9SE011982 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 29 May 2018 23:47:09 GMT Original-Received: from abhmp0007.oracle.com (abhmp0007.oracle.com [141.146.116.13]) by userv0122.oracle.com (8.14.4/8.14.4) with ESMTP id w4TNl8vj018275; Tue, 29 May 2018 23:47:09 GMT In-Reply-To: <87a7sica2g.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-1805290253 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:146723 Archived-At: > > From the text of index entry "; in comment" I would expect a node that > > talks about the use of `;' inside a comment. I cannot imagine what > > other sense someone might make of this index-entry text. > > > > But the target of the index entry, node `Comments', does not seem to > > say anything about a `;' character inside a comment. >=20 > As far as I can tell, it refers to this sentence: >=20 > In Lisp, a semicolon (`;') starts a comment if it is not > within a string or character constant. >=20 > So, if it is not "within a string or character constant" then the > semicolon is in a comment. 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". 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.)