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#41006: 26.3; regular expressions documentation Date: Tue, 5 May 2020 11:40:36 -0700 (PDT) Message-ID: <032f1835-d4ca-47c7-a8bb-3f4628a820a8@default> References: <64E29F93-5A92-4F8D-9BA2-C6F14AEC2F64@acm.org> <824a1116-8e91-409f-95ff-69ef168a359d@default> <87k11s221z.fsf@stefankangas.se> 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="77407"; mail-complaints-to="usenet@ciao.gmane.io" Cc: Mattias =?UTF-8?Q?Engdeg=C3=A5rd?= , 41006@debbugs.gnu.org, rtm443x@googlemail.com To: Stefan Kangas , Richard Stallman Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Tue May 05 20:41:15 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 1jW2VH-000K2H-6a for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 05 May 2020 20:41:15 +0200 Original-Received: from localhost ([::1]:33926 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jW2VG-0007q7-8S for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 05 May 2020 14:41:14 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:55334) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jW2V4-0007p0-LF for bug-gnu-emacs@gnu.org; Tue, 05 May 2020 14:41:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:54119) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1jW2V4-00038Y-Bz for bug-gnu-emacs@gnu.org; Tue, 05 May 2020 14:41:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1jW2V4-0007jC-8w for bug-gnu-emacs@gnu.org; Tue, 05 May 2020 14:41: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, 05 May 2020 18:41:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 41006 X-GNU-PR-Package: emacs Original-Received: via spool by 41006-submit@debbugs.gnu.org id=B41006.158870405129671 (code B ref 41006); Tue, 05 May 2020 18:41:02 +0000 Original-Received: (at 41006) by debbugs.gnu.org; 5 May 2020 18:40:51 +0000 Original-Received: from localhost ([127.0.0.1]:37432 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jW2Us-0007iU-Qt for submit@debbugs.gnu.org; Tue, 05 May 2020 14:40:51 -0400 Original-Received: from userp2130.oracle.com ([156.151.31.86]:60788) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jW2Uq-0007i9-Dg for 41006@debbugs.gnu.org; Tue, 05 May 2020 14:40:49 -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 045IXcCt104739; Tue, 5 May 2020 18:40:39 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-2020-01-29; bh=HUPYdNhuJg7fA+J2veGICy/Ygi0454B38q/DgKO8WOQ=; b=kNOMJb278yMsaBr5X9Txtot+O1MON9T3u2FyfmrTczf5h2UXgNiyF5q6beYGvZ19ReZQ FKri7FPGGFboq0oM2g4oq3WxSY/vjK55GdD/EE+Pkr9KJvES/trz9Q0yyfYJ4bR0f39y fQg9DeRrEiJxHr6l5IAukbNXWfLF+eNoCIU3CVXZFGJzjdmtggYMhjgonTt7o7/WK0li cog5GypZEZmlGyiU4oZXLah0V9gP1UvQjj6hRX9WIAvjOzYi9R5zVADBAu/tDweOUnsz u94EcZbGXGAmNenNFV2kDhOosdRq+wjaKawnR77yH2nY+7ZZXOQOnbVExHWipmV0rZ+2 7w== Original-Received: from userp3020.oracle.com (userp3020.oracle.com [156.151.31.79]) by userp2130.oracle.com with ESMTP id 30s09r6gwg-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 05 May 2020 18:40:39 +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 045IagCA062360; Tue, 5 May 2020 18:40:38 GMT Original-Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by userp3020.oracle.com with ESMTP id 30sjk09w98-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 05 May 2020 18:40:38 +0000 Original-Received: from abhmp0007.oracle.com (abhmp0007.oracle.com [141.146.116.13]) by userv0121.oracle.com (8.14.4/8.13.8) with ESMTP id 045IebiI018381; Tue, 5 May 2020 18:40:37 GMT In-Reply-To: X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4993.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9612 signatures=668687 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 mlxscore=0 phishscore=0 bulkscore=0 malwarescore=0 spamscore=0 mlxlogscore=876 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2003020000 definitions=main-2005050140 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9612 signatures=668687 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 bulkscore=0 mlxscore=0 lowpriorityscore=0 spamscore=0 adultscore=0 clxscore=1015 suspectscore=0 priorityscore=1501 malwarescore=0 mlxlogscore=909 phishscore=0 impostorscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2003020000 definitions=main-2005050140 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:179762 Archived-At: > If I go up one node, to (elisp) Searching and Matching, I can see: >=20 > * Regular Expressions:: Describing classes of strings. > * Regexp Search:: Searching for a match for a regexp. >=20 > So I suggest to move "Regexp Search" so that it is a section under > "Regular Expressions" (instead of parallel to it). Maybe conceptually > this is not as clean, but it is more pedagogical and user-friendly, > IMHO. >=20 > I would also suggest to place "Regexp Search" first, even before > "Syntax of Regexps", but this is just my personal preference and less > important. It should at least, from my point of view, come before "Rx > Notation". I think `Regexp Search' belongs under `Searching and Matching'. But I think `Regexp Search' should come before `Regular Expressions'. And maybe `POSIX Regexps' and `Standard Regexps' should be under `Regular Expressions'. IOW, separate using regexps (searching and matching) from details about what regexps are and what their syntax is. We can present how to use them without requiring much knowledge of what they are. And of course we should have xrefs between the doc about what they are and the doc about using them. (Probably there are already some such.)