all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: Eli Zaretskii <eliz@gnu.org>
To: Alexandre Garreau <galex-713@galex-713.eu>
Cc: rms@gnu.org, theophilusx@gmail.com, emacs-devel@gnu.org,
	andremegafone@gmail.com, monnier@iro.umontreal.ca,
	john@yates-sheets.org
Subject: Re: Keybinding styles
Date: Thu, 16 Sep 2021 08:20:55 +0300	[thread overview]
Message-ID: <83mtod9juw.fsf@gnu.org> (raw)
In-Reply-To: <5069841.y6mJfzL4n5@galex-713.eu> (message from Alexandre Garreau on Wed, 15 Sep 2021 23:29:24 +0200)

> From: Alexandre Garreau <galex-713@galex-713.eu>
> Cc: André A. Gomes <andremegafone@gmail.com>, eliz@gnu.org, theophilusx@gmail.com, monnier@iro.umontreal.ca, john@yates-sheets.org
> Date: Wed, 15 Sep 2021 23:29:24 +0200
> 
> Don’t we already have a special markup in texinfo for keybindings? 

No, we don't.  (And it's not "we" who define the Texinfo markup, it's
the Texinfo language, which is not maintained and developed by the
Emacs project.)

What is needed here is to have the _command_ invoked by a key
sequence, rather than the key sequence itself, be mentioned in Texinfo
and propagated to Info with some markup there, so that info.el could
replace the command name by the actual key binding.  Something like
the \\[..] markup we have for doc strings.

> otherwise we ought to: we control texinfo (essentially used for emacs and 
> some other popular gnu stuff (since it’s used by gnu stuff)), and the main 
> implementation already is emacs.

That's not true.  First, the Texinfo language is not controlled by the
Emacs project, it's developed and maintained by a sibling GNU
project.  And second, there are actively developed Info readers that
are not in Emacs: the trivial example is the stand-alone reader that
is part of the Texinfo project.

We cannot make unilateral changes in this area.

> We could add some markup to contextualize the origin of keybindings (for 
> instance what mode/software the current section is talking about)

I don't think I understand the details of this proposal, but in any
case, many sections in the manual do not talk about a single major
mode.



  reply	other threads:[~2021-09-16  5:20 UTC|newest]

Thread overview: 47+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2021-09-03 18:00 [External] : Re: Gitlab Migration Drew Adams
2021-09-03 20:06 ` Stefan Kangas
2021-09-03 22:49 ` Stefan Monnier
2021-09-04  2:00   ` Tim Cross
2021-09-04 13:26     ` Keybinding styles (was: [External] : Re: Gitlab Migration) Stefan Monnier
2021-09-04 13:39       ` Dmitry Gutov
2021-09-04 14:25         ` Keybinding styles Stefan Monnier
2021-09-04 15:44       ` Keybinding styles (was: [External] : Re: Gitlab Migration) Yuan Fu
2021-09-04 15:50         ` Eli Zaretskii
2021-09-04 15:55           ` Drew Adams
2021-09-04 16:07           ` Yuan Fu
2021-09-04 16:19             ` Eli Zaretskii
2021-09-06  3:07             ` Richard Stallman
2021-09-06 11:28               ` Dmitry Gutov
2021-09-04 19:55           ` Keybinding styles Daniel Fleischer
2021-09-04 20:52             ` Stefan Kangas
2021-09-05  7:17               ` tomas
2021-09-04 16:09         ` Bird
2021-09-04 20:48         ` Keybinding styles (was: [External] : Re: Gitlab Migration) Tim Cross
2021-09-05 19:03       ` John Yates
2021-09-06  4:34         ` Eli Zaretskii
2021-09-07  3:16         ` Richard Stallman
2021-09-07 12:02           ` John Yates
2021-09-08  3:29             ` Richard Stallman
2021-09-08 12:15               ` Keybinding styles André A. Gomes
2021-09-08 13:18                 ` Eli Zaretskii
2021-09-08 20:37                 ` John Yates
2021-09-09  5:39                   ` Eli Zaretskii
2021-09-15 13:40                     ` André A. Gomes
2021-09-15 14:26                       ` Stefan Kangas
2021-09-15 15:36                       ` Eli Zaretskii
2021-09-15 20:15                       ` Richard Stallman
2021-09-15 21:29                         ` Alexandre Garreau
2021-09-16  5:20                           ` Eli Zaretskii [this message]
2021-09-16  5:00                         ` Eli Zaretskii
2021-09-09  3:09                 ` Richard Stallman
2021-09-04 16:05     ` [External] : Re: Gitlab Migration Stefan Kangas
2021-09-04  2:20   ` Drew Adams
2021-09-04 13:14     ` Stefan Monnier
2021-09-04 14:58       ` Drew Adams
2021-09-04 16:10         ` Stefan Monnier
2021-09-04 16:40           ` Drew Adams
2021-09-05 19:27   ` John Yates
2021-09-07  3:16     ` Richard Stallman
2021-09-07 15:31       ` Barry Fishman
2021-09-09  3:07         ` Richard Stallman
2021-09-09 14:07           ` André A. Gomes

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=83mtod9juw.fsf@gnu.org \
    --to=eliz@gnu.org \
    --cc=andremegafone@gmail.com \
    --cc=emacs-devel@gnu.org \
    --cc=galex-713@galex-713.eu \
    --cc=john@yates-sheets.org \
    --cc=monnier@iro.umontreal.ca \
    --cc=rms@gnu.org \
    --cc=theophilusx@gmail.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
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.