From mboxrd@z Thu Jan 1 00:00:00 1970 From: Nick Dokos Subject: Re: meta commands and Info manual Date: Mon, 20 Jul 2015 18:08:56 -0400 Message-ID: <87y4iav5vr.fsf@alphaville.usersys.redhat.com> References: <0177EA08-AD8C-4E75-AFA3-453919E805D4@gmail.com> <87egk21qhn.fsf@nicolasgoaziou.fr> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:53690) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZHJFK-0001Zk-N5 for emacs-orgmode@gnu.org; Mon, 20 Jul 2015 18:09:15 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZHJFF-0004IN-Gs for emacs-orgmode@gnu.org; Mon, 20 Jul 2015 18:09:14 -0400 Received: from plane.gmane.org ([80.91.229.3]:49831) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZHJFF-0004GR-9Q for emacs-orgmode@gnu.org; Mon, 20 Jul 2015 18:09:09 -0400 Received: from list by plane.gmane.org with local (Exim 4.69) (envelope-from ) id 1ZHJF9-0007tx-Ic for emacs-orgmode@gnu.org; Tue, 21 Jul 2015 00:09:03 +0200 Received: from nat-pool-bos-t.redhat.com ([66.187.233.206]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Tue, 21 Jul 2015 00:09:03 +0200 Received: from ndokos by nat-pool-bos-t.redhat.com with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Tue, 21 Jul 2015 00:09:03 +0200 List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: emacs-orgmode@gnu.org Nicolas Goaziou writes: > Hello, > > Alan Wehmann 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- (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- (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- in the table section to the mechanism section. Or maybe showing the indirection explicitly: ‘M-S- (org-shiftmetaright) --> (org-table-insert-column)’ Nick