[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Orgmode] Re: Seeking further clarification of org-refile-targets variab
From: |
Bernt Hansen |
Subject: |
[Orgmode] Re: Seeking further clarification of org-refile-targets variable |
Date: |
Thu, 18 Dec 2008 09:01:35 -0500 |
User-agent: |
Gnus/5.11 (Gnus v5.11) Emacs/22.2 (gnu/linux) |
Charles Cave <address@hidden> 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