From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: Instead of pcase Date: Fri, 01 Dec 2023 20:40:28 +0200 Message-ID: <831qc5ahr7.fsf@gnu.org> References: <87fs169mjj.fsf@posteo.net> <093f11a1-57c2-5e56-d39b-26fef1c67cbb@gutov.dev> <25942.25061.217864.329049@retriever.mtv.corp.google.com> <87zfzdcz6z.fsf@posteo.net> <763f067b-4ca9-1eba-9f3c-424c38589e9c@gutov.dev> <83fs0navpj.fsf@gnu.org> <838r6ebfhw.fsf@gnu.org> <83msuu9m2y.fsf@gnu.org> <83il5i9e49.fsf@gnu.org> <241fce6d-fbb6-aa7c-b0b5-5a654eec023d@gutov.dev> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="1344"; mail-complaints-to="usenet@ciao.gmane.io" Cc: joaotavora@gmail.com, owinebar@gmail.com, rms@gnu.org, philipk@posteo.net, emacs-devel@gnu.org To: Dmitry Gutov Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Fri Dec 01 19:41:55 2023 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 1r98SZ-00006V-9z for ged-emacs-devel@m.gmane-mx.org; Fri, 01 Dec 2023 19:41:55 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1r98Ri-0005vQ-Di; Fri, 01 Dec 2023 13:41:02 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1r98RX-0005tI-GM for emacs-devel@gnu.org; Fri, 01 Dec 2023 13:40:55 -0500 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1r98RR-0008Hr-QW; Fri, 01 Dec 2023 13:40:47 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-version:References:Subject:In-Reply-To:To:From: Date; bh=/7CX7mUgEDWKpU6iU0vwUZD2ls853p93TaWh5NlSS4Q=; b=pN8uNFMY2V/nzMFcNS5g a4sonGgDKcmigBOJEnKbUlbfOMYLjORlhjLdnyqIqVn17xIl43AnmcaCc6WgEjnDZ/HQBs0bY7efX 5x/MIKZuicP9npKZFPu+/07uqBGgcxSIvU/n3VuDv7+muKryUczvt9mClOOuJoczVReSrhSpV2JXx kEuViI72oEX9B4mhsRKJ3Nc012QeL7Wn77gma9zHg3mndP1d6eKBSpFo6rotdteWATWLrBJzeHEZx ZzfrukMqBEBMao+9Y7Mrw3jXbi5CXCijiMwOTWBARWWF/B7cCWbScN7RI4eYswHAGm+vlfvznbNdS y53Q96D6hl8yIQ==; In-Reply-To: <241fce6d-fbb6-aa7c-b0b5-5a654eec023d@gutov.dev> (message from Dmitry Gutov on Fri, 1 Dec 2023 20:28:43 +0200) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 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-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.devel:313450 Archived-At: > Date: Fri, 1 Dec 2023 20:28:43 +0200 > Cc: joaotavora@gmail.com, owinebar@gmail.com, rms@gnu.org, > philipk@posteo.net, emacs-devel@gnu.org > From: Dmitry Gutov > > That just reaffirms my understanding that the main problem with 'pcase' > that we have is documentation. The nodes are written very bottom-up, > whereas what's really needed for someone to understand the core usage, > would look more like the first half of the node "Destructuring with > ‘pcase’ Patterns". Suggestions to improve the documentation are always welcome. However, what we have now is the result of efforts by several people, so I'd hesitate to conclude that the documentation is the main problem. > Jim Porter's suggestions for improving the docs are in a separate thread > ("Improving 'pcase' documentation"), it really deserves more attention. It already did get attention. It will get much more when Jim posts patches to the manual and the doc string.