emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: Carsten Dominik <dominik@science.uva.nl>
To: Bernt Hansen <bernt@norang.ca>
Cc: emacs-orgmode@gnu.org, charles_cave@optusnet.com.au
Subject: Re: Re: Seeking further clarification of org-refile-targets variable
Date: Sat, 20 Dec 2008 23:03:49 +0100	[thread overview]
Message-ID: <CB2307B1-AB81-49AB-917F-D04D4F9DA057@uva.nl> (raw)
In-Reply-To: <87myetoa4g.fsf@gollum.intra.norang.ca>


On Dec 18, 2008, at 3:01 PM, Bernt Hansen wrote:

> Charles Cave <charles_cave@optusnet.com.au> 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))
> `----

This works well, but faster is:

  ((org-agenda-files :maxlevel . 2))

Because it will do only one pass over all involved files.

- Carsten

      parent reply	other threads:[~2008-12-20 22:03 UTC|newest]

Thread overview: 6+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2008-12-18  6:27 Seeking further clarification of org-refile-targets variable Charles Cave
2008-12-18 13:43 ` Matthew Lundin
2008-12-18 13:51   ` Matthew Lundin
2008-12-18 14:01 ` Bernt Hansen
2008-12-18 14:25   ` Matthew Lundin
2008-12-20 22:03   ` Carsten Dominik [this message]

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.orgmode.org/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=CB2307B1-AB81-49AB-917F-D04D4F9DA057@uva.nl \
    --to=dominik@science.uva.nl \
    --cc=bernt@norang.ca \
    --cc=charles_cave@optusnet.com.au \
    --cc=emacs-orgmode@gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).