From: Eli Zaretskii <eliz@gnu.org>
To: Drew Adams <drew.adams@oracle.com>
Cc: 30530@debbugs.gnu.org, mail@nicolasgoaziou.fr
Subject: bug#30530: 26.0; Emacs manual: mention (1) user-reserved keys, (2) users can bind any keys
Date: Fri, 02 Mar 2018 17:49:03 +0200 [thread overview]
Message-ID: <83606ewk9c.fsf@gnu.org> (raw)
In-Reply-To: <c6ddbec3-e423-496e-a77c-93c185f34110@default> (message from Drew Adams on Fri, 2 Mar 2018 07:17:14 -0800 (PST))
> Date: Fri, 2 Mar 2018 07:17:14 -0800 (PST)
> From: Drew Adams <drew.adams@oracle.com>
> Cc: mail@nicolasgoaziou.fr, 30530@debbugs.gnu.org
>
> It is fine for the Emacs and Elisp manuals to point out that users
> can bind these keys and that the keys are reserved for them.
> [...]
> That's not the same thing as the doc of a library that
> most Emacs users use, and that is often the gateway to
> starting to use Emacs, telling users that they should
> bind these keys _for that library_, for best results.
There's no difference here that I can see. Library docs are written
by the same people who answer questions in stackoverflow and write
blogs, and draw from the same knowledge and experience. Suggestions
for convenient key bindings in a manual that describes a library is no
different from a suggestion in a blog about such bindings. Making
them different, let alone to a degree that requires denigrating one of
them, is more than splitting hair.
> Either the keys are reserved for users or they are
> not. IMHO, the _single_ message about these keys
> from Emacs to users (especially new users) should
> be the message that these keys are reserved for
> their use. End of story.
Saying that they are reserved and suggesting to bind them in some
situation are two different ways of saying the same thing.
next prev parent reply other threads:[~2018-03-02 15:49 UTC|newest]
Thread overview: 14+ messages / expand[flat|nested] mbox.gz Atom feed top
[not found] <<f630bd00-a129-48ec-8788-2ed09964b598@default>
[not found] ` <<83lgfi4qw2.fsf@gnu.org>
2018-02-24 17:00 ` bug#30530: 26.0; Emacs manual: mention (1) user-reserved keys, (2) users can bind any keys Drew Adams
2018-02-24 17:44 ` Eli Zaretskii
2018-02-24 21:27 ` Nicolas Goaziou
2018-03-01 15:44 ` Eli Zaretskii
[not found] ` <<87zi3y13jf.fsf@nicolasgoaziou.fr>
[not found] ` <<83d10nyf4y.fsf@gnu.org>
2018-03-01 17:31 ` Drew Adams
2018-03-01 19:22 ` Eli Zaretskii
2018-03-01 19:30 ` Noam Postavsky
[not found] ` <<<87zi3y13jf.fsf@nicolasgoaziou.fr>
[not found] ` <<<83d10nyf4y.fsf@gnu.org>
[not found] ` <<92c8fd97-8e96-4e2b-8706-f5ca97869912@default>
[not found] ` <<831sh3y51x.fsf@gnu.org>
2018-03-01 21:00 ` Drew Adams
2018-03-01 21:33 ` Noam Postavsky
2018-03-02 5:32 ` Eli Zaretskii
[not found] ` <<<<87zi3y13jf.fsf@nicolasgoaziou.fr>
[not found] ` <<<<83d10nyf4y.fsf@gnu.org>
[not found] ` <<<92c8fd97-8e96-4e2b-8706-f5ca97869912@default>
[not found] ` <<<831sh3y51x.fsf@gnu.org>
[not found] ` <<eea83f2b-2dea-49c6-941d-5db34a741a5d@default>
[not found] ` <<83woyvvy8g.fsf@gnu.org>
2018-03-02 15:17 ` Drew Adams
2018-03-02 15:49 ` Eli Zaretskii [this message]
2018-02-19 16:16 Drew Adams
2018-02-24 10:35 ` Eli Zaretskii
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=83606ewk9c.fsf@gnu.org \
--to=eliz@gnu.org \
--cc=30530@debbugs.gnu.org \
--cc=drew.adams@oracle.com \
--cc=mail@nicolasgoaziou.fr \
/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.