From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Lennart Borgman (gmail)" Newsgroups: gmane.emacs.devel Subject: Re: org-mode, please change the name of function org-metaleft etc Date: Wed, 31 Oct 2007 18:43:04 +0100 Message-ID: <4728BEA8.5070704@gmail.com> References: <47279F39.2010401@gmail.com> <472897D8.9030600@gmail.com> <4728AE09.10402@gnu.org> <87zlxzxhe9.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 1193852618 32463 80.91.229.12 (31 Oct 2007 17:43:38 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 31 Oct 2007 17:43:38 +0000 (UTC) Cc: emacs-devel@gnu.org, dominik@science.uva.nl, Jason Rumney To: Bastien Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Oct 31 18:43:40 2007 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1InHbP-0001MQ-1b for ged-emacs-devel@m.gmane.org; Wed, 31 Oct 2007 18:43:39 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1InHbF-0007Xl-DO for ged-emacs-devel@m.gmane.org; Wed, 31 Oct 2007 13:43:29 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1InHbB-0007Tq-Cr for emacs-devel@gnu.org; Wed, 31 Oct 2007 13:43:25 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1InHb9-0007Qs-RV for emacs-devel@gnu.org; Wed, 31 Oct 2007 13:43:25 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1InHb9-0007QW-IN for emacs-devel@gnu.org; Wed, 31 Oct 2007 13:43:23 -0400 Original-Received: from ch-smtp01.sth.basefarm.net ([80.76.149.212]) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1InHb1-0001U8-6Y; Wed, 31 Oct 2007 13:43:15 -0400 Original-Received: from c83-254-148-228.bredband.comhem.se ([83.254.148.228]:64421 helo=[127.0.0.1]) by ch-smtp01.sth.basefarm.net with esmtp (Exim 4.68) (envelope-from ) id 1InHay-00041P-4T; Wed, 31 Oct 2007 18:43:12 +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: <87zlxzxhe9.fsf@bzg.ath.cx> X-Antivirus: avast! (VPS 071031-0, 2007-10-31), Outbound message X-Antivirus-Status: Clean X-Originating-IP: 83.254.148.228 X-Scan-Result: No virus found in message 1InHay-00041P-4T. X-Scan-Signature: ch-smtp01.sth.basefarm.net 1InHay-00041P-4T 9789dccf3137db143f2b8f8884579b30 X-detected-kernel: by monty-python.gnu.org: Linux 2.6? (barebone, rare!) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:82238 Archived-At: Bastien wrote: > Jason Rumney writes: > >> Lennart Borgman (gmail) wrote: >>> The function name does not describe what it does. It is of course, as >>> Bastien pointed out, quite hard to name this function after that ... >> I'd suggest org-electric-left as better than org-metaleft. The word >> electric is used in other commands that act differently according to >> context, and it does not tie it to a specific key binding. > > A simple M-x occur on org.el gives: > > 25151:(defun org-shiftmetaleft () > 25198:(defun org-metaleft (&optional arg) > 25283:(defun org-shiftleft () > 25301:(defun org-shiftcontrolleft () > > I guess `org-electric-left' won't be descriptive enough, even if it is a > good start. Maybe I should explain my original concern a bit better. If you do C-h f org-mode RET you will see a long list of key bindings and function names like those we are discussing. If the function names where written with `', like `org-metaleft' then you could at least click on the function names directly to get more information. How about that? (The list of key bindings is inserted through \\{org-mode-map} in org-mode doc string.)