From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Mattias =?UTF-8?Q?Engdeg=C3=A5rd?= Newsgroups: gmane.emacs.bugs Subject: bug#46910: 27.1; (elisp) RX doc Date: Sun, 26 Sep 2021 14:44:42 +0200 Message-ID: <1CB22E13-F19B-4B9B-B31C-6F5CFC9E8A51@acm.org> References: Mime-Version: 1.0 (Mac OS X Mail 12.4 \(3445.104.21\)) Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="11764"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 46910-done@debbugs.gnu.org To: Stefan Kangas Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sun Sep 26 14:46:00 2021 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 1mUTXc-0002rX-O7 for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 26 Sep 2021 14:46:00 +0200 Original-Received: from localhost ([::1]:47122 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mUTXa-0005vJ-Je for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 26 Sep 2021 08:45:58 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:50248) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mUTWh-0005v3-9y for bug-gnu-emacs@gnu.org; Sun, 26 Sep 2021 08:45:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:52784) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mUTWg-0008FK-Um for bug-gnu-emacs@gnu.org; Sun, 26 Sep 2021 08:45:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1mUTWg-0000d3-Do for bug-gnu-emacs@gnu.org; Sun, 26 Sep 2021 08:45:02 -0400 Resent-From: Mattias =?UTF-8?Q?Engdeg=C3=A5rd?= Original-Sender: "Debbugs-submit" Resent-To: bug-gnu-emacs@gnu.org Resent-Date: Sun, 26 Sep 2021 12:45:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: cc-closed 46910 X-GNU-PR-Package: emacs Mail-Followup-To: 46910@debbugs.gnu.org, mattiase@acm.org, drew.adams@oracle.com Original-Received: via spool by 46910-done@debbugs.gnu.org id=D46910.16326602952382 (code D ref 46910); Sun, 26 Sep 2021 12:45:02 +0000 Original-Received: (at 46910-done) by debbugs.gnu.org; 26 Sep 2021 12:44:55 +0000 Original-Received: from localhost ([127.0.0.1]:36097 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mUTWZ-0000cM-3P for submit@debbugs.gnu.org; Sun, 26 Sep 2021 08:44:55 -0400 Original-Received: from mail1456c50.megamailservers.eu ([91.136.14.56]:36136 helo=mail266c50.megamailservers.eu) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mUTWW-0000c3-Oc for 46910-done@debbugs.gnu.org; Sun, 26 Sep 2021 08:44:54 -0400 X-Authenticated-User: mattiase@bredband.net DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=megamailservers.eu; s=maildub; t=1632660285; bh=ZLe7KmV4rteJ0OeShpPsBbiad4VBc5SxrRZPLJBRV64=; h=Subject:From:In-Reply-To:Date:Cc:References:To:From; b=GVueNwJEiZ/j9Jj5ZsBhw78ljNI0JVDr0XBFINu/Kyg05ienEuXn82LBRzIw9USo+ Yb/HGHD6wI18i2dYRs0UghDWbDHgGLu31m6XJQ3/6bEKjmR47/sSaBorDWSfUrRurl 9r//EYJqYPQzX91pgt1sp1lZCJzJe9CrhKAOwfH4= Feedback-ID: mattiase@acm.or Original-Received: from [192.168.0.4] (c188-150-171-71.bredband.tele2.se [188.150.171.71]) (authenticated bits=0) by mail266c50.megamailservers.eu (8.14.9/8.13.1) with ESMTP id 18QCigXn026941; Sun, 26 Sep 2021 12:44:44 +0000 In-Reply-To: X-Mailer: Apple Mail (2.3445.104.21) X-CTCH-RefID: str=0001.0A742F21.61506B3D.000E, ss=1, re=0.000, recu=0.000, reip=0.000, cl=1, cld=1, fgs=0 X-CTCH-VOD: Unknown X-CTCH-Spam: Unknown X-CTCH-Score: 0.000 X-CTCH-Flags: 0 X-CTCH-ScoreCust: 0.000 X-CSC: 0 X-CHA: v=2.4 cv=Wexv12tX c=1 sm=1 tr=0 ts=61506b3d a=SF+I6pRkHZhrawxbOkkvaA==:117 a=SF+I6pRkHZhrawxbOkkvaA==:17 a=kj9zAlcOel0A:10 a=M51BFTxLslgA:10 a=yPCof4ZbAAAA:8 a=c0pf65Xm-d1PivWQbBIA:9 a=CjuIK1q_8ugA:10 X-Origin-Country: SE 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:215597 Archived-At: 25 sep. 2021 kl. 17.25 skrev Stefan Kangas : >=20 > Drew Adams writes: >=20 >> 1. `Rx Constructs' doesn't explain that the "constructs" are used in >> arguments to macro `rx'. Yes, I've added an explanation. >> 2. `Rx Constructs': Don't show things like `\sCODE' without saying = what >> CODE means. If the column title for the table explaining RX names is >> `Syntax character' or `Category character' then that's apparently = what >> CODE corresponds to for `\sCODE' or `\cCODE'. But there's no way to >> know that unless you're already familiar with `\s' and `\c' syntax. That's a valid point; now elaborated. If anything I'd like to move the tables of syntax and (especially) = category names to a separate page since they are rarely consulted and = take up a lot of space. Not sure how to best do that. >> 3. `Rx Constructs', `Zero-width assertions': Call this `Zero-width >> matching' or some such. Thank you, but it's established terminology and immediately explained in = the first sentence. >> 4. `Rx Functions': RX-EXPR is used as parameter name for what is, I >> guess an Rx construct That was a clear mistake, now fixed -- thanks. >> 5. `Rx Functions': A couple places talk about `'regexp' forms', but >> those are specified nowhere The `regexp` and `literal` forms are both documented on the previous = page. For good measure, I also added some examples to illustrate the = difference between `rx` and `rx-to-string`.