From mboxrd@z Thu Jan 1 00:00:00 1970 From: Carsten Dominik Subject: Re: Re: Link to heading in another org file Date: Sun, 18 Jan 2009 18:47:58 +0100 Message-ID: References: <87zlhui7pf.fsf@CPU107.opentrends.net> <87k58yyzik.fsf@thinkpad.tsdh.de> <87fxjmi343.fsf@CPU107.opentrends.net> <87d4eqytd3.fsf@thinkpad.tsdh.de> <4956A66D-E9BA-40DA-8CB2-13B822882C46@uva.nl> <87ocy5svf9.fsf@thinkpad.tsdh.de> <75C1329B-9AB8-4820-A550-D7EAE736B274@uva.nl> <87d4elnewk.fsf@thinkpad.tsdh.de> Mime-Version: 1.0 (Apple Message framework v930.3) Content-Type: text/plain; charset=US-ASCII; format=flowed; delsp=yes Content-Transfer-Encoding: 7bit Return-path: Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1LObkl-0006ey-6e for emacs-orgmode@gnu.org; Sun, 18 Jan 2009 12:48:07 -0500 Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1LObki-0006bg-HO for emacs-orgmode@gnu.org; Sun, 18 Jan 2009 12:48:06 -0500 Received: from [199.232.76.173] (port=36895 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LObki-0006bP-8i for emacs-orgmode@gnu.org; Sun, 18 Jan 2009 12:48:04 -0500 Received: from nf-out-0910.google.com ([64.233.182.184]:12861) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1LObkh-0001ms-Hj for emacs-orgmode@gnu.org; Sun, 18 Jan 2009 12:48:03 -0500 Received: by nf-out-0910.google.com with SMTP id c7so369989nfi.26 for ; Sun, 18 Jan 2009 09:48:02 -0800 (PST) In-Reply-To: <87d4elnewk.fsf@thinkpad.tsdh.de> List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: Tassilo Horn Cc: emacs-orgmode@gnu.org On Jan 18, 2009, at 10:26 AM, Tassilo Horn wrote: > Carsten Dominik writes: > > Hi Carsten, > >> Under "Activation", the manual also states: >> >> ,----- >> | Add the following lines to your `.emacs' file. The last three >> lines >> | define _global_ keys for the commands `org-store-link', `org- >> agenda', >> | and `org-iswitchb' - please choose suitable keys yourself. >> | >> | ;; The following lines are always needed. Choose your own >> keys. >> | (add-to-list 'auto-mode-alist '("\\.org\\'" . org-mode)) >> | (global-set-key "\C-cl" 'org-store-link) >> | (global-set-key "\C-ca" 'org-agenda) >> | (global-set-key "\C-cb" 'org-iswitchb) >> `----- >> >> I do not want to re-iterate this information each time I talk about >> one of the global commands. > > I see. But wouldn't it then be better to talk about the functions > then, > not about global keys the manual suggests? Maybe it would, but the entire Org-mode documentation is based on keys rather than function names. I find that the long function names make Emacs documentation in written form less readable for users who do not want to deal with Lisp themselves. Org's manual is similar in this to the Emacs manual, and if you compare this way o writing for example with the planner manual, it does read a lot better for my taste. So, OK, I will make another remark that this key binding is user chosen, but I will keep it in the manual like this. - Carsten