From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#41970: Suggestions for corrections to Emacs and Elisp manuals Date: Sat, 20 Jun 2020 21:50:57 +0000 (UTC) Message-ID: <526b792b-d2f1-492b-a18c-e706d24bd0ee@default> References: Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="46381"; mail-complaints-to="usenet@ciao.gmane.io" To: Jay Bingham , 41970@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sat Jun 20 23:52:10 2020 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1jmlPG-000Bxr-0O for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 20 Jun 2020 23:52:10 +0200 Original-Received: from localhost ([::1]:39858 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jmlPE-0005SW-GQ for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 20 Jun 2020 17:52:08 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:60262) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jmlP8-0005SM-Bc for bug-gnu-emacs@gnu.org; Sat, 20 Jun 2020 17:52:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:47334) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1jmlP8-0008VY-1g for bug-gnu-emacs@gnu.org; Sat, 20 Jun 2020 17:52:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1jmlP8-0007ed-00 for bug-gnu-emacs@gnu.org; Sat, 20 Jun 2020 17:52: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: Sat, 20 Jun 2020 21:52:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 41970 X-GNU-PR-Package: emacs Original-Received: via spool by 41970-submit@debbugs.gnu.org id=B41970.159268987129359 (code B ref 41970); Sat, 20 Jun 2020 21:52:01 +0000 Original-Received: (at 41970) by debbugs.gnu.org; 20 Jun 2020 21:51:11 +0000 Original-Received: from localhost ([127.0.0.1]:58880 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jmlOJ-0007dS-5G for submit@debbugs.gnu.org; Sat, 20 Jun 2020 17:51:11 -0400 Original-Received: from userp2130.oracle.com ([156.151.31.86]:54966) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jmlOD-0007ct-Nz for 41970@debbugs.gnu.org; Sat, 20 Jun 2020 17:51:09 -0400 Original-Received: from pps.filterd (userp2130.oracle.com [127.0.0.1]) by userp2130.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 05KLhibf002622; Sat, 20 Jun 2020 21:50:59 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2020-01-29; bh=xB+VXpj4ixdMRUO1bhErOy4u7lO27RKr2zgFtWmfMAU=; b=eCDcOV0HJBfVaLGZYJfL6lKOaK77wMw185g2du1miiGJxoeEeSuiUIEwPsnWX93f04Wq oodBWhNdik3/dP0okRTqxFw+jBAAzrpeaV/aSa1kxZSGbrH7PDGHHrPFhUTWicx/tnLP uMQ41kV+0WY3x8hXRnjx9wHG8MALrA31tpArhT5OxCBTSTX5hfI20Z7i8/u8arJ53pw7 8+0RiZ5xeM88eEBy9Qbh+288AEZtVGU5atJVbgXBQ8u1XO4fyA2Ldjnvf7R0Koqa911z +3TUnzCH9ruhpIY1LuwWIJxtCqBedJlmy+pCBcNOWEw+F/6MR6Kcd0TjXw66/6XJgNpY Tg== Original-Received: from userp3020.oracle.com (userp3020.oracle.com [156.151.31.79]) by userp2130.oracle.com with ESMTP id 31sebb9jy9-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Sat, 20 Jun 2020 21:50:59 +0000 Original-Received: from pps.filterd (userp3020.oracle.com [127.0.0.1]) by userp3020.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 05KLiAqr155865; Sat, 20 Jun 2020 21:50:59 GMT Original-Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by userp3020.oracle.com with ESMTP id 31seb74jh6-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 20 Jun 2020 21:50:59 +0000 Original-Received: from abhmp0004.oracle.com (abhmp0004.oracle.com [141.146.116.10]) by aserv0122.oracle.com (8.14.4/8.14.4) with ESMTP id 05KLowlw029279; Sat, 20 Jun 2020 21:50:58 GMT In-Reply-To: X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.5017.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9658 signatures=668680 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 phishscore=0 malwarescore=0 spamscore=0 suspectscore=0 adultscore=0 mlxscore=0 mlxlogscore=999 bulkscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2004280000 definitions=main-2006200162 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9658 signatures=668680 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 adultscore=0 lowpriorityscore=0 mlxlogscore=999 cotscore=-2147483648 mlxscore=0 phishscore=0 priorityscore=1501 malwarescore=0 bulkscore=0 suspectscore=0 clxscore=1011 impostorscore=0 spamscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2004280000 definitions=main-2006200162 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list 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-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:182219 Archived-At: > The terminology used in section 15.6 Syntax of Regular Expressions to des= cribe and discuss the =E2=80=98[ ... ]=E2=80=99 and =E2=80=98[^ ... ]=E2=80= =99 constructs. The first paragraph and the final paragraph in the section = both refer to these constructs as "a character alternative", while the para= graphs describing them call them a =E2=80=9Ccharacter set=E2=80=9D. In sect= ion 34.3.1.1 of the Elisp manual the phrase used consistently to describe t= hem and refer to them is "a character alternative". > It would increase the consistency of both manuals to use the same termino= logy to describe and refer to these constructs. A more grammatically correc= t phrase to describe these features would be "a set of alternative characte= rs" (but when have programming nerds ever been that concerned with grammati= cal correctness). A nit: These references refer to the syntax construct [...], and not to the set of= chars that it represents. It is wrong to call this construct "a character= set", and it would be wrong to call it "a set of alternative characters". = What it _matches_, or represents, is any _one_ char of a set of alternativ= e chars. But the syntax construct is not a set of chars.