From: Nick Dokos <ndokos@gmail.com>
To: emacs-orgmode@gnu.org
Subject: Re: meta commands and Info manual
Date: Mon, 20 Jul 2015 18:08:56 -0400 [thread overview]
Message-ID: <87y4iav5vr.fsf@alphaville.usersys.redhat.com> (raw)
In-Reply-To: 87egk21qhn.fsf@nicolasgoaziou.fr
Nicolas Goaziou <mail@nicolasgoaziou.fr> writes:
> Hello,
>
> Alan Wehmann <alan.wehmann@gmail.com> writes:
>
>> I am a new user of Org. I'm an experienced user of Emacs. My first use
>> of Org was to create a table. I soon found myself wanting to insert
>> a column. I looked at Info node "(org) Built-in table editor" [This
>> manual is for Org version 8.2.9.] and it said:
>>
>> ‘M-S-<right> (org-table-insert-column)’
>> Insert a new column to the left of the cursor position.
>>
>> I now know that this was somewhat mis-leading, since that key
>> combination is bound to "org-shiftmetaright", but at the time I was
>> rather confused (see topic "Org keymap question" in "news group"
>> gnu.emacs.help). I'd recommend a revision to the Info manual, to
>> describe more prominently command "org-shiftmetaright" and other
>> "meta" commands like it (apologies in advance if there is a later
>> version of the Info manual that addresses this).
>
> I think meta commands are the ones confusing here. I mean, is
>
> M-S-<right> (org-shiftmetaright)
>
> informative?
>
> Anyway, I'm not sure to understand what puzzled you in the first place.
>
I think what's puzzling is that these are not "normal" emacs keybindings
(and therefore not discoverable using the "normal" emacs mechanisms):
there is an extra level of indirection that org mode imposes which you
just have to know about. But I'm not sure what the best way to document
them would be: maybe a section explaining the mechanism plus links (or
footnotes) to go from e.g. the description of M-S-<right> in the table
section to the mechanism section. Or maybe showing the indirection
explicitly:
‘M-S-<right> (org-shiftmetaright) --> (org-table-insert-column)’
Nick
next prev parent reply other threads:[~2015-07-20 22:09 UTC|newest]
Thread overview: 7+ messages / expand[flat|nested] mbox.gz Atom feed top
2015-07-07 14:45 meta commands and Info manual Alan Wehmann
2015-07-20 21:14 ` Nicolas Goaziou
2015-07-20 22:08 ` Nick Dokos [this message]
2015-07-21 8:45 ` Suvayu Ali
2015-07-21 21:45 ` Nicolas Goaziou
2015-07-22 2:26 ` Nick Dokos
2015-07-22 13:03 ` Suvayu Ali
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=87y4iav5vr.fsf@alphaville.usersys.redhat.com \
--to=ndokos@gmail.com \
--cc=emacs-orgmode@gnu.org \
/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).