GNU bug report logs - #70502
30.0.50; Widget manual typos etc.

Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.

Package: emacs; Reported by: Stephen Berman <stephen.berman@HIDDEN>; Done: Stephen Berman <stephen.berman@HIDDEN>; Maintainer for emacs is bug-gnu-emacs@HIDDEN.

Message received at 70502-done <at> debbugs.gnu.org:


Received: (at 70502-done) by debbugs.gnu.org; 22 Apr 2024 09:57:10 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Mon Apr 22 05:57:09 2024
Received: from localhost ([127.0.0.1]:45740 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1ryqQ8-0005oL-RK
	for submit <at> debbugs.gnu.org; Mon, 22 Apr 2024 05:57:09 -0400
Received: from mout.gmx.net ([212.227.17.20]:32789)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <stephen.berman@HIDDEN>) id 1ryqQ6-0005n6-2a
 for 70502-done <at> debbugs.gnu.org; Mon, 22 Apr 2024 05:57:07 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmx.net;
 s=s31663417; t=1713779804; x=1714384604; i=stephen.berman@HIDDEN;
 bh=JKL6ShS7Dt2oUaAak+19cxz2xo7C8Moom7xYWCaH+To=;
 h=X-UI-Sender-Class:From:To:Cc:Subject:In-Reply-To:References:Date:
 Message-ID:MIME-Version:Content-Type:Content-Transfer-Encoding:cc:
 content-transfer-encoding:content-type:date:from:message-id:
 mime-version:reply-to:subject:to;
 b=n+2ByHLuxqD3W8yAbCXYqWVVdZTN/kdIFQLzPElNN7WkZvAz6ROnP1def9VdTEDS
 6ChegnJhSjcFLQVkiy2HiHNp6W++qbthGGM6oBuAyEmehx/uOTICHtMegABRroXBd
 S28yXVQ6cW31vUk3zf7+/HnJFSijGhR5EsxOTUO5zMJLnZWiNJ60YFAmAkC6ib2Aq
 2PX+/hhff8cixNok4b5IY8tb/M25pp5HPdVU1G/ubHd/I3i+SefK2z9LZPw6BToZM
 TtyZngzH6KEhha9Bhe4XEwfDS9SNaAsBjSxYwnz8QmAt6auoKsh2uVUNBTSTLB6C6
 w7IidVgZNb3vh6JRzA==
X-UI-Sender-Class: 724b4f7f-cbec-4199-ad4e-598c01a50d3a
Received: from strobelfs ([94.134.95.63]) by mail.gmx.net (mrgmx104
 [212.227.17.168]) with ESMTPSA (Nemesis) id 1MvK4f-1sq7is45ib-00rDFl; Mon, 22
 Apr 2024 11:56:44 +0200
From: Stephen Berman <stephen.berman@HIDDEN>
To: Eli Zaretskii <eliz@HIDDEN>
Subject: Re: bug#70502: 30.0.50; Widget manual typos etc.
In-Reply-To: <86r0ex67w5.fsf@HIDDEN> (Eli Zaretskii's message of "Mon, 22 Apr
 2024 12:53:14 +0300")
References: <87zftmlcxo.fsf@HIDDEN> <86il0a6k04.fsf@HIDDEN>
 <874jbtenxe.fsf@HIDDEN> <86r0ex67w5.fsf@HIDDEN>
Date: Mon, 22 Apr 2024 11:56:43 +0200
Message-ID: <87zftld8kk.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13)
MIME-Version: 1.0
Content-Type: text/plain
X-Provags-ID: V03:K1:RuFU3idNhmQ0EC2JgXKsxGcwtKXrNLwSuLxvE8AsTcn9Y/XuB6x
 LVXK4G+diQVVdi60UxlnWggP68nBRF0N6w6es/FGAwocSypHp+xYiTxqWmsE2jsLXt23iL3
 vmPFpq8qfZYRkYhREq+tccSSOgNsLQy1GWrRrAksPNr2pEwqPYl2A0662tuCbTM51lWahOT
 NVPXjXpe/Txlo2tGzQrvA==
X-Spam-Flag: NO
UI-OutboundReport: notjunk:1;M01:P0:V9HVKIHeLu4=;0Xogb4uHCdspnFUQq9Hhf23b2Z6
 WrXG46oQctkejBgDx+NgteELwf7TUTvsfRMTrKReSqdP2iU48HN0P/UZ3XUBGpV8uO7pPznHD
 jKxoY+4/xCJRB53txm6cQOtleBZlVzeKei8ThIOytEx9PBEIamJ3+m6spApGgtsyhzZ38O6zk
 4/99cD3LoPf/pNOwClA/GlN2lx93nLpW4LvP/LyrIVQXLV1Wv5ZfTLy6rzdbpwCRUwTI/RWKH
 rmUxAkqC44g+QwfMkauS/0n0ozvhxzrgR+9xXGitdfaG7Gq0tvvRH8hRkRjpycDxOFndOZBnr
 xzS7rIarRy4MX7r2itenlI1ArGn/pGFYsUqnMdXqoBskGl4GYUgJCsz8ZcAry8ZheqZ5ILO8X
 PWwNfsL7v2tklZQl9qPI6dAxg6rBZQSeyyh/uJtv8eDnPWtgfH6MojC9UC6sausgge04hboCH
 HDqiN4foqHk/ooup3Qj5ycJQAedRoq2i1lV6T5SzmTnBGd+dgSY7YxKPPbIQGWqV5cGZ+0+lQ
 IBTOHTNs1VdzAW563YJkZ2tXFN2jiGQcArhWTzH3walovw57wuCn19qMVL/M/HNBsc98XHLxG
 nZ3clFJEleHbh47mNOSb9UOYRiXjlT6l4lNVuL3lJMYojYR/ZmVx7DvO7RLHH+OWgaDLasYGO
 APKxuCqNdykQbt3dx1GS3sCPulef+larQZnoE2KDr6IMBzb1LZIETwmSyS1dDO+KHF7txztm4
 PReQcTnwx+yhdIGYKp5ACGaNe3WamjkYworqPIWRu8jhTTPd95sD+6yxKkTHSXzqaxruoZxoJ
 TqPII2ktU7C7bD1TstHEBF66gb/KZtmOQd9koC09CMKLE=
Content-Transfer-Encoding: quoted-printable
X-Spam-Score: -0.7 (/)
X-Debbugs-Envelope-To: 70502-done
Cc: 70502-done <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.7 (-)

On Mon, 22 Apr 2024 12:53:14 +0300 Eli Zaretskii <eliz@HIDDEN> wrote:

>> From: Stephen Berman <stephen.berman@HIDDEN>
>> Cc: 70502 <at> debbugs.gnu.org
>> Date: Mon, 22 Apr 2024 11:39:41 +0200
>>
>> On Mon, 22 Apr 2024 08:31:39 +0300 Eli Zaretskii <eliz@HIDDEN> wrote:
>>
>> > Everything you say is correct, and the patch is OK.  Thanks, feel fre=
e
>> > to install on the emacs-29 branch (assuming the same problems exist i=
n
>> > this manual there as well).
>>
>> Thanks, done as commit 2a533514929.  The only differences before that
>> between widget.texi in emacs-29 and master were the recent changes in
>> commit 91333dacfa1 on master (bug#70413).  Will those differences
>> prevent merging the new changes in emacs-29 to master?
>
> I hope not.  But even if they do, resolving these conflicts is almost
> trivial, and is routinely done at merge time.

Ok, thanks.  So now I'm closing this bug.

Steve Berman




Notification sent to Stephen Berman <stephen.berman@HIDDEN>:
bug acknowledged by developer. Full text available.
Reply sent to Stephen Berman <stephen.berman@HIDDEN>:
You have taken responsibility. Full text available.

Message received at 70502 <at> debbugs.gnu.org:


Received: (at 70502) by debbugs.gnu.org; 22 Apr 2024 09:53:41 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Mon Apr 22 05:53:41 2024
Received: from localhost ([127.0.0.1]:45724 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1ryqMl-0005PW-TJ
	for submit <at> debbugs.gnu.org; Mon, 22 Apr 2024 05:53:41 -0400
Received: from eggs.gnu.org ([2001:470:142:3::10]:39246)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <eliz@HIDDEN>) id 1ryqMj-0005OS-QM
 for 70502 <at> debbugs.gnu.org; Mon, 22 Apr 2024 05:53:38 -0400
Received: from fencepost.gnu.org ([2001:470:142:3::e])
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <eliz@HIDDEN>)
 id 1ryqMO-0005rQ-Fk; Mon, 22 Apr 2024 05:53:16 -0400
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org;
 s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date:
 mime-version; bh=g3gZXbzN/TVo1OptfX2Od5y0XYfQQ/F03tVpMnq4mc8=; b=XCJMLRXgikK3
 ltEBLPOWXvHqdLyAwglMFHVqaRha5WAmcrY1jE1PCYae+tyOzf1gUxQLKzQE0gI0JAUCYpBf/ImFF
 zMSmWNyAqTuWf1Wa5/bszAqCipDtAIh/6UIukWOCSX7kXU1Tck5sAjnDGuDxn9uN7nGAH41WLCOIW
 HTS5eSXpsQoaW5Abki0o3D1ASohhyIz/tfPaG4C/JKgeeKYmXMhm8bPUQ8JIZ2sGcyO0aAnx+gneD
 IjWofhQviDVOPx+yYPZUYTdp6lcnTVb/VQZINN+1Bajx5p9+19Zx/i1CQv1apcti8ARMoKctdDaDm
 YrzXDjLSK11IbW79XXY2gg==;
Date: Mon, 22 Apr 2024 12:53:14 +0300
Message-Id: <86r0ex67w5.fsf@HIDDEN>
From: Eli Zaretskii <eliz@HIDDEN>
To: Stephen Berman <stephen.berman@HIDDEN>
In-Reply-To: <874jbtenxe.fsf@HIDDEN> (message from Stephen Berman on Mon, 22
 Apr 2024 11:39:41 +0200)
Subject: Re: bug#70502: 30.0.50; Widget manual typos etc.
References: <87zftmlcxo.fsf@HIDDEN> <86il0a6k04.fsf@HIDDEN>
 <874jbtenxe.fsf@HIDDEN>
X-Spam-Score: -2.3 (--)
X-Debbugs-Envelope-To: 70502
Cc: 70502 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -3.3 (---)

> From: Stephen Berman <stephen.berman@HIDDEN>
> Cc: 70502 <at> debbugs.gnu.org
> Date: Mon, 22 Apr 2024 11:39:41 +0200
> 
> On Mon, 22 Apr 2024 08:31:39 +0300 Eli Zaretskii <eliz@HIDDEN> wrote:
> 
> > Everything you say is correct, and the patch is OK.  Thanks, feel free
> > to install on the emacs-29 branch (assuming the same problems exist in
> > this manual there as well).
> 
> Thanks, done as commit 2a533514929.  The only differences before that
> between widget.texi in emacs-29 and master were the recent changes in
> commit 91333dacfa1 on master (bug#70413).  Will those differences
> prevent merging the new changes in emacs-29 to master?

I hope not.  But even if they do, resolving these conflicts is almost
trivial, and is routinely done at merge time.




Information forwarded to bug-gnu-emacs@HIDDEN:
bug#70502; Package emacs. Full text available.

Message received at 70502 <at> debbugs.gnu.org:


Received: (at 70502) by debbugs.gnu.org; 22 Apr 2024 09:40:18 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Mon Apr 22 05:40:18 2024
Received: from localhost ([127.0.0.1]:45670 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1ryq9p-00013I-VP
	for submit <at> debbugs.gnu.org; Mon, 22 Apr 2024 05:40:18 -0400
Received: from mout.gmx.net ([212.227.15.18]:41607)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <stephen.berman@HIDDEN>) id 1ryq9c-000108-NZ
 for 70502 <at> debbugs.gnu.org; Mon, 22 Apr 2024 05:40:07 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmx.net;
 s=s31663417; t=1713778782; x=1714383582; i=stephen.berman@HIDDEN;
 bh=Aq62QHGWh7RalsCsuCwXLMKKvFFf25UZkZoe92ps5P8=;
 h=X-UI-Sender-Class:From:To:Cc:Subject:In-Reply-To:References:Date:
 Message-ID:MIME-Version:Content-Type:Content-Transfer-Encoding:cc:
 content-transfer-encoding:content-type:date:from:message-id:
 mime-version:reply-to:subject:to;
 b=Kcn+GQe1vByUgLvDbIjf70RZNevRTlpk9wIO7SPj4OuEO8eq8fY0pYTGzD+t9m1F
 KwuVPUG8m7HU5RSHMgDjAc24DUAirWZRV7esfwZ8Dp1NBugkGwfeiP274H0h4iCaL
 2AX319TX4GL1k13HzloLIollEL0cB7+xXiixZIEYzGyNO7ArA+2kSel6IiJdUeWfP
 taiLLoCiZDyGygQnOzJT//sj3hkAjm8UC2AzMFUFM1K3nrNFdhCdkMJk9p99nOpvT
 Y/v/i28OFitZrXYPR0Dj2JBM56qobKOMqKMXv+MIjT6de2zGfN4KFdUJL3x/WKXd5
 qRCo+mfi2Qu2mda1jA==
X-UI-Sender-Class: 724b4f7f-cbec-4199-ad4e-598c01a50d3a
Received: from strobelfs ([94.134.95.63]) by mail.gmx.net (mrgmx005
 [212.227.17.190]) with ESMTPSA (Nemesis) id 1MS3ir-1s9buP2f7b-00TVBp; Mon, 22
 Apr 2024 11:39:42 +0200
From: Stephen Berman <stephen.berman@HIDDEN>
To: Eli Zaretskii <eliz@HIDDEN>
Subject: Re: bug#70502: 30.0.50; Widget manual typos etc.
In-Reply-To: <86il0a6k04.fsf@HIDDEN> (Eli Zaretskii's message of "Mon, 22 Apr
 2024 08:31:39 +0300")
References: <87zftmlcxo.fsf@HIDDEN> <86il0a6k04.fsf@HIDDEN>
Date: Mon, 22 Apr 2024 11:39:41 +0200
Message-ID: <874jbtenxe.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13)
MIME-Version: 1.0
Content-Type: text/plain
X-Provags-ID: V03:K1:globc55Qt/2kn473tGmyptIGXpeP8wYxWifWuxRbs0CKjQl8HD6
 5mM5Ig0QHZcLrptmMDUtGQv7dz4RL1jxDQ/k+8rfgOeA6mcMsjzJ4Pp1FfGLh6zLm6jyqg6
 n24i7/qWohjNDZ2wtOS/oh/cWX3YTI6OkpixWzep559ZAF8ybStWpCLw3T0ei67cQrqw6Eg
 X+YApI/rvSTQ9pGCjPZ1A==
X-Spam-Flag: NO
UI-OutboundReport: notjunk:1;M01:P0:uRc9bOxwD5E=;M5sbyCd5gkJD4qBjxngI5T3vS1T
 y2rcKyRfWL7hIjKf+Ezt6prNXHS62Rze3VNAjhEM1sHsTk7sr2nALDs1roP/7d9Pm8BUWSx/m
 5KjMuBKgOkoVIO2MKTJXcHA4JNnoQx1Zx1trB8OSm6OQ7PlhV/gFzff9c7qoPdWrKHr8XiTFf
 S9KR2F1vqLx7f+ikj1Y9Can1bEK6pt4zs6BEIMmyVAzl2SnDDSuWBOHSX8Q8kFSZWkWoFbCaT
 vpgMoesEzyW7p2t3dwK+pcIQxNFLR2HBkO/2zdu3/eSXxT8DS5WfQ1ygJk50J49Qe/U70KZNT
 J5W/feQGAly4vraFgIa9RFn7MmvE9GcACE05Y1SeKflc6W7Yt9blaE3A/eah1ANY+uAT/HqkM
 ak8MNXyJUi5NtAr2V0EGObT0Qit447fZu+Sc+8cl3Lt7gxQoevqjTY1sAEHJD4JxN75jLb89p
 unojW/0nYaJEvOlxX4gbSHoZ2MGXMq99CHt2gLjTRfSlS5fSDjXfzUE0G1KiICwTNBs7tQtrV
 QwJW/rsPokinIv6QvQrkk20CSNjZPFrVetq/I+ZB33OJUWt+zCZaGp1ETEhZ5fo8PwZz7j45N
 vW/0gdbQH6Ett2Gd/g3h8Q5qE6YH0DoACehESBp6gi5OrBjv4wVFCC31bdVtvq9/Hn8Wn1uOs
 QIcqk3Hc6T/4PZy+PxgftMKROn7+tWxb2o7ImHE4VWJuxr0PNHH0c08ESxaq9WiDAZoDc858M
 ssWUY0AOQfSdjihuNgzk/yUHFx66REbUQjGdwDK8CeFmcKoyj0HrUocPQprlaHMaJDslrcORf
 HLI9muj/mjC+oxk9C83TyYbDfVPHpeSTlmYKdvaIKB8C4=
Content-Transfer-Encoding: quoted-printable
X-Spam-Score: -0.7 (/)
X-Debbugs-Envelope-To: 70502
Cc: 70502 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.7 (-)

On Mon, 22 Apr 2024 08:31:39 +0300 Eli Zaretskii <eliz@HIDDEN> wrote:

>> Date: Sun, 21 Apr 2024 21:42:59 +0200
>> From:  Stephen Berman via "Bug reports for GNU Emacs,
>>  the Swiss army knife of text editors" <bug-gnu-emacs@HIDDEN>
>>
>> I've noticed a few typos, texinfo markup problems and omissions in two
>> nodes of the Widget manual.  The attached patch contains possible
>> corrections, which the rest of this post tries to justify.
>
> Everything you say is correct, and the patch is OK.  Thanks, feel free
> to install on the emacs-29 branch (assuming the same problems exist in
> this manual there as well).

Thanks, done as commit 2a533514929.  The only differences before that
between widget.texi in emacs-29 and master were the recent changes in
commit 91333dacfa1 on master (bug#70413).  Will those differences
prevent merging the new changes in emacs-29 to master?

Steve Berman




Information forwarded to bug-gnu-emacs@HIDDEN:
bug#70502; Package emacs. Full text available.

Message received at 70502 <at> debbugs.gnu.org:


Received: (at 70502) by debbugs.gnu.org; 22 Apr 2024 05:32:07 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Mon Apr 22 01:32:07 2024
Received: from localhost ([127.0.0.1]:45481 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1rymHd-00051L-U4
	for submit <at> debbugs.gnu.org; Mon, 22 Apr 2024 01:32:07 -0400
Received: from eggs.gnu.org ([2001:470:142:3::10]:55372)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <eliz@HIDDEN>) id 1rymHb-000504-Rp
 for 70502 <at> debbugs.gnu.org; Mon, 22 Apr 2024 01:32:05 -0400
Received: from fencepost.gnu.org ([2001:470:142:3::e])
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <eliz@HIDDEN>)
 id 1rymHG-0002FI-LD; Mon, 22 Apr 2024 01:31:42 -0400
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org;
 s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date:
 mime-version; bh=KGqeEv6vtyaLslJ+mAVAUIyEms/pXt61wbGe1oC2hus=; b=pUqYUkxZ1OYr
 qOis4c1LnzuLLjUJmwD25+h9w5zYD7e6Wa74hM7KJLy/x7aaBpTzEwX0GT1pnpH6iNP3NqAo5Nni9
 D+QqZTMlzwCKXg1B7gPaDXVpik6IiYnJlWgW98rk0nPKcLIm9+pNBEFt37OBUA5x2BhWyzahCQuY2
 xUYib1X4lRGoua0DDISsmNzkJsDBkfSs0jgWR3u9vMjm7hQ/6EyVqrFcKGPEjVCABPEZIkhN8lAqu
 cVOz+i6zZOojNpxSQwL3IwqL+pB791d14wlWedn+SNjFjn6QNMC2gaAGt78zDwYMEfj4EJLT6Wzm+
 EzbuayG3iryNw76wKn7owA==;
Date: Mon, 22 Apr 2024 08:31:39 +0300
Message-Id: <86il0a6k04.fsf@HIDDEN>
From: Eli Zaretskii <eliz@HIDDEN>
To: Stephen Berman <stephen.berman@HIDDEN>
In-Reply-To: <87zftmlcxo.fsf@HIDDEN> (bug-gnu-emacs@HIDDEN)
Subject: Re: bug#70502: 30.0.50; Widget manual typos etc.
References: <87zftmlcxo.fsf@HIDDEN>
X-Spam-Score: -2.3 (--)
X-Debbugs-Envelope-To: 70502
Cc: 70502 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -3.3 (---)

> Date: Sun, 21 Apr 2024 21:42:59 +0200
> From:  Stephen Berman via "Bug reports for GNU Emacs,
>  the Swiss army knife of text editors" <bug-gnu-emacs@HIDDEN>
> 
> I've noticed a few typos, texinfo markup problems and omissions in two
> nodes of the Widget manual.  The attached patch contains possible
> corrections, which the rest of this post tries to justify.

Everything you say is correct, and the patch is OK.  Thanks, feel free
to install on the emacs-29 branch (assuming the same problems exist in
this manual there as well).




Information forwarded to bug-gnu-emacs@HIDDEN:
bug#70502; Package emacs. Full text available.

Message received at submit <at> debbugs.gnu.org:


Received: (at submit) by debbugs.gnu.org; 21 Apr 2024 19:43:32 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Sun Apr 21 15:43:32 2024
Received: from localhost ([127.0.0.1]:44535 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1ryd64-0001j2-1P
	for submit <at> debbugs.gnu.org; Sun, 21 Apr 2024 15:43:32 -0400
Received: from lists.gnu.org ([2001:470:142::17]:33822)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <stephen.berman@HIDDEN>) id 1ryd5z-0001hV-8X
 for submit <at> debbugs.gnu.org; Sun, 21 Apr 2024 15:43:29 -0400
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 <stephen.berman@HIDDEN>)
 id 1ryd5e-0001Qo-Fp
 for bug-gnu-emacs@HIDDEN; Sun, 21 Apr 2024 15:43:06 -0400
Received: from mout.gmx.net ([212.227.15.18])
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <stephen.berman@HIDDEN>)
 id 1ryd5b-0005Ud-AD
 for bug-gnu-emacs@HIDDEN; Sun, 21 Apr 2024 15:43:06 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmx.net;
 s=s31663417; t=1713728579; x=1714333379; i=stephen.berman@HIDDEN;
 bh=jDSr+0t6BJvxezuQ5mrVM9GGuJ8BMHjbXLpfQELY51I=;
 h=X-UI-Sender-Class:From:To:Subject:Date:Message-ID:MIME-Version:
 Content-Type:cc:content-transfer-encoding:content-type:date:from:
 message-id:mime-version:reply-to:subject:to;
 b=ZQnttyFQK3FyZg8D2B7SpAiBef/L0Rqpth5tuqEE8XOBcFWXOyneqS+8S+gpkmFS
 E1OdgEDcmdnqLafaP52jyA9Dbpb9AqbSISddWRoFcsTJ50MqYhP9RWqdFaG8jFo0n
 /7d8gAzUjrbCFh9w5xuDKLiH7GO48Fd7oGUguV6fWB41ABfvzpHH+D8evyYcsRIBK
 Uk94mTVvzu4yJt7P/Qv3uGVfw8reGXoNBYe5JYFbCgj+ah7m7dCw8vor4jS7/ukkr
 DQtUN9T7+ukHzkmFinvzFOPeJ75Da2afvVwYd80Lr2wtYd8BOQlHZzh9lPF5hsmM/
 j9RXGVu3xz183+XJGQ==
X-UI-Sender-Class: 724b4f7f-cbec-4199-ad4e-598c01a50d3a
Received: from strobelfs ([94.134.94.36]) by mail.gmx.net (mrgmx005
 [212.227.17.190]) with ESMTPSA (Nemesis) id 1MfHAH-1seqro2jzn-00glDi for
 <bug-gnu-emacs@HIDDEN>; Sun, 21 Apr 2024 21:42:59 +0200
From: Stephen Berman <stephen.berman@HIDDEN>
To: bug-gnu-emacs@HIDDEN
Subject: 30.0.50; Widget manual typos etc.
X-Debbugs-Cc: 
Date: Sun, 21 Apr 2024 21:42:59 +0200
Message-ID: <87zftmlcxo.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13)
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="=-=-="
X-Provags-ID: V03:K1:eCkI1UVpQjuZQmMq310McaCrwulKlbTf5aLBn83fc5SoHwK4eyq
 jHH1zdPs2xjqm4yWG6RnQRGAZeB2Nya0YJ7Lds3MbFLfwLrqH3YJCyalMjd6ngEgqsUyRqI
 We/S46UIs3MzAk42/6pUeAj95w6fwkW/4jdd2+p0mHrNjVEdHX3Q7PtSa4J7872Biu7lZMf
 wGC92crm28MmPZZErylFw==
X-Spam-Flag: NO
UI-OutboundReport: notjunk:1;M01:P0:xl2szlc+c4k=;1v41d8B9xAYKjuGOkDOUFFgXI4O
 TYggzHDwn53ZfXsYMmvbmHQDsRiGHOi0UR0ww85c1Duuhx7O55CMFmtcZiU3iTCVioo7tVF4H
 151tvRuaIfUHWGeMoWhdaBxxpqVQRL1s2WSBiIuqYGsEMgOD/7Mu7teHUTlcy30BiAIEPaahm
 3T/krV7rKVhHLkusLmS84aw+dB5cQwq274GmU/wktLqCM6Pt9jwN+YpcS8foOBrXA/p4ca5us
 kcJSDtIxyIwQ0sLFqeDgZSDDoSqF0HjTdd0rubbLYMggtIQrqEwbf7Zq975WsBSuFJHW3/9hA
 TjVMZ7gHC1zGFRfTbRNZe4j4HYtLhoebSFdSo0J05cGxYGYTw3aOMlkxcAGVcMDO8oy5B3vAM
 o6rVzTm3Pj4OEKfJZsDukj8k9mZFO0ofHopzQj8iXlE7qyd5KQ2g4CPHvfBq9dy76yGOja2ve
 Zpm4xPRNIVPjCq2RCu1Ki7txghrWdWotcixTN1AHKkIXvttcexK9ZmjItyGkxJOaaUZ0c1Cl8
 IXcOQu/rkaJaQk/kARsS2QgRemRhbUCZED299FqdEgPcKuLSdAvxaCL6DAVMjNdRLwu9bWQpt
 T/y0AiJ3jfchVY9d5dWmTX18RuaVznf53mrTd9c+h6eK+f5bGVVxbyPNGIFji7TNO8kCOT0kG
 I3kQDueMR1dbBZwkEWDfRx2qz91AHHkQHSNOERiJfwncsdAcm7BTig/qr6dDuj5OQukGFYa+t
 S/WL9NhAxkn5XEz+8Z0xQUvs+bAUIRnNJOmF1wjBWu+JE3N65poU7E+SxOwXFI0isZyJqNxE2
 fbbXlf15OtmoNC4AsB2giLl92Id+jg76DMXGuZJvb5n7s=
Received-SPF: pass client-ip=212.227.15.18;
 envelope-from=stephen.berman@HIDDEN; helo=mout.gmx.net
X-Spam_score_int: -27
X-Spam_score: -2.8
X-Spam_bar: --
X-Spam_report: (-2.8 / 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_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001,
 SPF_PASS=-0.001 autolearn=ham autolearn_force=no
X-Spam_action: no action
X-Spam-Score: 0.0 (/)
X-Debbugs-Envelope-To: submit
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.0 (-)

--=-=-=
Content-Type: text/plain; charset=gb2312
Content-Transfer-Encoding: quoted-printable

I've noticed a few typos, texinfo markup problems and omissions in two
nodes of the Widget manual.  The attached patch contains possible
corrections, which the rest of this post tries to justify.

The node "Widgets and the Buffer" begins with this entry:

 -- Const: widget-keymap

In wid-edit.el widget-keymap is defined not with defconst but with
defvar, as are all the other widget keymaps except widget-global-map,
which is defined with defvar-local, and is listed right below
widget-keymap in this node as a Variable, not a Const.

The description of widget-keymap continues: "Binds <TAB> and =A1=AEC-<TAB>=
=A1=AF
to =A1=AEwidget-forward=A1=AF and =A1=AEwidget-backward=A1=AF, respectively=
."  =A1=AEC-<TAB>=A1=AF is
a typo, it should be either =A1=AES-<TAB>=A1=AF or =A1=AEM-<TAB>=A1=AF (or =
both; both of
these bindings are listed further down in this node, as are the other
bindings, so maybe they can be omitted here, though the patch keeps
them).

Further down is a table of bindings for editable-field widgets,
beginning with:

=A1=AE<C-e>=A1=AF
      -- Command: widget-end-of-line

Presumably this should be =A1=AEC-e=A1=AF like the following entry =A1=AEC-=
k=A1=AF.  The
angle brackets are due to the presumably incorrect texinfo markup in
widget.texi: @key{C-e} instead of @kbd{C-e} (or just C-e, since the
table starts with @table @kbd in widget.texi).

=A1=AEM-TAB=A1=AF
      -- Command: widget-complete

This should presumably be =A1=AEM-<TAB>=A1=AF like the same key binding in
widget-keymap (for the widget-backward command) mentioned above.  This
is again presumably a texinfo markup mistake in widget.texi: instead of
@kbd{M-TAB} it should be @kbd{M-@key{TAB}} (or just M-@key{TAB}).  In
addition, since the =A1=AEM-<TAB>=A1=AF key combination is commonly used in
desktop GUIs to switch focus among the desktop apps, it would be helpful
to mention the equivalent binding =A1=AEC-M-i=A1=AF.

The next entry is:

=A1=AEC-m=A1=AF
      -- Command: widget-field-activate
          Invoke the editable field at point.

Here it would be helpful to also list the equivalent binding =A1=AE<RET>=A1=
=AF.

The immediately following entry begins:

   The following two are commands that can execute widget actions.
=A1=AE<RET>=A1=AF
      -- Command: widget-button-press POS &optional EVENT

First, the introductory text should perhaps be more specific, since this
table is concerned with button widgets as opposed to editable-field
widgets.  Second, an empty line should separate from the table of key
bindings.  Third, as with the preceding binding for
widget-field-activate, it might be helpful to add the equivalent binding
=A1=AEC-m=A1=AF.

The node "Customization" begins by documenting three widget faces as
follows:

 -- Face: widget-field-face
     Face used for other editing fields.

 -- Face: widget-button-face
     Face used for buttons.

 -- User Option: widget-mouse-face
     Face used for highlighting a button when the mouse pointer moves
     across it.

     The default value is =A1=AEhighlight=A1=AF.

The first two mistakenly use the names of variables whose values are the
actual faces names defined with defface in widget.el: `widget-field' and
`widget-button', i.e. "-face" should be omitted.  In addition, in the
documentation of the widget-field face, "other" is a non-sequitur here,
since no other editing fields are mentioned.  In fact, wid-edit.el
defines the face `widget-single-line-field', which is presumably the
"other" type of field; however, that face is not currently used in
wid-edit.el (it's commented out in the definitions of the regexp and
file widgets with the remark: "Doesn't work well with terminating
newline.").

But wid-edit.el defines three other faces that are not documented in the
Widget manual: `widget-documentation', `widget-inactive' and
`widget-button-pressed'.  The patch adds documentation for these.

Finally, the user option `widget-mouse-face' is indeed defined in
wid-edit.el with defcustom; though it's not clear why it is not a
defface, the patch does not change this.


In GNU Emacs 30.0.50 (build 1, x86_64-pc-linux-gnu, GTK+ Version
 3.24.41, cairo version 1.18.0) of 2024-04-21 built on strobelfs
Repository revision: 4773ecb93193495f141e5d60c0c5ded58eaa2c98
Repository branch: master
Windowing system distributor 'The X.Org Foundation', version 11.0.12101013
System Description: Linux From Scratch r12.1-41

Configured using:
 'configure 'CFLAGS=3D-Og -g3' PKG_CONFIG_PATH=3D/opt/qt5/lib/pkgconfig'

Configured features:
ACL CAIRO DBUS FREETYPE GIF GLIB GMP GNUTLS GPM GSETTINGS HARFBUZZ JPEG
LCMS2 LIBSYSTEMD LIBXML2 MODULES NATIVE_COMP NOTIFY INOTIFY PDUMPER PNG
RSVG SECCOMP SOUND SQLITE3 THREADS TIFF TOOLKIT_SCROLL_BARS TREE_SITTER
WEBP X11 XDBE XIM XINPUT2 XPM GTK3 ZLIB


--=-=-=
Content-Type: text/x-patch
Content-Disposition: attachment
Content-Description: widget.texi patch
Content-Transfer-Encoding: quoted-printable

diff --git a/doc/misc/widget.texi b/doc/misc/widget.texi
index f74605c92c0..2e378e86fc7 100644
=2D-- a/doc/misc/widget.texi
+++ b/doc/misc/widget.texi
@@ -760,14 +760,14 @@ Widgets and the Buffer
 contain widgets.

 @cindex widget keybindings
-@defvr Const widget-keymap
+@defvar widget-keymap
 Keymap containing useful bindings for buffers containing widgets.

-Binds @key{TAB} and @kbd{C-@key{TAB}} to @code{widget-forward} and
-@code{widget-backward}, respectively.  It also binds @key{RET} to
-@code{widget-button-press} and @kbd{down-mouse-1} and
+Binds @key{TAB} to @code{widget-forward} and both @kbd{S-@key{TAB}} and
+@kbd{M-@key{TAB}} to @code{widget-backward}.  It also binds @key{RET} to
+@code{widget-button-press} and both @kbd{down-mouse-1} and
 @kbd{down-mouse-2} to @code{widget-button-click}.
-@end defvr
+@end defvar

 There's also a keymap for events that the Widget library doesn't need
 to handle.
@@ -788,8 +788,8 @@ Widgets and the Buffer
 @deffn Command widget-forward &optional count
 Move point @var{count} buttons or editing fields forward.
 @end deffn
-@item @kbd{M-@key{TAB}}
-@itemx @kbd{S-@key{TAB}}
+@item M-@key{TAB}
+@itemx S-@key{TAB}
 @deffn Command widget-backward &optional count
 Move point @var{count} buttons or editing fields backward.
 @end deffn
@@ -805,30 +805,35 @@ Widgets and the Buffer
 are available:

 @table @kbd
-@item @key{C-e}
+@item C-e
 @deffn Command widget-end-of-line
 Move point to the end of field or end of line, whichever is first.
 @end deffn

-@item @kbd{C-k}
+@item C-k
 @deffn Command widget-kill-line
 Kill to end of field or end of line, whichever is first.
 @end deffn

-@item @kbd{M-TAB}
+@item M-@key{TAB}
+@itemx C-M-i
 @deffn Command widget-complete
 Complete the content of the editable field at point.
 @end deffn

-@item @kbd{C-m}
+@item C-m
+@itemx @key{RET}
 @deffn Command widget-field-activate
 Invoke the editable field at point.
 @end deffn
 @end table

-The following two are commands that can execute widget actions.
+The following two commands can execute the action associated with a
+button widget (e.g., a radio button or checkbox):
+
 @table @kbd
 @item @key{RET}
+@itemx C-m
 @findex widget-button-press
 @deffn Command widget-button-press @var{pos} &optional @var{event}
 Invoke the button at @var{pos}, defaulting to point.
@@ -3262,14 +3267,26 @@ Customization
 This chapter is about the customization options for the Widget
 library, for the end user.

-@deffn Face widget-field-face
-Face used for other editing fields.
+@deffn Face widget-documentation
+Face used for documentation text.
+@end deffn
+
+@deffn Face widget-field
+Face used for editable fields.
 @end deffn

-@deffn Face widget-button-face
+@deffn Face widget-button
 Face used for buttons.
 @end deffn

+@deffn Face widget-button-pressed
+Face used for pressed buttons.
+@end deffn
+
+@deffn Face widget-inactive
+Face used for inactive widgets.
+@end deffn
+
 @defopt widget-mouse-face
 Face used for highlighting a button when the mouse pointer moves
 across it.

--=-=-=--




Acknowledgement sent to Stephen Berman <stephen.berman@HIDDEN>:
New bug report received and forwarded. Copy sent to bug-gnu-emacs@HIDDEN. Full text available.
Report forwarded to bug-gnu-emacs@HIDDEN:
bug#70502; Package emacs. Full text available.
Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.
Last modified: Mon, 22 Apr 2024 10:00:02 UTC

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997 nCipher Corporation Ltd, 1994-97 Ian Jackson.