From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Robert Pluim Newsgroups: gmane.emacs.devel Subject: Re: master f041d61008 2/3: Improve documentation of the preedit-text event Date: Fri, 07 Jan 2022 10:49:44 +0100 Message-ID: <87a6g77u4n.fsf@gmail.com> References: <164154759534.24569.1062687039370550695@vcs2.savannah.gnu.org> <20220107092636.08509C0DA1D@vcs2.savannah.gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="25163"; mail-complaints-to="usenet@ciao.gmane.io" Cc: Po Lu To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Fri Jan 07 10:51:27 2022 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 1n5luB-0006QO-Gt for ged-emacs-devel@m.gmane-mx.org; Fri, 07 Jan 2022 10:51:27 +0100 Original-Received: from localhost ([::1]:58842 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1n5luA-00052X-LW for ged-emacs-devel@m.gmane-mx.org; Fri, 07 Jan 2022 04:51:26 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:57604) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n5lsb-0003pi-MD for emacs-devel@gnu.org; Fri, 07 Jan 2022 04:49:49 -0500 Original-Received: from [2a00:1450:4864:20::42e] (port=46688 helo=mail-wr1-x42e.google.com) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1n5lsZ-0003Lj-6Z for emacs-devel@gnu.org; Fri, 07 Jan 2022 04:49:49 -0500 Original-Received: by mail-wr1-x42e.google.com with SMTP id i22so9946470wrb.13 for ; Fri, 07 Jan 2022 01:49:46 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=from:to:cc:subject:references:gmane-reply-to-list:date:in-reply-to :message-id:mime-version:content-transfer-encoding; bh=8uzYlpfuVPrnsJw2vS6jw8sTk5keJwloOg23KvDFDWg=; b=c0VztbLa7XP5tosAyebu6KivbTEMg1EXzW+t+4tYrA2uKtqdOehwjXuQffBUhpE0bi RbeVNuOBqAIqLsygYH1QA9hlyc1G/JaOit9AymOvX8scDTLQ7Gbj6AlXQIIsbhqD4EbJ JGbQhrZ09gvRIpL/vjo8OZ/dg4bJtSwjlbYbAFgw9EQ5zhNeRB6gifEHkUiyWviKcO8T /Ixir/tsRQdtTswbGgULQVETwI+G+hx3rPQHEWzbgnWbPh9f2a2gXs9aRG06A4iasjuO 8ty4FLjIX7zkZ3Hqj7pF4B+Nwzn18wdc6nDfgf0T6DvTxyu87sWJ614t6HVkkV90uZTD jxjw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:references :gmane-reply-to-list:date:in-reply-to:message-id:mime-version :content-transfer-encoding; bh=8uzYlpfuVPrnsJw2vS6jw8sTk5keJwloOg23KvDFDWg=; b=sbIFiLvFOYEApFYkcx6xSVnXolTWIrpgsLW8EbUdZVd9QMOHcaXGVWDLwIILIQ3aB6 Op3Mk4viiaf9vqdEdPRqeAAt2lxqoitFDB8TrXjdQseSTHodmxUvcv1//X4ek/t8GsFY hIkClb4da+0OcqAnQStWDEsKJJ9PhnZ6L+0yhD/ec71LFzDzjQmLv8fpxbU4msXgitRm NOLLZ8p2ZlwrwawaFHLvRIjO65foSRcgk+pkaM1gJATdGOuhyxc0DTAifbYrjwdNR5oI Dq6fmzfVCqM2ERLH+KpQkKc/Enm4E7DZnXhykHOXeCFRBpHmkpq5WWXzDQ1l69FeKMVY CR6g== X-Gm-Message-State: AOAM530QDFhC6S2wPq760rjazsv9iREIoEZz2obPLezqlR1vZeg/CN1w s3WdAGVcIvbthbdTPKBt9s0= X-Google-Smtp-Source: ABdhPJwoGxF0nPdoEKInfdhbhiiS69ywDZnh4357DEegXXLwmhBrsG6lXpMzOSVEIVKIFwbEnrOS4g== X-Received: by 2002:a05:6000:1869:: with SMTP id d9mr52975075wri.231.1641548985733; Fri, 07 Jan 2022 01:49:45 -0800 (PST) Original-Received: from rltb ([2a01:e0a:3f3:fb50:24e:3978:3b03:ee76]) by smtp.gmail.com with ESMTPSA id y8sm5574862wma.19.2022.01.07.01.49.45 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 07 Jan 2022 01:49:45 -0800 (PST) Gmane-Reply-To-List: yes In-Reply-To: <20220107092636.08509C0DA1D@vcs2.savannah.gnu.org> (Po Lu via Mailing list for Emacs changes's message of "Fri, 7 Jan 2022 04:26:35 -0500 (EST)") X-Host-Lookup-Failed: Reverse DNS lookup failed for 2a00:1450:4864:20::42e (failed) Received-SPF: pass client-ip=2a00:1450:4864:20::42e; envelope-from=rpluim@gmail.com; helo=mail-wr1-x42e.google.com X-Spam_score_int: -12 X-Spam_score: -1.3 X-Spam_bar: - X-Spam_report: (-1.3 / 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_NONE=-0.0001, RDNS_NONE=0.793, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=no 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" Xref: news.gmane.io gmane.emacs.devel:284396 Archived-At: >>>>> On Fri, 7 Jan 2022 04:26:35 -0500 (EST), Po Lu via Mailing list for = Emacs changes said: Po> branch: master Po> commit f041d610083ca0815ab18c589f115bacc523b9bb Po> Author: Po Lu Po> Commit: Po Lu Po> Improve documentation of the preedit-text event =20=20=20=20 Po> * doc/lispref/commands.texi (Misc Events): Document how Po> `preedit-text' events are used. Po> --- Po> doc/lispref/commands.texi | 4 +++- Po> 1 file changed, 3 insertions(+), 1 deletion(-) Po> diff --git a/doc/lispref/commands.texi b/doc/lispref/commands.texi Po> index eb364d2f49..062b8ea911 100644 Po> --- a/doc/lispref/commands.texi Po> +++ b/doc/lispref/commands.texi Po> @@ -2140,7 +2140,9 @@ cursor. It can be @code{nil}, which means to= remove any text Po> previously displayed. @c FIXME: what is the value of ARG on PGTK? =20 Po> This is a special event (@pxref{Special Events}), which normally Po> -should not be bound by the user to any command. Po> +should not be bound by the user to any command. Emacs will typica= lly Po> +the text contained in the event behind the cursor on-screen when i= t is Po> +received. I think you=CA=BCre missing a verb. And what does "behind the cursor on-screen" mean? An overlay? (plus I thought this was disabled by default now?) Robert --=20