From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail From: Stefan Kangas Newsgroups: gmane.emacs.bugs Subject: bug#41006: 26.3; regular expressions documentation Date: Tue, 5 May 2020 20:20:59 +0200 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" Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="123207"; mail-complaints-to="usenet@ciao.gmane.io" Cc: Mattias =?UTF-8?Q?Engdeg=C3=A5rd?= , 41006@debbugs.gnu.org, rtm443x@googlemail.com To: Richard Stallman Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Tue May 05 20:22: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 1jW2Co-000Vrn-2f for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 05 May 2020 20:22:10 +0200 Original-Received: from localhost ([::1]:50804 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jW2Cm-00014Y-Rc for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 05 May 2020 14:22:08 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:52114) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jW2Cg-00014N-PP for bug-gnu-emacs@gnu.org; Tue, 05 May 2020 14:22:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:54101) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1jW2Cg-0000LO-6M for bug-gnu-emacs@gnu.org; Tue, 05 May 2020 14:22:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1jW2Cg-0007E4-2V for bug-gnu-emacs@gnu.org; Tue, 05 May 2020 14:22:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Stefan Kangas Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 05 May 2020 18:22: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.158870287827702 (code B ref 41006); Tue, 05 May 2020 18:22:02 +0000 Original-Received: (at 41006) by debbugs.gnu.org; 5 May 2020 18:21:18 +0000 Original-Received: from localhost ([127.0.0.1]:37414 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jW2By-0007Ck-EP for submit@debbugs.gnu.org; Tue, 05 May 2020 14:21:18 -0400 Original-Received: from mail-yb1-f174.google.com ([209.85.219.174]:45369) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jW2Bw-0007CU-HX for 41006@debbugs.gnu.org; Tue, 05 May 2020 14:21:16 -0400 Original-Received: by mail-yb1-f174.google.com with SMTP id r14so1747912ybm.12 for <41006@debbugs.gnu.org>; Tue, 05 May 2020 11:21:16 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=z/lF3PrqBUkpiEs28dSW/Y9GFa0rW5PIx7wMP+gYi8E=; b=sB/QWIvBUjmGSStT+xsGqP/eel4JxFTmPG5Uxo/1fRvN0VXbuSnnvKho7IlEYO4DoI /UeDRjWveO49zQ9MroxO0zeRHvlaJD3c2AbfNr5/zCB+JOVAqP5aGqg/1aHBSwkd9gsK TV/GOcHBIrYOhRbtK+Z3hl1u4rHP4eayf+YI78xemnq/MiIYavUpVay1S6j9F4q2TvWP OJOuvyaJF1LWuvAC7JG4y2FoFIU3qg3zCl4/e/t59vxdTh+RmA8lkZxZEcmEt8jEZJsn jhASL8UP2Ujm+itbo+llJjelTb7OmxgVw1AzIXZu9OnhUC5CzqkblFEmOsb2ryU2VZv+ GNcw== X-Gm-Message-State: AGi0PuZapyCKlD++4bJKLprzmXxyNL+RhTBUwwnz+cW52jFPdzSZ8cJh CJGRpDk7DUE7y8cZeVV2gGo83d3oV8/MVuQbgkE= X-Google-Smtp-Source: APiQypIvg8XotDC6m07iF1d1pE+ql39bqm33gg2LmgcR5WpcLBeQbry2XNbGLnc1pCU5bY1I9RzLdY9nrA8OTWpt08E= X-Received: by 2002:a5b:9d1:: with SMTP id y17mr6834688ybq.129.1588702871055; Tue, 05 May 2020 11:21:11 -0700 (PDT) In-Reply-To: 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:179759 Archived-At: Richard Stallman writes: > What I see in master is this structure. > Is this different from what you saw? > Does this structure eliminate the problem you had? I'm also looking at master. Let me be more specific. > @menu > * Syntax of Regexps:: Rules for writing regular expressions. > * Regexp Example:: Illustrates regular expression syntax. > @ifnottex > * Rx Notation:: An alternative, structured regexp notation. > @end ifnottex > * Regexp Functions:: Functions for operating on regular expressions. > @end menu The above is the problem, for me: it does not include "Regexp Search". This is where I find any function to actually use the regexps I learn to construct here. If I go up one node, to (elisp) Searching and Matching, I can see: * Regular Expressions:: Describing classes of strings. * Regexp Search:: Searching for a match for a regexp. 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. 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". While we're at it, I also think "Regexp Search" could state, at the top, how to access match data. This is a bit hard to find, IME. Best regards, Stefan Kangas