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: Fri, 8 May 2020 09:49:11 -0700 (PDT) Message-ID: 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="126767"; mail-complaints-to="usenet@ciao.gmane.io" Cc: mattiase@acm.org, 41006@debbugs.gnu.org, rtm443x@googlemail.com To: rms@gnu.org, Stefan Kangas Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Fri May 08 18:50:14 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 1jX6CS-000Wr4-Lt for geb-bug-gnu-emacs@m.gmane-mx.org; Fri, 08 May 2020 18:50:12 +0200 Original-Received: from localhost ([::1]:42072 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jX6CR-0007rN-J2 for geb-bug-gnu-emacs@m.gmane-mx.org; Fri, 08 May 2020 12:50:11 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:36758) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jX6CI-0007pS-QA for bug-gnu-emacs@gnu.org; Fri, 08 May 2020 12:50:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:34672) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1jX6CI-0004yJ-GY for bug-gnu-emacs@gnu.org; Fri, 08 May 2020 12:50:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1jX6CI-0006q8-CF for bug-gnu-emacs@gnu.org; Fri, 08 May 2020 12:50: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: Fri, 08 May 2020 16:50: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.158895657126248 (code B ref 41006); Fri, 08 May 2020 16:50:02 +0000 Original-Received: (at 41006) by debbugs.gnu.org; 8 May 2020 16:49:31 +0000 Original-Received: from localhost ([127.0.0.1]:46218 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jX6Bn-0006pG-25 for submit@debbugs.gnu.org; Fri, 08 May 2020 12:49:31 -0400 Original-Received: from aserp2120.oracle.com ([141.146.126.78]:39394) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jX6Bl-0006p4-4j for 41006@debbugs.gnu.org; Fri, 08 May 2020 12:49:29 -0400 Original-Received: from pps.filterd (aserp2120.oracle.com [127.0.0.1]) by aserp2120.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 048GnLMr087605; Fri, 8 May 2020 16:49:21 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=5F7xoCtpBlOYoxs3CSuSDx4EVyQwIJwMwO5RrrE8F1U=; b=NYhn+85RbARzwF260y3I8LWtEuuR7gWq32uLPGTQvv4myES8ziYMWujCaKuG3erS3Bwu AHacgumTI3izTesyerXMSSlXNJjcXnFOC8g4Eyr8YrKE/wf2TSf5nFU5AYTniuGCLFYM i7EqdGnDSIV8Ua1VhgNDh23YuQWkRzp5JPyK5+CRsMu76H0V7srSpWbz3vFaDcQgTKUC HUR1ejvrMhW3kMzgx3dREMgd095LnniTCQ7hIhCiDHL551rof7yF6cLCPFRc4viTksIV 4nJiNvOeI4LdeFBRMUpBBqOa0g/aHNvyh4qJLaWSREg5bPX4U51o0MjBeR4lx37xQyVk Ag== Original-Received: from aserp3020.oracle.com (aserp3020.oracle.com [141.146.126.70]) by aserp2120.oracle.com with ESMTP id 30vtepm1bx-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 08 May 2020 16:49:21 +0000 Original-Received: from pps.filterd (aserp3020.oracle.com [127.0.0.1]) by aserp3020.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 048GbdoE086187; Fri, 8 May 2020 16:49:15 GMT Original-Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by aserp3020.oracle.com with ESMTP id 30vte0fw6w-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 08 May 2020 16:49:14 +0000 Original-Received: from abhmp0007.oracle.com (abhmp0007.oracle.com [141.146.116.13]) by aserv0121.oracle.com (8.14.4/8.13.8) with ESMTP id 048GnCMN026910; Fri, 8 May 2020 16:49:12 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=9614 signatures=668687 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 mlxlogscore=991 phishscore=0 bulkscore=0 malwarescore=0 suspectscore=0 adultscore=0 mlxscore=0 spamscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2003020000 definitions=main-2005080142 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9614 signatures=668687 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 adultscore=0 spamscore=0 impostorscore=0 phishscore=0 clxscore=1015 priorityscore=1501 lowpriorityscore=0 malwarescore=0 suspectscore=0 mlxscore=0 mlxlogscore=999 bulkscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2003020000 definitions=main-2005080142 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:179933 Archived-At: > > My proposal is to include "how to use them" inside the chapter > > called "Regular Expressions". Is there any reason not to do that? >=20 > Now we have >=20 > * Regular Expressions:: Describing classes of strings. > * Regexp Search:: Searching for a match for a regexp. >=20 > We could convert Regexp Search into a subsection under Regular > Expressions. I don't see any harm in doing that. I too agreed with that, and added: In that case, in the section on search there'd need to be some mention the ability to do regexp search, and xrefs to the relevant "use" sections of the regexp doc. IOW, if regexp search is under regexps then the (other) search section needs to link to the regexp-search topic. > The Regexp Search node could come before, or after, the > existing subsection, Regexp Functions. Which would be better? Suggestion: 1. Some high-level description of regexps - an idea of what they are and what you can use them for. 2. How to use them to match/search: regexp search. 3. Details of what they are - syntax, etc. But the order between 2 & 3 could be the opposite. What's important is for #1 to introduce both 2 & 3. And of course links among topics, for people who land on one of them out of the blue (e.g. by googling and getting to the HTML manual on the web). > Does anyone object to this change? (Not I.)