From mboxrd@z Thu Jan  1 00:00:00 1970
From: Nicolas Goaziou <mail@nicolasgoaziou.fr>
Subject: Re: Inaccurate documentation for org-metaleft?
Date: Wed, 13 May 2015 12:39:08 +0200
Message-ID: <87pp64n4mr.fsf@nicolasgoaziou.fr>
References: <21840.54738.267828.723098@frac.u-strasbg.fr>
Mime-Version: 1.0
Content-Type: text/plain
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([2001:4830:134:3::10]:34600)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <mail@nicolasgoaziou.fr>) id 1YsU2r-0005Vi-GD
	for emacs-orgmode@gnu.org; Wed, 13 May 2015 06:37:46 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <mail@nicolasgoaziou.fr>) id 1YsU2q-0002lP-Dz
	for emacs-orgmode@gnu.org; Wed, 13 May 2015 06:37:45 -0400
Received: from relay3-d.mail.gandi.net ([2001:4b98:c:538::195]:49060)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <mail@nicolasgoaziou.fr>) id 1YsU2q-0002kr-7L
	for emacs-orgmode@gnu.org; Wed, 13 May 2015 06:37:44 -0400
In-Reply-To: <21840.54738.267828.723098@frac.u-strasbg.fr> (Alain Cochard's
	message of "Mon, 11 May 2015 18:16:18 +0200")
List-Id: "General discussions about Org-mode." <emacs-orgmode.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/emacs-orgmode>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=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: Alain.Cochard@unistra.fr
Cc: emacs-orgmode@gnu.org

Hello,

Alain.Cochard@unistra.fr writes:

> If I do 'C-h f org-metaleft', I see
>
>    org-metaleft is an interactive compiled Lisp function in `org.el'.
>    (org-metaleft &optional ARG)
>    Promote heading or move table column to left.
>    Calls `org-do-promote' or `org-table-move-column', depending on cont=
> ext.
>    With no specific context, calls the Emacs default `backward-word'.
>    See the individual commands for more information.
>
> However, if I look at the code, it seems to me that it does other
> things, at least org-outdent-item.  Experimenting a bit with
> org-metaleft and org-outdent-item seems to confirm this feeling.
>
> The doc for org-metaright
>
>    org-metaright is an interactive compiled Lisp function in `org.el'.
>    (org-metaright &optional ARG)
>    Demote a subtree, a list item or move table column to right.
>    In front of a drawer or a block keyword, indent it correctly.
>    With no specific context, calls the Emacs default `forward-word'.
>    See the individual commands for more information.
>
> is more accurate with respect to list items, but one would expect it
> to say "Calls `org-do-demote' etc."

I improved these docstrings in 0e7062678eb224027e5eca70a205430083a13a64.
Thank you.


Regards,

-- 
Nicolas Goaziou