From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Noam Postavsky Newsgroups: gmane.emacs.bugs Subject: bug#36496: [PATCH] Describe the rx notation in the lisp manual Date: Sat, 06 Jul 2019 15:12:36 -0400 Message-ID: <87bly73rkr.fsf@gmail.com> References: <0C783D67-9502-408B-B845-5599BD596361@acm.org> <838stdbw8e.fsf@gnu.org> <83r2738r9j.fsf@gnu.org> <83k1cv8k5z.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="193183"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.2.90 (gnu/linux) Cc: 36496@debbugs.gnu.org To: Mattias =?UTF-8?Q?Engdeg=C3=A5rd?= Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Jul 06 21:13:10 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1hjq7S-000o7X-4M for geb-bug-gnu-emacs@m.gmane.org; Sat, 06 Jul 2019 21:13:10 +0200 Original-Received: from localhost ([::1]:32818 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hjq7R-000558-4g for geb-bug-gnu-emacs@m.gmane.org; Sat, 06 Jul 2019 15:13:09 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:44254) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hjq7L-00054o-Gw for bug-gnu-emacs@gnu.org; Sat, 06 Jul 2019 15:13:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hjq7K-0005sk-HI for bug-gnu-emacs@gnu.org; Sat, 06 Jul 2019 15:13:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:47089) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hjq7K-0005sd-Dr for bug-gnu-emacs@gnu.org; Sat, 06 Jul 2019 15:13:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hjq7K-0001Qb-8Y for bug-gnu-emacs@gnu.org; Sat, 06 Jul 2019 15:13:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Noam Postavsky Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 06 Jul 2019 19:13:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 36496 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 36496-submit@debbugs.gnu.org id=B36496.15624403675466 (code B ref 36496); Sat, 06 Jul 2019 19:13:02 +0000 Original-Received: (at 36496) by debbugs.gnu.org; 6 Jul 2019 19:12:47 +0000 Original-Received: from localhost ([127.0.0.1]:55910 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hjq73-0001Q3-55 for submit@debbugs.gnu.org; Sat, 06 Jul 2019 15:12:47 -0400 Original-Received: from mail-io1-f41.google.com ([209.85.166.41]:36010) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hjq71-0001Pm-TA for 36496@debbugs.gnu.org; Sat, 06 Jul 2019 15:12:44 -0400 Original-Received: by mail-io1-f41.google.com with SMTP id o9so10479879iom.3 for <36496@debbugs.gnu.org>; Sat, 06 Jul 2019 12:12:43 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version:content-transfer-encoding; bh=MM7gawRETZDRjOppwn/RaYcar8Cf58gyQIwEEe+Plyw=; b=STZxLuJvoYhgNFn3UmCXup1hPZy5lalnkuRTQSXD3mhLkcDV0j2lIXi0+lmOA57/c2 /qammqL/Ffqy/VQXsM5loSNBHbke7/irA8O2KQbQNcJHPpNG4rFwxRp0Drsiw0FzQN8j 6U3fURamjQB+lC6hSbcDBeLli60mr7nEbWnN3X8FESEpuex2V1EI7h8JEm094Keeg2jv M/Bcq3CepGI2nKKj7vLrL4w1DbGAomQnrpC5UUVc/SiifYKY2jfzgptZbRBJ/pAYWtzJ JhQdlbVnHZpHvYAPlnIxUe+hc/e6VVglYdZb4J24wVHkI+stSJzA5sBzmcyP9g1XCq9L frDg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to :message-id:user-agent:mime-version:content-transfer-encoding; bh=MM7gawRETZDRjOppwn/RaYcar8Cf58gyQIwEEe+Plyw=; b=CiD3cvc84C1rzOORhzKxB0u0/jwdAzKOOJnRtppF3mIo9I2FiwRIH0Z+vLALq9vaj+ uSBgSjQgawJTGs+Dp03S1bkY77hR3JHYWAlVbKNPQl0I/Fyu2JpsN6o/oD31x272JW8B 6VlfIn+MOyPYE2zMjzXcwNw019TCpuUScii7RhJBekLMTpevqwsHU6mtsjyy2mOge/Gj pFhiwFNL20ig1uCwdLuA4SWwvNhyYRaA6iQZ9wBEDZmvxOnWegw/OpHNzwLUKUp/m6ja ZbUy1aI6FO+kjOg1o9wRi13q58gtEN2Es86Hi0zfiyQ9W2qZ9qP8DRHuXcYUF76QgjK9 8xaw== X-Gm-Message-State: APjAAAXY4anZk99lv460jLCmXbNvwZxoGGFwb9lyh4eRfNEk/TEsyrlZ MNvaqXeKfTIeTA9oEiWZJBEb3dMA X-Google-Smtp-Source: APXvYqxeehihVEkMFiFnZ+adFaUxQVmnereb+CyW1+n61yX0Bxc09NgI+yWlWd9VbsgLEKr0sKGkvQ== X-Received: by 2002:a6b:7317:: with SMTP id e23mr9074654ioh.37.1562440358157; Sat, 06 Jul 2019 12:12:38 -0700 (PDT) Original-Received: from minid (cbl-45-2-119-34.yyz.frontiernetworks.ca. [45.2.119.34]) by smtp.gmail.com with ESMTPSA id z17sm17880676iol.73.2019.07.06.12.12.37 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Sat, 06 Jul 2019 12:12:37 -0700 (PDT) In-Reply-To: ("Mattias \=\?utf-8\?Q\?Engdeg\=C3\=A5rd\=22's\?\= message of "Sat, 6 Jul 2019 20:56:57 +0200") X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.43 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.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:162255 Archived-At: Mattias Engdeg=C3=A5rd writes: > Ah, you called out my little white lie. They are synonyms in practice, > because almost nobody uses minimal-match, probably for good > reasons. (xr used to generate {minimal|maximal}-match, but it was > decidedly less readable so it got changed.) > > Yet you are right in the sense that the documentation should not lie > or wilfully obscure the workings. There appears to be no good > solution, because the underlying design isn't very good. It might be > different if minimal-match affected the entire expression inside, > including (or ...) and (** ...), but that will have to wait for the > next big engine. > > The new patch versions describe the semantics more objectively, while > still recommending the user to stay clear of minimal-match. Good > enough? > +(zero-or-more RX...) Match RXs zero or more times. Alias: 0+ > +(one-or-more RX...) Match RXs one or more times. Alias: 1+ > +(zero-or-one RX...) Match RXs or the empty string. Alias: opt, optional > +(* RX...) Match RXs zero or more times; greedy. > +(+ RX...) Match RXs one or more times; greedy. > +(? RX...) Match RXs or the empty string; greedy. Yep, that looks fine.