From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Kangas Newsgroups: gmane.emacs.devel Subject: Re: master 2a7488d: Add support for displaying short documentation for function groups Date: Wed, 28 Oct 2020 06:50:24 -0700 Message-ID: References: <20201011035127.7723.3256@vcs0.savannah.gnu.org> <20201011035128.E3FD320667@vcs0.savannah.gnu.org> <87k0vxquvo.fsf@gnus.org> <874kmfvkxo.fsf@tcd.ie> <87361z1xp0.fsf@tcd.ie> <87pn53375p.fsf@gnus.org> <4DC3139F-9BB2-49B3-A2D9-8F78FBDDF987@acm.org> Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="3350"; mail-complaints-to="usenet@ciao.gmane.io" Cc: "Basil L. Contovounesios" , Lars Ingebrigtsen , Emacs developers To: =?UTF-8?Q?Mattias_Engdeg=C3=A5rd?= Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Wed Oct 28 14:51:50 2020 Return-path: Envelope-to: ged-emacs-devel@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 1kXlri-0000kA-9s for ged-emacs-devel@m.gmane-mx.org; Wed, 28 Oct 2020 14:51:50 +0100 Original-Received: from localhost ([::1]:32918 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kXlrh-0005gw-B2 for ged-emacs-devel@m.gmane-mx.org; Wed, 28 Oct 2020 09:51:49 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:50778) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kXlqO-0004P7-Sy for emacs-devel@gnu.org; Wed, 28 Oct 2020 09:50:28 -0400 Original-Received: from mail-ed1-x52b.google.com ([2a00:1450:4864:20::52b]:41858) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kXlqN-0002hr-6b for emacs-devel@gnu.org; Wed, 28 Oct 2020 09:50:28 -0400 Original-Received: by mail-ed1-x52b.google.com with SMTP id l24so5183687edj.8 for ; Wed, 28 Oct 2020 06:50:26 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:in-reply-to:references:mime-version:date:message-id:subject:to :cc:content-transfer-encoding; bh=1tb3/rEcbaPJnDXmvgKa+zk0v/91UisrdtQ0Ve/8QuY=; b=GRH6lH+9QZw3NYfvH05nX6Rql0f+DdO0aZeylMa+wIopYbmN4JwclAgmkcRRifuPLs nI4aPQ0/NmnRtf1ORvYy3Lz9ZeUsJ4wItk6KtxySFsmTwQ04oQRgCKc7pc2ll63wCEXj QDVQ24CMOZsvsVwcgwkXXZTzuc8Rkj+5kzfUUCvnMFo8W0hOV5hUpgorUCBFBC5IdbtL Vql0Hz+g8ctoPykl69K34qVbqKtoz5sa5EvaSQIXSMhHcTROtX3r7AyRjkf21miGH8km 9XdsT8NUHsSkwiO7M8d+xVwsAQDvSCUYvQfXIj/uykH/09AN4lKOW/AbXOtij+SOcfNN XPTw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:in-reply-to:references:mime-version:date :message-id:subject:to:cc:content-transfer-encoding; bh=1tb3/rEcbaPJnDXmvgKa+zk0v/91UisrdtQ0Ve/8QuY=; b=XOtM6VY1ijhJwXNHd1KS2biwPMv180v1uPX+R1dqsG7Y2vrJDu+Fi8SFjKFuNWK+x8 LRkj0+avNMZvhNScAt2CBNtYLA6WP23YO3K4WS/PVjI7jALnlgn97TVEo6SbEgnOiEHo Ho9UMOsz/y44S9jcD9WS7zOwPiMwbkVruP4sxz+woP5+XtDaA09hlL/VHf53PUEP7jfh VNxPBuoiY5rQsiigBwD+TgmE0Io5xEgi5bwgCn6wZBGpdWPTobcQ7FqD/G6DTSx87RqJ pqzDwsz3FRQDU6q4hFcuOXUdBr9pdDeQl1n0SPVfba/5gIgjMZoM/Ci4fXtyhMQx9yjD MvIw== X-Gm-Message-State: AOAM531FoTKkvhNOHXroJOBiWMB88FOOvP7l7KN95nlrWfeD7a4HCHwt 2A3REYyolJrKc5Rw9qKA2HuXei3XZKP/0R7h7vc= X-Google-Smtp-Source: ABdhPJxHn+awWj7BNsFnwKR7F5exNdvR6f8+ZLQpoNYK8NgLsjdeHPATKwRCgfIHdbWWVRwSZtq3kH0iJzkvBedLBe0= X-Received: by 2002:a05:6402:3133:: with SMTP id dd19mr8063903edb.100.1603893025508; Wed, 28 Oct 2020 06:50:25 -0700 (PDT) Original-Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Wed, 28 Oct 2020 06:50:24 -0700 In-Reply-To: <4DC3139F-9BB2-49B3-A2D9-8F78FBDDF987@acm.org> Received-SPF: pass client-ip=2a00:1450:4864:20::52b; envelope-from=stefankangas@gmail.com; helo=mail-ed1-x52b.google.com X-detected-operating-system: by eggs.gnu.org: No matching host in p0f cache. That's all we know. X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:258534 Archived-At: Mattias Engdeg=C3=A5rd writes: >> - I moved match-beginning and match-end to the new section "Match Data", >> and moved it below "Looking in Buffers". > > Perhaps 'match-string' belongs there too. Indeed, so I fixed that. > + :eval (rx (| (* "f") (+ "o") (? "o")) (any "bar") (group "baz")))) > > (any "bar") may be misleading since it looks like "bar" is a string to be= matched, but it is just the characters {a,b,r}. I changed that. Though, to be honest, perhaps we should replace this entire example with something that actually demonstrates _why_ one would want to use `rx'. I just couldn't think of a good example right now. There is time to improve the example before Emacs 28.1, I guess. > (If you want to be complete, the rx family also includes rx-to-string, rx= -define, rx-let and rx-let-eval.) I added all of them into a new section and pushed this to master. Thanks.