From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: zyd via "Bug reports for GNU Emacs, the Swiss army knife of text editors" Newsgroups: gmane.emacs.bugs Subject: bug#73505: EIEIO manual out of date, doesn't reflect current functionality Date: Thu, 26 Sep 2024 22:45:27 +0000 Message-ID: <93_8XMSOOu0_kIfElCZTcNDPXyZ0rUh6CXkKtDd-CGAYsSFXcWMggsZyqtlqrYmDQOVMziu5T8CIQ4zL0VrnpKVl85vZ4pCE-cXyL3rHL9Q=@proton.me> Reply-To: zyd 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="29768"; mail-complaints-to="usenet@ciao.gmane.io" To: 73505@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Fri Sep 27 06:22:53 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 1su2VJ-0007cs-La for geb-bug-gnu-emacs@m.gmane-mx.org; Fri, 27 Sep 2024 06:22:53 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1su2V3-0007pT-GP; Fri, 27 Sep 2024 00:22:37 -0400 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 1su2V0-0007p2-Gm for bug-gnu-emacs@gnu.org; Fri, 27 Sep 2024 00:22:35 -0400 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 1su2V0-0007co-89 for bug-gnu-emacs@gnu.org; Fri, 27 Sep 2024 00:22:34 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=debbugs.gnu.org; s=debbugs-gnu-org; h=MIME-Version:From:Date:To:Subject; bh=WX6PYFT69f2Vv+9J+nxdqShAt/xoUU6hu+7Wjqj6cm4=; b=keJ+rNYTqI6UYeLe/cV+HOMoZrdPn27ah0daBwQglTJUyurWSBILNqYiptHzvqcRA2z4nRyfSZLUTZApLeAPeBSGftEKUmzIEtwc5d43YXQYqGyvh3RX2byYOBcCFtWVlfAczU964HqrnnXR3gCanOLY9qshABg8WYhdDNmxlJzYIWB6bWI3Fkyx7rqPkvgVRihr4DVQOi5auqK66sPQ7nveQf6Pa7KnUs92BbfE6bbT9HFS4vrEDFobuQMZqDn+lqJuqqVZnzcruW4bZUyJWz9NWFgLkmKAMSfukRmznG5XFni8Osok2JEY0rREl6/GpF85ufV2szkbgYIYZ/NhQw==; Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1su2VR-0000vp-R8 for bug-gnu-emacs@gnu.org; Fri, 27 Sep 2024 00:23:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: zyd Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 27 Sep 2024 04:23:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 73505 X-GNU-PR-Package: emacs X-Debbugs-Original-To: "bug-gnu-emacs@gnu.org" Original-Received: via spool by submit@debbugs.gnu.org id=B.17274109523525 (code B ref -1); Fri, 27 Sep 2024 04:23:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 27 Sep 2024 04:22:32 +0000 Original-Received: from localhost ([127.0.0.1]:41660 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1su2Ux-0000ui-9d for submit@debbugs.gnu.org; Fri, 27 Sep 2024 00:22:32 -0400 Original-Received: from lists.gnu.org ([209.51.188.17]:43066) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1stxFT-0003sT-6r for submit@debbugs.gnu.org; Thu, 26 Sep 2024 18:46:11 -0400 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 1stxEz-0003lc-8H for bug-gnu-emacs@gnu.org; Thu, 26 Sep 2024 18:45:43 -0400 Original-Received: from mail-40135.protonmail.ch ([185.70.40.135]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1stxEv-00021v-Gh for bug-gnu-emacs@gnu.org; Thu, 26 Sep 2024 18:45:40 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=proton.me; s=protonmail; t=1727390732; x=1727649932; bh=WX6PYFT69f2Vv+9J+nxdqShAt/xoUU6hu+7Wjqj6cm4=; h=Date:To:From:Subject:Message-ID:Feedback-ID:From:To:Cc:Date: Subject:Reply-To:Feedback-ID:Message-ID:BIMI-Selector; b=bq8U/LK9Nucd79R9lmwS6ACC0YI4RihgxTZn7ltiNkdzpZ1bLITZM6KJ1YEoQAOWj bgCeGkpsftMh342dXqwqbpSqLCWB5w/tN8gqP0zlwBCAoTkGY/zDDPLsvDeYeL7E+5 igiFdNpcb8Ph5ko0Lcicj4Kn/7n4/EjK4U49HePB6sF80bw6TUiWZpiWGBnpE/tzNF YJZ1LTXoUenJS3wT9Ibm9qkub3zuNNjdIYfQa/XjaQNegjVdVByvz66kaICO7VwAwk +FOWTFReCQMe04osRiXeBtot64VVDrbMbHZsA3uACmT5uQb4gNQSIt2s2LUH7hEmEF gUutQMxSpcx6g== Feedback-ID: 98211814:user:proton X-Pm-Message-ID: 61d3944eaf796a73a2dbc2586a3be34ca15e49f6 Received-SPF: pass client-ip=185.70.40.135; envelope-from=zyd-p@proton.me; helo=mail-40135.protonmail.ch 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, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, RCVD_IN_VALIDITY_SAFE_BLOCKED=0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Mailman-Approved-At: Fri, 27 Sep 2024 00:22:29 -0400 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:292487 Archived-At: Hi, The info manual for EIEIO seems to be out of date, specifically the introdu= ction section: (info "(eieio) Introduction") Therein it's stated that EIEIO lacks support for both eql specializers and `:around' methods > EQL specialization > EIEIO does not support it. >=20 > =E2=80=98:around=E2=80=99 method tag > This CLOS method tag is non-functional. But this isn't true at all, EIEIO has both of these features fully function= al in fact.=20 ---------------------------------------------------------------------------= ---- (cl-defgeneric inform-chat (msg preamble)) (cl-defmethod inform-chat (msg (preamble (eql :night))) (message "Good night chat, %s" msg)) (cl-defmethod inform-chat (msg (preamble (eql :morning))) (message "Good morning chat, %s" msg)) (inform-chat "that's all she wrote. What more do you want from me?" :night) ;; =3D> "Good night chat, that's all she wrote. What more do you want from = me?" (inform-chat "many mornings such as this one, today is different! Today is = the day I tell you all my hot takes." :morning) ;; =3D> "Good morning chat, many mornings such as this one, but today is th= e day I ;; tell you all my hot takes." (cl-defmethod inform-chat :around (msg (preamble (eql :morning))) (setq msg (concat "even though there are " msg " Now I know, I know... yo= u're sick of them but I must. I'm compelled, even!")) (cl-call-next-method msg preamble)) (inform-chat "many mornings such as this one, today is different! Today is = the day I tell you all my hot takes." :morning) ;; =3D> "Good morning chat, even though there are many mornings such as thi= s one, ;; today is different! Today is the day I tell you all my hot takes. Now I = know, ;; I know... you're sick of them but I must. I'm compelled, even!" ---------------------------------------------------------------------------= ---- So I wonder, how much of the rest of the manual is out of date like this? I= s it not to be trusted as a source of factual information about the current stat= e of CLOS in elisp? Emacs version: 30.0.60 (commit 1154d8aafe2f4702b8fc775835f830fd00cfbaaf) -zyd