Re: master 4d03f70b7f0 1/4: Correct doc strings for x-*-keysym

[Po Lu <luangruo@yahoo.com>]

Eli Zaretskii <eliz@gnu.org> writes:

>> Date: Sat, 16 Mar 2024 11:10:35 +0200
>> From: Eli Zaretskii <eliz@gnu.org>
>> Cc: emacs-devel@gnu.org
>> 
>> >    DEFVAR_LISP ("x-ctrl-keysym", Vx_ctrl_keysym,
>> > -    doc: /* Which keys Emacs uses for the ctrl modifier.
>> > -This should be one of the symbols `ctrl', `alt', `hyper', `meta',
>> > -`super'.  For example, `ctrl' means use the Ctrl_L and Ctrl_R keysyms.
>> > -The default is nil, which is the same as `ctrl'.  */);
>> > +    doc: /* Which modifer value Emacs reports when Ctrl is depressed.
>> > +This should be one of the symbols `ctrl', `alt', `hyper', `meta', or
>> > +`super', representing a modifier to be reported in key events with the
>> > +Ctrl modifier (i.e. the keysym Ctrl_L or Ctrl_R) depressed.  */);
>> >    Vx_ctrl_keysym = Qnil;
>> 
>> This loses the information about the meaning of the default value of
>> nil, doesn't it?  This leaves the user who looks at the default value
>> confused as to what that means.
>> 
>> Also, the "depressed" part at the end of the last sentence is not
>> right: a modifier reported in a key event cannot be "depressed", it
>> can only be "set".  Right?
>
> Ping!  I don't see the changes you promised in the current master
> branch.

Oh right, this slipped my mind.  Thanks for the reminder.