From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Lennart Borgman (gmail)" Newsgroups: gmane.emacs.help Subject: Re: org-mode, please change the name of function org-metaleft etc Date: Wed, 31 Oct 2007 00:03:17 +0100 Message-ID: <4727B835.3090709@gmail.com> References: <47279F39.2010401@gmail.com> <87odegduyp.fsf@bzg.ath.cx> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1193785433 779 80.91.229.12 (30 Oct 2007 23:03:53 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 30 Oct 2007 23:03:53 +0000 (UTC) Cc: help-gnu-emacs@gnu.org To: Bastien Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Wed Oct 31 00:03:56 2007 Return-path: Envelope-to: geh-help-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1In07o-0000ml-1K for geh-help-gnu-emacs@m.gmane.org; Wed, 31 Oct 2007 00:03:56 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1In07e-0007cC-DD for geh-help-gnu-emacs@m.gmane.org; Tue, 30 Oct 2007 19:03:46 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1In07N-0007a7-VP for help-gnu-emacs@gnu.org; Tue, 30 Oct 2007 19:03:30 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1In07M-0007Wv-5M for help-gnu-emacs@gnu.org; Tue, 30 Oct 2007 19:03:29 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1In07M-0007Wl-2E for help-gnu-emacs@gnu.org; Tue, 30 Oct 2007 19:03:28 -0400 Original-Received: from ch-smtp02.sth.basefarm.net ([80.76.149.213]) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1In07L-0006Wj-Il for help-gnu-emacs@gnu.org; Tue, 30 Oct 2007 19:03:27 -0400 Original-Received: from c83-254-148-228.bredband.comhem.se ([83.254.148.228]:63001 helo=[127.0.0.1]) by ch-smtp02.sth.basefarm.net with esmtp (Exim 4.68) (envelope-from ) id 1In07J-0007qW-7s; Wed, 31 Oct 2007 00:03:26 +0100 User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.8.1.6) Gecko/20070728 Thunderbird/2.0.0.6 Mnenhy/0.7.5.666 In-Reply-To: <87odegduyp.fsf@bzg.ath.cx> X-Antivirus: avast! (VPS 071030-0, 2007-10-30), Outbound message X-Antivirus-Status: Clean X-Originating-IP: 83.254.148.228 X-Scan-Result: No virus found in message 1In07J-0007qW-7s. X-Scan-Signature: ch-smtp02.sth.basefarm.net 1In07J-0007qW-7s 89d173196a3f199874f18c84c6165367 X-detected-kernel: by monty-python.gnu.org: Linux 2.6? (barebone, rare!) X-BeenThere: help-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Users list for the GNU Emacs text editor List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Errors-To: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.help:48929 Archived-At: Bastien wrote: > "Lennart Borgman (gmail)" writes: > >> In org-mode the functions that are bound to some keys are named after >> the key binding, for example: >> >> org-metaleft >> >> It might be helpful when developing, but it is not very helpful to the >> user. It would be nice of the name of those commands where changed to >> something with a different mnemonic (ie what the command does). > > This kind of functions take different actions depending on the context. > So picking up more readable names for them is tricky. > > See the docstring of `org-metaleft': > > ,----[ (org-metaleft &optional arg) ] > | Promote heading or move table column to left. > | Calls `org-do-promote' or `org-table-move-column', depending on context. > | With no specific context, calls the Emacs default `backward-word'. > | See the individual commands for more information. > `---- > > I cannot think of a better name. What would you propose? It does not have to be short. It should rather be descriptive IMO.