From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Michael Heerdegen Newsgroups: gmane.emacs.devel Subject: Re: Community improvements to the Emacs Widget Library manual? Date: Mon, 10 Jul 2023 05:38:53 +0200 Message-ID: <87y1joph9u.fsf@web.de> References: <1e042c59-9baf-ee4f-4726-26aba36847d4@cyberscientist.ca> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="22256"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Cc: emacs-devel@gnu.org To: Bryce Carson Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Mon Jul 10 05:40:03 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 1qIhko-0005cO-VF for ged-emacs-devel@m.gmane-mx.org; Mon, 10 Jul 2023 05:40:02 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qIhjx-00088s-Ml; Sun, 09 Jul 2023 23:39:09 -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 1qIhjw-00088k-Od for emacs-devel@gnu.org; Sun, 09 Jul 2023 23:39:08 -0400 Original-Received: from mout.web.de ([212.227.17.12]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qIhjv-00084j-42 for emacs-devel@gnu.org; Sun, 09 Jul 2023 23:39:08 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=web.de; s=s29768273; t=1688960334; x=1689565134; i=michael_heerdegen@web.de; bh=Xenc2ri5Cx6lyADqgdxZeGx6FZiIVk0mYBDA4sR8nMQ=; h=X-UI-Sender-Class:From:To:Cc:Subject:In-Reply-To:References:Date; b=XWreMs9b89QzScTG96zSwON9NvB1yxE2VA3jLsnwsJqVc5bQWBnFn0GSgdFWJvXJjLHiBU4 fYyYLtYRuZ0TpwPQ4aYMJlK0iDIYQhRmdMMvFepX/gIrvXVV0KQWAXojgBI+4pCqEeUO8ZsUi aEJm76yfzuTXNZXHK3mSlYkrkRLNAx0w9mBuiddRtli/iIYw/oJXuA2wg47nzVi5Keiv+wWyo 7xKW3Fyj4VNG7tGoUK0X8G0PMTLTsrC7Qyp8oe8Rep5R0LkEQCCXn7VAml9wt7UOToc6Tke+N 16FEf1kGOX7oQ11MG2djBBTipUIc3/ZSLJ6nvZixAW9aMy7/vZsA== X-UI-Sender-Class: 814a7b36-bfc1-4dae-8640-3722d8ec6cd6 Original-Received: from drachen.dragon ([84.59.210.36]) by smtp.web.de (mrweb105 [213.165.67.124]) with ESMTPSA (Nemesis) id 1Mfc4g-1plopS2CQi-00gACp; Mon, 10 Jul 2023 05:38:54 +0200 In-Reply-To: <1e042c59-9baf-ee4f-4726-26aba36847d4@cyberscientist.ca> (Bryce Carson's message of "Sat, 8 Jul 2023 14:18:21 -0600") X-Provags-ID: V03:K1:TB/y/KDurY89HKu28XkE1Yd2ku1253oR4xYTwPxRzdpg5mqyjwB loqigDg0/h2EtRXnmg1oM6iG9cBBbG9wsF3vQ6CvBT/QIkb6BC8RALNBoYe/HCMyCx2Z7Jq TaZBdG+juYALE/R0Dnu3awKvk+e88eh9FyIBjOJiS+FA+NdxsClapF0c5fOkuTN9Q8/Zqh3 9wwZSWnKBur8JY9oRQgeg== UI-OutboundReport: notjunk:1;M01:P0:96YCI/9aw1Q=;Aq4JNGd0N/06vJG4JrrrAUkBhqo 8YJNVmFTocVn94y1J9dgL/2psAT1+Ku2OpcFaBe04MTMlk+TqBKperJ8wTpkynkU47jCw4jAA rmCgw8phe2IstXiH2EzibGpKhcJiBcadEWZ1vm3GZbsPVVqXY3bEZ7xKLdasP0Bbk2aIk3zHi 3bHg0sovftDOIIxDGvxTHIC377GyUgWm15xEI6DCL2IfsRZlxNp5wnwG7HhFhIIgu84AUieoK zLRlFX5HGAjMlZG4Ana53Uk7U6DzM5g2/49sA8S06MTrIa2A9lWIVgxwW7eKSxt0WjQDEHTn1 qdxccgmwPGjXRNTxfOr9Zt066riKdubdJvShvsFhkkoKqlnrS0Yj5SvKxWw3q8+KJElwpSDfj ASWRJzHiQ7qrDfe4dZBorViO5s94nB44vNtFl6R3mYmya7VJh4o5R+k/Rod3SyM9NQQRiH18e 2JGWO8BwpFaRIKkJDCB3dR66NuHKa3vZK7+hD64CrxlPeRIpSGSx3z4GwU1aEKGH/rjfVr7Rb kNOJ0lOh84zfXDqC4rlP52NPrYcSDmj7/mgTfXM1WQHiqAy96jGZf+JZ/fViTrKqcMukkL5FP brqWe6DI5TDsu/Teak2RN/VOaCL6rblm39bqeeBC8qJ2RwxqAKqdOlGXdzMXWz2rMtmsolime 7r5m6FoPl1aBRkZgtU8aMB9aZHYuzosi3p1v+XRz242riNQ8LsY2ybQKbw9GNokPuPFeeQmPB ulR+oWU5wAes9hUt+nLsx/YtVO4MBu1ZwnHB9T4mLjgIT9j4m/ndfg6EoZGNVrpNxEeFhai1 Received-SPF: pass client-ip=212.227.17.12; envelope-from=michael_heerdegen@web.de; helo=mout.web.de 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_MSPIKE_H3=-0.01, RCVD_IN_MSPIKE_WL=-0.01, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action 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:307707 Archived-At: Bryce Carson writes: > One aspect that is confusing is widget definition with widget-specific argument > handling. Built-in widgets handle arguments after the keyword-value pairs in > widget-specific ways. How do end users create such behaviour in their own > widgets? The answer is a function value for the widget-create keyword, but this is > a difficult thing to implement. What keyword handling do you mean, exactly (example)? I ask because AFAIR, `widget-create' works fine for user-defined widget types. Then either these are used implicitly (by the widget type you are deriving from) - or you can refer to the values using `widget-get' in the functions implementing the widget behavior (in `define-widget'). What I missed in the documentation most of all was an explanation of the meaning of the keywords. There are a lot, and I recall that some widget types totally ignore some keywords and one has to use another one with a similar name instead, etc. I.e. it would be good to document which keywords are meaningful for which builtin widget types. Michael.