bug#64610: 30.0.50; Widget Manual copy-paste error

bug#64610: 30.0.50; Widget Manual copy-paste error

[Mauro Aranda]

Reported by Bryce Carson, here:
https://lists.gnu.org/archive/html/emacs-devel/2023-07/msg00526.html

The description of :value-to-external reads:
‘: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’.

The last paragraph shouldn't be there.


In GNU Emacs 30.0.50 (build 25, x86_64-pc-linux-gnu, GTK+ Version
  3.24.33, cairo version 1.16.0) of 2023-07-14 built on tbb-desktop
Repository revision: 2df086d121e8ebee872236d0436205144047c5c9
Repository branch: master
Windowing system distributor 'The X.Org Foundation', version 11.0.12201001
System Description: Ubuntu 22.04.2 LTS

bug#64610: Acknowledgement (30.0.50; Widget Manual copy-paste error)

[Mauro Aranda]

[-- Attachment #1: Type: text/plain, Size: 89 bytes --]

I attach a patch against emacs-29.  Is it OK to install doc fixes on
that branch, right?

[-- Attachment #2: 0001-Fix-copy-paste-in-Widget-Manual-Bug-64610.patch --]
[-- Type: text/x-patch, Size: 889 bytes --]

From 111fd7d3c4511c482f3c9cd38e46ededd042abdb Mon Sep 17 00:00:00 2001
From: Mauro Aranda <maurooaranda@gmail.com>
Date: Fri, 14 Jul 2023 07:41:58 -0300
Subject: [PATCH] ; Fix copy-paste in Widget Manual (Bug#64610)

---
 doc/misc/widget.texi | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/doc/misc/widget.texi b/doc/misc/widget.texi
index 4ac57a95a43..13b37ab5b54 100644
--- a/doc/misc/widget.texi
+++ b/doc/misc/widget.texi
@@ -1600,9 +1600,7 @@ Defining New Widgets
 @item :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 @code{:value}
-when the widget is created, and on any value set later with
-@code{widget-value-set}.
+external value.
 
 @vindex create@r{ keyword}
 @item :create
-- 
2.34.1

bug#64610: Acknowledgement (30.0.50; Widget Manual copy-paste error)

[Eli Zaretskii]

> Date: Fri, 14 Jul 2023 07:53:26 -0300
> From: Mauro Aranda <maurooaranda@gmail.com>
> 
> I attach a patch against emacs-29.  Is it OK to install doc fixes on
> that branch, right?

Yes.  Thanks, installed, and closing the bug.

bug#64610: 30.0.50; Widget Manual copy-paste error

[Eli Zaretskii]

> Date: Fri, 14 Jul 2023 07:44:43 -0300
> From: Mauro Aranda <maurooaranda@gmail.com>
> 
> Reported by Bryce Carson, here:
> https://lists.gnu.org/archive/html/emacs-devel/2023-07/msg00526.html
> 
> The description of :value-to-external reads:
> ‘: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’.
> 
> The last paragraph shouldn't be there.

Paragraph or sentence?

bug#64610: 30.0.50; Widget Manual copy-paste error

[Mauro Aranda]

Eli Zaretskii <eliz@gnu.org> writes:

 >> Date: Fri, 14 Jul 2023 07:44:43 -0300
 >> From: Mauro Aranda <maurooaranda@gmail.com>
 >>
 >> Reported by Bryce Carson, here:
 >> https://lists.gnu.org/archive/html/emacs-devel/2023-07/msg00526.html
 >>
 >> The description of :value-to-external reads:
 >> ‘: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’.
 >>
 >> The last paragraph shouldn't be there.
 >
 > Paragraph or sentence?

Sorry, sentence.