* bug#55647: Emacs manual - Change references to "global-set-key" to "keymap-global-set"
@ 2022-05-25 23:16 dhanvanthri
2022-05-26 5:32 ` Eli Zaretskii
0 siblings, 1 reply; 5+ messages in thread
From: dhanvanthri @ 2022-05-25 23:16 UTC (permalink / raw)
To: 55647
Hey there,
The documentation for global-set-key mentions that it's been
deprecated in favour of keymap-global-set, however the manual still
contains references to global-set-key.
I was not able to find a way to make the changes and submit them,
and I'm sure there are more references to it than just inside the
rebinding keys documentation.
If someone could show me how, I will make the edits myself and
submit them, else I would really appreciate if someone could do so.
Regards,
-Dhanvanthri
^ permalink raw reply [flat|nested] 5+ messages in thread
* bug#55647: Emacs manual - Change references to "global-set-key" to "keymap-global-set"
2022-05-25 23:16 bug#55647: Emacs manual - Change references to "global-set-key" to "keymap-global-set" dhanvanthri
@ 2022-05-26 5:32 ` Eli Zaretskii
[not found] ` <328e75e7-49b0-ee5a-3432-eb4d81659377@gmail.com>
0 siblings, 1 reply; 5+ messages in thread
From: Eli Zaretskii @ 2022-05-26 5:32 UTC (permalink / raw)
To: dhanvanthri; +Cc: 55647
> Date: Wed, 25 May 2022 18:16:23 -0500
> From: dhanvanthri <dhan1thri@gmail.com>
>
> Hey there,
> The documentation for global-set-key mentions that it's been
> deprecated in favour of keymap-global-set, however the manual still
> contains references to global-set-key.
Thank you for your report.
I see only one reference to global-set-key, and that's to the command
global-set-key, in the ELisp reference manual. Do you see more
references?
> I was not able to find a way to make the changes and submit them,
> and I'm sure there are more references to it than just inside the
> rebinding keys documentation.
> If someone could show me how, I will make the edits myself and
> submit them, else I would really appreciate if someone could do so.
You should edit the corresponding *.texi files, and submit the
differences, preferably in the format of "git format-patch", or in the
format of "diff -u OLD NEW".
Thanks.
^ permalink raw reply [flat|nested] 5+ messages in thread
* bug#55647: Emacs manual - Change references to "global-set-key" to "keymap-global-set"
[not found] ` <328e75e7-49b0-ee5a-3432-eb4d81659377@gmail.com>
@ 2022-05-29 5:45 ` Eli Zaretskii
2022-06-07 22:35 ` Stefan Kangas
0 siblings, 1 reply; 5+ messages in thread
From: Eli Zaretskii @ 2022-05-29 5:45 UTC (permalink / raw)
To: Dhanvanthri N; +Cc: 55647
[Please use Reply All to keep the bug tracker on the CC list.]
> From: Dhanvanthri N <dhan1thri@gmail.com>
> Date: Sat, 28 May 2022 18:10:05 -0500
>
> I just switched back to stable, since native-comp is in 28; I notice
> that in 28, the documentation doesn't mention keymap-global-set, is this
> something that was introduced in 29?
Yes.
> I'm not sure how to find all the references to global-set-key in the
> documentation;
Grep the *.texi files in the doc/lispref/ and doc/emacs/ directories
of the Emacs source tree for the references to the obsolete functions
and commands.
> however if it's only in the documentation for
> global-set-key, should I still submit a patch?
No need for that one case, thanks.
^ permalink raw reply [flat|nested] 5+ messages in thread
* bug#55647: Emacs manual - Change references to "global-set-key" to "keymap-global-set"
2022-05-29 5:45 ` Eli Zaretskii
@ 2022-06-07 22:35 ` Stefan Kangas
2022-06-08 2:34 ` Eli Zaretskii
0 siblings, 1 reply; 5+ messages in thread
From: Stefan Kangas @ 2022-06-07 22:35 UTC (permalink / raw)
To: Eli Zaretskii; +Cc: Dhanvanthri N, 55647
Eli Zaretskii <eliz@gnu.org> writes:
>> I'm not sure how to find all the references to global-set-key in the
>> documentation;
>
> Grep the *.texi files in the doc/lispref/ and doc/emacs/ directories
> of the Emacs source tree for the references to the obsolete functions
> and commands.
I think there are quite a few of these.
However, I'm not sure that there is a strong need to change them for
Emacs 29 -- at least not in the user documentation. Users might be
consulting Emacs 29 documentation, yet still want to use their Init file
on Emacs 28 or older.
How about waiting with updating all of this documentation on master
until after Emacs 29 has been released?
^ permalink raw reply [flat|nested] 5+ messages in thread
* bug#55647: Emacs manual - Change references to "global-set-key" to "keymap-global-set"
2022-06-07 22:35 ` Stefan Kangas
@ 2022-06-08 2:34 ` Eli Zaretskii
0 siblings, 0 replies; 5+ messages in thread
From: Eli Zaretskii @ 2022-06-08 2:34 UTC (permalink / raw)
To: Stefan Kangas; +Cc: dhan1thri, 55647
> From: Stefan Kangas <stefan@marxist.se>
> Date: Tue, 7 Jun 2022 17:35:09 -0500
> Cc: Dhanvanthri N <dhan1thri@gmail.com>, 55647@debbugs.gnu.org
>
> Eli Zaretskii <eliz@gnu.org> writes:
>
> >> I'm not sure how to find all the references to global-set-key in the
> >> documentation;
> >
> > Grep the *.texi files in the doc/lispref/ and doc/emacs/ directories
> > of the Emacs source tree for the references to the obsolete functions
> > and commands.
>
> I think there are quite a few of these.
>
> However, I'm not sure that there is a strong need to change them for
> Emacs 29 -- at least not in the user documentation. Users might be
> consulting Emacs 29 documentation, yet still want to use their Init file
> on Emacs 28 or older.
>
> How about waiting with updating all of this documentation on master
> until after Emacs 29 has been released?
The question is actually whether we indeed consider global-set-key and
friends obsolete. If we do, we should at least document the modern
replacements and say that the obsolete ones are obsolete. Leaving the
documentation as-is without reference to obsolescence is not a good
idea, IMO.
^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2022-06-08 2:34 UTC | newest]
Thread overview: 5+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2022-05-25 23:16 bug#55647: Emacs manual - Change references to "global-set-key" to "keymap-global-set" dhanvanthri
2022-05-26 5:32 ` Eli Zaretskii
[not found] ` <328e75e7-49b0-ee5a-3432-eb4d81659377@gmail.com>
2022-05-29 5:45 ` Eli Zaretskii
2022-06-07 22:35 ` Stefan Kangas
2022-06-08 2:34 ` Eli Zaretskii
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.