emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: Nicolas Goaziou <mail@nicolasgoaziou.fr>
To: Drew Adams <drew.adams@oracle.com>
Cc: Allen Li <vianchielfaura@gmail.com>, 28263@debbugs.gnu.org
Subject: bug#28263:  bug#28263: 24.5; Org: `C-c LETTER' keys
Date: Mon, 19 Feb 2018 10:24:18 +0100	[thread overview]
Message-ID: <87fu5xl4cd.fsf@nicolasgoaziou.fr> (raw)
In-Reply-To: <cd8c169f-5c97-449b-829d-abfd091345db@default> (Drew Adams's message of "Sun, 18 Feb 2018 16:26:45 -0800 (PST)")

Hello,

Drew Adams <drew.adams@oracle.com> writes:

> It's my opinion of what Org mode _should_ do.

That's what I meant.

> And it coincides with what other libraries do.

This doesn't prove the model is right.

> And it fits what the manual suggests.

Unfortunately, the manual suggests nothing. I think that's the main
issue here.

> Your opinion is apparently that Emacs (in the Org-mode
> doc) should recommend that users sacrifice those keys
> to Org.  We disagree about that.

Not at all.

I want _Emacs_ (not the Elisp manual) to tell users about so-called user
reserved keys and what are their benefits. Since this isn't the case,
Org manual takes care of this.

> You want Emacs to (1) tell users that these keys are
> reserved for them to bind, BUT also to (2) recommend
> that if they use Org mode (which most users probably
> do now) then they should bind them to Org commands.

Not at all.

We recommend to bind globally available keys, but only give an example
on what the binding should look like. We even invite users to modify
them to their own liking.

> Org mode is not only a 3rd-party library.  It is
> now part of GNU Emacs.  All the more reason to be
> nice to users.

Note that we are really disagreeing about the definition of being nice
to the users. I'm convinced we both want to be nice to them.

> It should be fine and enough to leave off the part
> about ", like the ones reserved ... #+end_src."
>
> That part's not needed for users to understand
> that if they want global behavior then they can
> bind global keys - which is the only message you
> need to get across about those commands.

I searched the Emacs manual about "global keys" (menu, concept index,
regexp). I miserably failed. As a user, what can I do now?

> Perhaps someday someone else will finish the job by
> removing the manual's suggestion that they should
> make that sacrifice, "for a better experience".

I will happily remove the part you consider to be offending -- whereas
I consider it to be helpful -- once we can point users towards
appropriate information within the Emacs manual. Would you like to
report a bug about it?


Regards,

-- 
Nicolas Goaziou                                                0x80A93738

  reply	other threads:[~2018-02-19  9:25 UTC|newest]

Thread overview: 12+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
     [not found] <936768a0-1a2e-4a89-8a11-8f1779f8591d@default>
2017-12-04 21:45 ` bug#28263: 24.5; Org: `C-c LETTER' keys Nicolas Goaziou
2017-12-04 22:42   ` Drew Adams
2017-12-05 11:28     ` Nicolas Goaziou
2017-12-05 15:15       ` Drew Adams
2017-12-06  7:58         ` bug#28263: " Allen Li
2017-12-06  7:59         ` Allen Li
2017-12-06 15:23           ` Drew Adams
2017-12-06 20:09             ` bug#28263: " Allen Li
     [not found]             ` <871shilz7h.fsf@nicolasgoaziou.fr>
2018-02-19  0:26               ` Drew Adams
2018-02-19  9:24                 ` Nicolas Goaziou [this message]
2018-02-19 16:21                   ` Drew Adams
2018-02-20  0:38                     ` Nicolas Goaziou

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

  List information: https://www.orgmode.org/

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

  git send-email \
    --in-reply-to=87fu5xl4cd.fsf@nicolasgoaziou.fr \
    --to=mail@nicolasgoaziou.fr \
    --cc=28263@debbugs.gnu.org \
    --cc=drew.adams@oracle.com \
    --cc=vianchielfaura@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 public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).