From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Ihor Radchenko Newsgroups: gmane.emacs.bugs Subject: bug#68370: 30.0.50; pcase eieio, map, seq, and cl-struct constructs are not described in the manual Date: Fri, 12 Jan 2024 12:47:42 +0000 Message-ID: <87sf32pvkh.fsf@localhost> References: <87zfxdpd99.fsf@localhost> <87h6jkjayn.fsf@localhost> 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="13399"; mail-complaints-to="usenet@ciao.gmane.io" Cc: Stefan Kangas , 68370@debbugs.gnu.org To: Stefan Monnier Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Fri Jan 12 13:45:34 2024 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 1rOGuk-0003Bv-2W for geb-bug-gnu-emacs@m.gmane-mx.org; Fri, 12 Jan 2024 13:45:34 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rOGuK-0001S5-Hj; Fri, 12 Jan 2024 07:45:08 -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 1rOGuI-0001Rh-8j for bug-gnu-emacs@gnu.org; Fri, 12 Jan 2024 07:45:06 -0500 Original-Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1rOGuF-0000uQ-MF for bug-gnu-emacs@gnu.org; Fri, 12 Jan 2024 07:45:05 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1rOGuD-0001Fn-Ji for bug-gnu-emacs@gnu.org; Fri, 12 Jan 2024 07:45:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Ihor Radchenko Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 12 Jan 2024 12:45:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 68370 X-GNU-PR-Package: emacs Original-Received: via spool by 68370-submit@debbugs.gnu.org id=B68370.17050634784765 (code B ref 68370); Fri, 12 Jan 2024 12:45:01 +0000 Original-Received: (at 68370) by debbugs.gnu.org; 12 Jan 2024 12:44:38 +0000 Original-Received: from localhost ([127.0.0.1]:35123 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rOGtp-0001El-Fq for submit@debbugs.gnu.org; Fri, 12 Jan 2024 07:44:37 -0500 Original-Received: from mout02.posteo.de ([185.67.36.66]:54175) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rOGtm-0001ES-Rg for 68370@debbugs.gnu.org; Fri, 12 Jan 2024 07:44:36 -0500 Original-Received: from submission (posteo.de [185.67.36.169]) by mout02.posteo.de (Postfix) with ESMTPS id C90EC240104 for <68370@debbugs.gnu.org>; Fri, 12 Jan 2024 13:44:30 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.net; s=2017; t=1705063470; bh=RvFs9fmUONIHfm//kqz4X3cTVUTJaln4QViuLHgocfA=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version: Content-Transfer-Encoding:From; b=DgQ7qmET/2Kv0kdfROMDIRlUItgAVCz8DWPpIqPv57uc5wBVSN+TUhoB4dwK1NzDS gyD1zNkW2cD7PQ8pYQDmaqo3qypl+ijswHaX6DB1eqCemHYPPWKQxOSOef/BzOTy9A cBGNmqnDEAn/1p2yGgSjuDstzir/1GU2eN/7yscWkGjURM7tDgTqwJ+3KQ1Uqn8tEE lNmnWyOXs2WwQlA8uKbSWeHTSxkNy7A5O/HD52LG7UW4LTHTGkj3/BmNbxf49bifrB eRBM2VBj3KNXBYj2j5Y9oaEK8TfUIybbB7sPsOcT44dg4O3YNWDE1GNEgEauME29t4 rZzss6L8c9LDw== Original-Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 4TBLp56H8Tz9rxS; Fri, 12 Jan 2024 13:44:29 +0100 (CET) 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-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:278022 Archived-At: Stefan Monnier writes: >>> AFAIK these "belong" to `map.el`, `seq.el`, etc... so that's where they >>> should be documented. The documentation for `pcase` could of course >>> include corresponding cross-references. >> Do you mean "6.1 Sequences" section of the manual? > > I meant "where ever it's documented", so yes that sounds about right :-) This might be tricky in practice: 1. eieio is more or less clear - it is a separate manual 2. seq.el is documented in 6.1 section, which may be a problem - the very concept of pattern matching is only introduced in 11.4.1 (pcase) section. So, it might be confusing for the readers to see information about pattern matching so early in the manual. 3. map.el does not have any documentation in manual. It may mean that (map ..) pattern should not be documented. Or it may mean that we need to add a map.el section to the manual. 4. 11.4.1 The =E2=80=98pcase=E2=80=99 macro section already documents =E2= =80=98(cl-type TYPE)=E2=80=99, but not (cl-struct TYPE &rest FIELDS). It will be awkward to document cl-struct pattern in CL manual, while leaving cl-type in the 11.4.1 section of the Elisp manual. --=20 Ihor Radchenko // yantar92, Org mode contributor, Learn more about Org mode at . Support Org development at , or support my work at