Meaning of arg in preedit-text events on pgtk

Meaning of arg in preedit-text events on pgtk

[Po Lu]

I documented the `preedit-text' event (which is now used by both the
PGTK port and the X port), but I don't know the meaning of `arg' under
PGTK.

Yuuki, could you please write that part of the documentation?  It's
under the node "Misc Events" in doc/lispref/commands.texi.  Thanks.

Also, does this event need a NEWS entry?  It was originally specific to
the PGTK port, but after implementing the preedit text feature on X, it
might need a NEWS entry now.

Thanks.

Re: Meaning of arg in preedit-text events on pgtk

[Robert Pluim]

>>>>> On Fri, 07 Jan 2022 14:46:09 +0800, Po Lu <luangruo@yahoo.com> said:

    Po> Also, does this event need a NEWS entry?  It was originally specific to
    Po> the PGTK port, but after implementing the preedit text feature on X, it
    Po> might need a NEWS entry now.

I would be good if its effect were documented in NEWS, since it causes
new things to be displayed to the user.

Robert
-- 

Re: Meaning of arg in preedit-text events on pgtk

[Po Lu]

Robert Pluim <rpluim@gmail.com> writes:

>>>>>> On Fri, 07 Jan 2022 14:46:09 +0800, Po Lu <luangruo@yahoo.com> said:
>
>     Po> Also, does this event need a NEWS entry?  It was originally specific to
>     Po> the PGTK port, but after implementing the preedit text feature on X, it
>     Po> might need a NEWS entry now.
>
> I would be good if its effect were documented in NEWS, since it causes
> new things to be displayed to the user.
>
> Robert

Thanks.  Since it's now off by default, I think the entry for the
`inputStyle' resource will suffice.

Re: Meaning of arg in preedit-text events on pgtk

[Robert Pluim]

>>>>> On Fri, 07 Jan 2022 17:28:19 +0800, Po Lu <luangruo@yahoo.com> said:

    Po> Robert Pluim <rpluim@gmail.com> writes:
    >>>>>>> On Fri, 07 Jan 2022 14:46:09 +0800, Po Lu <luangruo@yahoo.com> said:
    >> 
    Po> Also, does this event need a NEWS entry?  It was originally specific to
    Po> the PGTK port, but after implementing the preedit text feature on X, it
    Po> might need a NEWS entry now.
    >> 
    >> I would be good if its effect were documented in NEWS, since it causes
    >> new things to be displayed to the user.
    >> 
    >> Robert

    Po> Thanks.  Since it's now off by default, I think the entry for the
    Po> `inputStyle' resource will suffice.

Yes, although itʼs not clear from the text in xresources.texi what
'offthespot' and 'root' actually do. I suspect the first means "use
the echo area", but what about the other one? Or is it "we donʼt know,
the input method has free rein"?

Robert
-- 

Re: Meaning of arg in preedit-text events on pgtk

[Po Lu]

Robert Pluim <rpluim@gmail.com> writes:

> Yes, although itʼs not clear from the text in xresources.texi what
> 'offthespot' and 'root' actually do. I suspect the first means "use
> the echo area", but what about the other one? Or is it "we donʼt know,
> the input method has free rein"?

With "offthespot", Emacs tells the input method to display itself on the
bottom right corner of the frame.  The XIM documentation calls this
"displaying the pre-edit information in an area provided by the client".

With "root", the input method has free rein, but each input method
should display itself in a unique spot of the display (i.e. one not
taken up by another input method).

Re: Meaning of arg in preedit-text events on pgtk

[Yuuki Harano]

On Fri, 07 Jan 2022 14:46:09 +0800,
	Po Lu <luangruo@yahoo.com> wrote:
> I documented the `preedit-text' event (which is now used by both the
> PGTK port and the X port), but I don't know the meaning of `arg' under
> PGTK.
> 
> Yuuki, could you please write that part of the documentation?  It's
> under the node "Misc Events" in doc/lispref/commands.texi.  Thanks.

I did.

-- 
Yuuki Harano

Re: Meaning of arg in preedit-text events on pgtk

[Po Lu]

Yuuki Harano <masm+emacs@masm11.me> writes:

> I did.

Thanks!