From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#41006: 26.3; regular expressions documentation Date: Fri, 08 May 2020 09:47:46 +0300 Message-ID: <831rnukjn1.fsf@gnu.org> References: <64E29F93-5A92-4F8D-9BA2-C6F14AEC2F64@acm.org> <824a1116-8e91-409f-95ff-69ef168a359d@default> <87k11s221z.fsf@stefankangas.se> Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="95832"; mail-complaints-to="usenet@ciao.gmane.io" Cc: mattiase@acm.org, stefan@marxist.se, 41006@debbugs.gnu.org, rtm443x@googlemail.com To: rms@gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Fri May 08 08:49:16 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 1jWwot-000Op3-Ml for geb-bug-gnu-emacs@m.gmane-mx.org; Fri, 08 May 2020 08:49:15 +0200 Original-Received: from localhost ([::1]:38016 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jWwos-0006W9-99 for geb-bug-gnu-emacs@m.gmane-mx.org; Fri, 08 May 2020 02:49:14 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:52848) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jWwoh-0006Tl-Cb for bug-gnu-emacs@gnu.org; Fri, 08 May 2020 02:49:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:32933) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1jWwoh-0001Ki-35 for bug-gnu-emacs@gnu.org; Fri, 08 May 2020 02:49:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1jWwoh-00064j-0i for bug-gnu-emacs@gnu.org; Fri, 08 May 2020 02:49:03 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 08 May 2020 06:49: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.158892049523268 (code B ref 41006); Fri, 08 May 2020 06:49:02 +0000 Original-Received: (at 41006) by debbugs.gnu.org; 8 May 2020 06:48:15 +0000 Original-Received: from localhost ([127.0.0.1]:44475 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jWwnv-00063E-72 for submit@debbugs.gnu.org; Fri, 08 May 2020 02:48:15 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:49684) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jWwns-000631-H7 for 41006@debbugs.gnu.org; Fri, 08 May 2020 02:48:13 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:40329) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jWwnm-0008KJ-U2; Fri, 08 May 2020 02:48:06 -0400 Original-Received: from [176.228.60.248] (port=1111 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1jWwnf-0006kc-Qk; Fri, 08 May 2020 02:48:00 -0400 In-Reply-To: (message from Richard Stallman on Thu, 07 May 2020 22:49:22 -0400) 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:179911 Archived-At: > From: Richard Stallman > Date: Thu, 07 May 2020 22:49:22 -0400 > Cc: mattiase@acm.org, 41006@debbugs.gnu.org, rtm443x@googlemail.com > > > My proposal is to include "how to use them" inside the chapter called > > "Regular Expressions". Is there any reason not to do that? > > Now we have > > > > * Regular Expressions:: Describing classes of strings. > > > * Regexp Search:: Searching for a match for a regexp. > > We could convert Regexp Search into a subsection under Regular > Expressions. I don't see any harm in doing that. Let's first decide whether we are talking about the Emacs user manual, the ELisp reference manual, or both. The current organization of this stuff is slightly different in each one. The OP meant the user manual, AFAIU. To answer the specific question you asked: this is all part of a chapter called "Searching and Replacement" in the user manual and "Searching and Matching" in the ELisp manual. So having there a section called "Regular Expressions" which would include a subsection about regexp search makes less sense to me than the other way around: have a section "Regular Expression Search" which would start with syntax of regexps and go on to a subsection that describes the regexp search facilities (it should then probably include the "POSIX Regexps" section as well).