From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Mauro Aranda Newsgroups: gmane.emacs.devel Subject: Re: Community improvements to the Emacs Widget Library manual? Date: Fri, 14 Jul 2023 07:48:27 -0300 Message-ID: <9cac52ff-5d21-cae8-a9d1-0d126d2b5e3a@gmail.com> References: <7494e36a-9245-cd4c-5515-5ec26d1889c7@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="26299"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101 Thunderbird/102.11.0 Cc: emacs-devel@gnu.org To: Bryce Carson Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Fri Jul 14 12:49:18 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 1qKGMQ-0006dO-4V for ged-emacs-devel@m.gmane-mx.org; Fri, 14 Jul 2023 12:49:18 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qKGLk-0002lv-7a; Fri, 14 Jul 2023 06:48:36 -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 1qKGLi-0002lY-A5 for emacs-devel@gnu.org; Fri, 14 Jul 2023 06:48:34 -0400 Original-Received: from mail-oa1-x34.google.com ([2001:4860:4864:20::34]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1qKGLg-0003u3-Lx for emacs-devel@gnu.org; Fri, 14 Jul 2023 06:48:34 -0400 Original-Received: by mail-oa1-x34.google.com with SMTP id 586e51a60fabf-1b038d7a5faso1368578fac.1 for ; Fri, 14 Jul 2023 03:48:32 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20221208; t=1689331711; x=1691923711; h=content-transfer-encoding:in-reply-to:from:cc:references:to :content-language:subject:user-agent:mime-version:date:message-id :from:to:cc:subject:date:message-id:reply-to; bh=VMk2O5NKOdZnqwlBur6TB71aW4T0ExfO7Mlo27Wo0U8=; b=ZoatNf60TbxyTnRUyCKLG1Quf0tM0e5EdlGGWlt8cmcHwkCIIxvQePWYjlo+4M6ucs UHkp73hVW7ZldAj7WkJ83PtRI2uK80t0A9guCrxj5ebGechGxJ3yGMdYUPoWi4qBZZ2x LaRdHfcKJCCA25TgI0v3bzXrquw16rCK9FvvlX4UjgiC1R67twYXUSkBOMhdHC5Mtf+k 9GKnQmSeC/8BulXxT82d24+aFuv8a2lhid9IYeQbzKAtymkz0g0WLhZKK8bD6kwsh8HY uU9TMg6+XEf6cNbfaLuIOsuNgeLsW2pP1PCt6P3d+3Aw8SW2wS7ge6hoXrDN4fAizbk2 9h0A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1689331711; x=1691923711; h=content-transfer-encoding:in-reply-to:from:cc:references:to :content-language:subject:user-agent:mime-version:date:message-id :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=VMk2O5NKOdZnqwlBur6TB71aW4T0ExfO7Mlo27Wo0U8=; b=RzFJsyC9Tq2uyVJl97DWjtARMmB3PyGqoOzv7g4eLf1Ze8kbjDzOqBQt+fFkkBcy+s dFJhV1+w9fuYTaLLZ8YgzQH1w18+HFkwcD3BoK4TKHobqmDtiO59pZPUwCWWs2p5Grtk GHNIduzytn6wKrTuktTWyKtRSYXZcsM/Vg46bLe6DcKbJE9Ob6iybpqduwCbM9ojsbk8 ON+idWs+VrhyT0PI93KdkOLVpABZF3UfydrNzr8jegOkY+8hTjEHC/jjp6daLoPUZEC7 EElVpTdGsW3oQRY8pEwFq5u8f+aJ3/586AflXPjRB4ZdD2d+Wbm3xzBwxjpSXNfMLjvk r24w== X-Gm-Message-State: ABy/qLabc1W1EQoKj4KV7ts/gi0t/focouG7P62kicyncS5ktyr8Yz4P XklT0KN/KGe2Pk7bFNAaCk8RD3tB74xjUg== X-Google-Smtp-Source: APBJJlF8VOZTSklsjJqIFA0zYTQOBLYB/+Pm/GDd+0gizPUco9ls/TGm/+lCXxwhZSEKvKi21y2slQ== X-Received: by 2002:a05:6871:97:b0:1a9:71c3:b7c2 with SMTP id u23-20020a056871009700b001a971c3b7c2mr5460236oaa.50.1689331711120; Fri, 14 Jul 2023 03:48:31 -0700 (PDT) Original-Received: from [192.168.0.234] ([186.127.128.249]) by smtp.gmail.com with ESMTPSA id b1-20020a056870b24100b001a9eb707366sm3842447oam.15.2023.07.14.03.48.29 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Fri, 14 Jul 2023 03:48:30 -0700 (PDT) Content-Language: en-US In-Reply-To: Received-SPF: pass client-ip=2001:4860:4864:20::34; envelope-from=maurooaranda@gmail.com; helo=mail-oa1-x34.google.com X-Spam_score_int: -21 X-Spam_score: -2.2 X-Spam_bar: -- X-Spam_report: (-2.2 / 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, NICE_REPLY_A=-0.096, RCVD_IN_DNSWL_NONE=-0.0001, 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:307862 Archived-At: Bryce Carson writes: > In the section Defining New Widgets, the following quotation reveals a > bug, I believe. I added emphasis for the last sentence of each > description of the keywords. I believe that for the :value-to-external > function, the last sentence is not supposed to be present. > > :value-to-internal Function to convert the value to the internal >     format. The function takes two arguments, a widget and an >     external value, and returns the internal value. The function is >     called on the present :value when the widget is created, and on >     any value set later with widget-value-set. :value-to-external >     Function to convert the value to the external format. The >     function takes two arguments, a widget and an internal value, >     and returns the external value. The function is called on the >     present :value when the widget is created, and on any value set >     later with widget-value-set. > > It looks like the author or editor of the descriptions coped them, > which is fine. It doesn't make sense that :value-to-external would be > called when the widget is created, nor when new values are set with > widget-value-set. > > Other places in the manual state that the value of the :value keyword, > when creating or defining widget, should be in the external form, more > evidence that the last sentence is a bug. Thanks.  I filed a report at: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=64610 Please, if you find new bugs, report them with M-x report-emacs-bug