From debbugs-submit-bounces@debbugs.gnu.org Fri Apr 18 00:50:49 2025 Received: (at submit) by debbugs.gnu.org; 18 Apr 2025 04:50:49 +0000 Received: from localhost ([127.0.0.1]:49227 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1u5dgc-0005Vt-Pw for submit@debbugs.gnu.org; Fri, 18 Apr 2025 00:50:48 -0400 Received: from lists.gnu.org ([2001:470:142::17]:52528) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1u5aht-0007Lu-4W for submit@debbugs.gnu.org; Thu, 17 Apr 2025 21:39:56 -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 ) id 1u5ahm-0005PP-7E for bug-gnu-emacs@gnu.org; Thu, 17 Apr 2025 21:39:46 -0400 Received: from mail-pg1-x52f.google.com ([2607:f8b0:4864:20::52f]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1u5ahk-0005YM-Am for bug-gnu-emacs@gnu.org; Thu, 17 Apr 2025 21:39:45 -0400 Received: by mail-pg1-x52f.google.com with SMTP id 41be03b00d2f7-b0b2d0b2843so1110222a12.2 for ; Thu, 17 Apr 2025 18:39:43 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=allthingslinux-org.20230601.gappssmtp.com; s=20230601; t=1744940382; x=1745545182; darn=gnu.org; h=to:subject:message-id:date:from:mime-version:from:to:cc:subject :date:message-id:reply-to; bh=F+8m5TgDSpkDETIplsw1WUidUvJd2zToMsZ2yDtwZd8=; b=k85Y06MtmfFHVHvazucqESUAZT+vJ2NtM84zSXexHE/C0XjYWJ15HV3qjVhoTrrGss 8nhI7X7lynvWKFb4BAP7oQZeK0Em64UaAUTaH11gNuPWJw27xE1wXW8qzvkLzK6/2SVp MkEQ6ZT2wT2rw40odc3aOXZ/Y/S5chDXu7dF8QmW3xrzdxI4WFIKltutOB3eQbNPC590 L5vUMdeTH7LzBP8dWYarpl1dVS95vLPTau58L7dOuInExHfwbytJDDO93/126E1f7WCm CKI20zBWehUs9OtLwdSoBeANVdw4cPsqi7hFLaNa1dD1+cmEsKdtxn5ysK8ewR20Y5H1 T4bg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1744940382; x=1745545182; h=to:subject:message-id:date:from:mime-version:x-gm-message-state :from:to:cc:subject:date:message-id:reply-to; bh=F+8m5TgDSpkDETIplsw1WUidUvJd2zToMsZ2yDtwZd8=; b=A2bjPftfx6Caze+UU8Qerisr9vWOQTdb1ukawR14d4CnoT2cguJIcfJg/ePg1rmUUO oU0dwKvBOYQ2bRJqEoc81L7HflWv8HZx1f3sB1RGtnUBEiVp8ULcJ6GWuKj7ZNImRwwe axYJ56feh24b7qHiMeGaicIx1CdS5bFueAvDVlI1KhSEu0VtvjHZzVcfYlaO3plFjcYn 0lCugwZSQvhUNLIyiAJDrps3k2CI02Rh/sGeFw+XvCQSe60E4Jv629XK9QmvlmgcrTWC ejwj5cXXauvizpdf5GVCuEJfi1+9WPIah2IzoQZiro3sjQQLgCvaVqJR2Dvvx9ZLYoWB B6ew== X-Gm-Message-State: AOJu0YzylW7Sk3p+SskHRW5FySOUisuqM7xe7v/qHkBSGNMyeHRzm8Rs 9SFTyf81l3Btiw0zmcz30OAxvy5ekvhy72tQmAKZE7PYG18kyPfNBtzKWPH0KxdJ02PjDNFKKpD CPoB0E0xo3e95EHqlOTmBhYDo7xoGev8Bpiv3xYERxUCwG/PR6j0= X-Gm-Gg: ASbGncu36YNhCVa77EtgUT1xJS/EvDSHDXnpr4Pu21dYRpPx3knczeZXn3Ym4q5ELoQ 6pspyWGHtPjm8fEaufUBvbpijWDSOsKsWFSxlU9rkZ+86HZfzxIuDY47sNIEbuKfo0L5bwrxhyn SwIevmI21sG/n5IlD77oVW8xDGdeZAAXWk9mPuNXY5kWW5zHX2+O8Zns0Y+U3ZgBBk X-Google-Smtp-Source: AGHT+IEZAAQuoELsEU+dlwxHmmzsuXmjR24N/HECXKSxEaipPIgXC45btZDuBYlgcEFfaJdNMUIIBixFbYu0xsM+fDA= X-Received: by 2002:a17:90b:5690:b0:2f9:c139:b61f with SMTP id 98e67ed59e1d1-3087bb48e25mr1687777a91.14.1744940381686; Thu, 17 Apr 2025 18:39:41 -0700 (PDT) MIME-Version: 1.0 From: =?UTF-8?B?TGFjdG9zZSDigI4=?= Date: Thu, 17 Apr 2025 18:39:30 -0700 X-Gm-Features: ATxdqUHHJ171GDscHFzhZ8dZWlAqVmY4CxqmuKjMFmdKPHXl07xKGGMGW14MRWY Message-ID: Subject: [PATCH] Clarify insert-char when called from Lisp To: bug-gnu-emacs@gnu.org Content-Type: multipart/mixed; boundary="0000000000009bbe9d06330397f5" Received-SPF: none client-ip=2607:f8b0:4864:20::52f; envelope-from=lactose@allthingslinux.org; helo=mail-pg1-x52f.google.com X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_NONE=0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: submit X-Mailman-Approved-At: Fri, 18 Apr 2025 00:50:28 -0400 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) --0000000000009bbe9d06330397f5 Content-Type: text/plain; charset="UTF-8" The doc for `insert-char' is unclear what values are valid for CHARACTER when called from Lisp. This clarifies that only code points can be passed when called from Lisp instead of interactively. > Interactively, prompt for CHARACTER using `read-char-by-name'. > You can specify CHARACTER in one of these ways: This reads to me as two separate, unrelated statements. Somemone could interpret the latter as applying when called from Lisp, when in fact it's only true when called interactively. > Interactively, prompt for CHARACTER using `read-char-by-name'. > When prompted, you can specify CHARACTER in one of these ways: This is much better as it is now clear it only applies when called interactively. In addition, I added details on how to call `insert-char' from Lisp. > When called from Lisp, you can only pass CHARACTER as a code point. > See `char-from-name' for retrieving a code point from a Unicode character name. --0000000000009bbe9d06330397f5 Content-Type: text/x-patch; charset="US-ASCII"; name="insert-char-doc.patch" Content-Disposition: attachment; filename="insert-char-doc.patch" Content-Transfer-Encoding: base64 Content-ID: X-Attachment-Id: f_m9m4ftle0 ZGlmZiAtLWdpdCBhL3NyYy9lZGl0Zm5zLmMgYi9zcmMvZWRpdGZucy5jCmluZGV4IGE5MzhkMDku LjQxOTI3YjUgMTAwNjQ0Ci0tLSBhL3NyYy9lZGl0Zm5zLmMKKysrIGIvc3JjL2VkaXRmbnMuYwpA QCAtMTQ0MSw3ICsxNDQxLDcgQEAgREVGVU4gKCJpbnNlcnQtY2hhciIsIEZpbnNlcnRfY2hhciwg U2luc2VydF9jaGFyLCAxLCAzLAogICAgICAgICAgICAgICB0KSkiLAogICAgICAgIGRvYzogLyog SW5zZXJ0IENPVU5UIGNvcGllcyBvZiBDSEFSQUNURVIuCiBJbnRlcmFjdGl2ZWx5LCBwcm9tcHQg Zm9yIENIQVJBQ1RFUiB1c2luZyBgcmVhZC1jaGFyLWJ5LW5hbWUnLgotWW91IGNhbiBzcGVjaWZ5 IENIQVJBQ1RFUiBpbiBvbmUgb2YgdGhlc2Ugd2F5czoKK1doZW4gcHJvbXRlZCwgeW91IGNhbiBz cGVjaWZ5IENIQVJBQ1RFUiBpbiBvbmUgb2YgdGhlc2Ugd2F5czoKIAogIC0gQXMgaXRzIFVuaWNv ZGUgY2hhcmFjdGVyIG5hbWUsIGUuZy4gXCJMQVRJTiBTTUFMTCBMRVRURVIgQVwiLgogICAgQ29t cGxldGlvbiBpcyBhdmFpbGFibGU7IGlmIHlvdSB0eXBlIGEgc3Vic3RyaW5nIG9mIHRoZSBuYW1l CkBAIC0xNDU1LDYgKzE0NTUsOSBAQCBZb3UgY2FuIHNwZWNpZnkgQ0hBUkFDVEVSIGluIG9uZSBv ZiB0aGVzZSB3YXlzOgogIC0gQXMgYSBjb2RlIHBvaW50IHdpdGggYSByYWRpeCBzcGVjaWZpZWQg d2l0aCAjLCBlLmcuICNvMjE0MzAKICAgIChvY3RhbCksICN4MjMxOCAoaGV4KSwgb3IgIzEwcjg5 ODQgKGRlY2ltYWwpLgogCitXaGVuIGNhbGxlZCBmcm9tIExpc3AsIHlvdSBjYW4gb25seSBwYXNz IENIQVJBQ1RFUiBhcyBhIGNvZGUgcG9pbnQuCitTZWUgYGNoYXItZnJvbS1uYW1lJyBmb3IgcmV0 cmlldmluZyBhIGNvZGUgcG9pbnQgZnJvbSBhIFVuaWNvZGUgY2hhcmFjdGVyIG5hbWUuCisKIElm IGNhbGxlZCBpbnRlcmFjdGl2ZWx5LCBDT1VOVCBpcyBnaXZlbiBieSB0aGUgcHJlZml4IGFyZ3Vt ZW50LiAgSWYKIG9taXR0ZWQgb3IgbmlsLCBpdCBkZWZhdWx0cyB0byAxLgogCg== --0000000000009bbe9d06330397f5-- From debbugs-submit-bounces@debbugs.gnu.org Fri Apr 18 07:12:36 2025 Received: (at 77889-done) by debbugs.gnu.org; 18 Apr 2025 11:12:37 +0000 Received: from localhost ([127.0.0.1]:50082 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1u5je8-0007vU-3B for submit@debbugs.gnu.org; Fri, 18 Apr 2025 07:12:36 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:59040) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1u5je3-0007to-Bb for 77889-done@debbugs.gnu.org; Fri, 18 Apr 2025 07:12:33 -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 ) id 1u5jdw-0002N5-Mn; Fri, 18 Apr 2025 07:12:24 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-version:References:Subject:In-Reply-To:To:From: Date; bh=LmB8C0jWiWtg0p/gtzNbcdCWfiQPa8yXtVvM/zlrmic=; b=QZO94q327ZeU5adwD+qb RKESPFnyA3sp8hiclnOOnPN/m6W7GnTOowSK0FNjpTSYwkLTNN575hmKfNxJpxUKm8DzilJ0i9EE6 /jcOptRN6s06NVkb0jOHcDRdeTtdGtTa4kB9G8YNSg0WnAvdewG7KT+BtQlp0HXG6vFwdvdHgIFMq tSit+BNNoO09KmNeRkEeO0MFv7ubK0sU6mxW7Ca3/+wSe2wFHYQIa5+w1kO6z1DZQSiyusD64Aj/7 fmIlda1lcxfw7ffAPPHR+IQpVqJAjXhHqff5LvolDcq5YBLqbTYSoUCJUn/c42TgPfAxbfuzCaPQ1 kU9jfr4iJaXZNA==; Date: Fri, 18 Apr 2025 14:11:58 +0300 Message-Id: <86ikn1bu69.fsf@gnu.org> From: Eli Zaretskii To: Lactose =?utf-8?Q?=E2=80=8E?= In-Reply-To: (message from Lactose =?utf-8?Q?=E2=80=8E?= on Thu, 17 Apr 2025 18:39:30 -0700) Subject: Re: bug#77889: [PATCH] Clarify insert-char when called from Lisp References: MIME-version: 1.0 Content-type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 77889-done Cc: 77889-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > From: Lactose ‎ > Date: Thu, 17 Apr 2025 18:39:30 -0700 > > The doc for `insert-char' is unclear what values are valid for CHARACTER > when called from Lisp. This clarifies that only code points can be > passed when called from Lisp instead of interactively. > > > Interactively, prompt for CHARACTER using `read-char-by-name'. > > You can specify CHARACTER in one of these ways: > > This reads to me as two separate, unrelated statements. Somemone could > interpret the latter as applying when called from Lisp, when in fact it's > only true when called interactively. > > > Interactively, prompt for CHARACTER using `read-char-by-name'. > > When prompted, you can specify CHARACTER in one of these ways: > > This is much better as it is now clear it only applies when > called interactively. > > In addition, I added details on how to call `insert-char' from Lisp. > > > When called from Lisp, you can only pass CHARACTER as a code point. > > See `char-from-name' for retrieving a code point from a Unicode character name. Thanks, I used these ideas and suggestions to fix the doc string in a slightly different way. Done on the emacs-30 branch, and closing the bug. From unknown Wed Jun 18 23:11:19 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Fri, 16 May 2025 11:24:12 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator