From mboxrd@z Thu Jan 1 00:00:00 1970 From: Bernt Hansen Subject: Re: Seeking further clarification of org-refile-targets variable Date: Thu, 18 Dec 2008 09:01:35 -0500 Message-ID: <87myetoa4g.fsf@gollum.intra.norang.ca> References: <200812180627.mBI6RfNi009606@mail01.syd.optusnet.com.au> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Return-path: Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1LDJRl-0006SG-1f for emacs-orgmode@gnu.org; Thu, 18 Dec 2008 09:01:49 -0500 Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1LDJRi-0006Ri-Ec for emacs-orgmode@gnu.org; Thu, 18 Dec 2008 09:01:46 -0500 Received: from [199.232.76.173] (port=43631 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LDJRi-0006Rf-3j for emacs-orgmode@gnu.org; Thu, 18 Dec 2008 09:01:46 -0500 Received: from mho-02-bos.mailhop.org ([63.208.196.179]:62228) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1LDJRh-00070t-LN for emacs-orgmode@gnu.org; Thu, 18 Dec 2008 09:01:45 -0500 In-Reply-To: <200812180627.mBI6RfNi009606@mail01.syd.optusnet.com.au> (Charles Cave's message of "Thu\, 18 Dec 2008 17\:27\:41 +1100") 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: charles_cave@optusnet.com.au Cc: emacs-orgmode@gnu.org Charles Cave writes: > I am having trouble understanding the help text for org-refile-targets. > I don't know what a "cons cell" is and I would like to see some examples > of customising the variable. > > For example, how can I specify headings of levels 1 and 2? > I entered the value of > (:level . N). > in the customization prompt but now I get a message > "No refile targets". > > Perhaps some examples for non-Lisp programmers would be helpful. > > As org-mode popularity increases, the users are not necessarily > Lisp-literate, and I have read messages from users willing to learn > Emacs just to use org-mode! A cons cell is a lisp structure which has two values in parentheses separated by a dot ie. (A . B) There are functions (car and cdr) which returns the two values in the cons cell respectively. The easiest way to modify org-refile-targets is with the customize interface. C-h v org-refile-targets RET then click the "You can _customize_ this variable." link and then use the buttons to construct the value. I have this value set as follows: ,---- | org-refile-targets is a variable defined in `org.el'. | Its value is | ((org-agenda-files :level . 1) | (nil :level . 1)) `---- where: (org-agenda-files :level . 1) specifies all level 1 targets in all of my org files listed in org-agenda-files (nil :level . 1) specifies all level 1 files in the current buffer Sometimes I work in org-files which are not part of my org-agenda-files list and I want to be able to refile to level 1 targets in that file too. I think you want the following setting: ,---- | org-refile-targets is a variable defined in `org.el'. | Its value is | ((org-agenda-files :level . 1) | (org-agenda-files :level . 2)) `---- HTH, Bernt