Bug: org-refile-targets doesn't say whether it's AND or OR [7.7 (release_7.7.351.gb8b5)]

Dave Abrahams <dave@boostpro.com> wrote:

> I would change the doc for org-refile-targets to say that the resulting
> list of targets is the union of all the targets matched by each cons
> cell.  I think you could take that pretty much verbatim.
>

How's this?

Nick

---------------------------------------------------------------------------
>From f853b04fb474493b3b7b8857794c9f120c5f7822 Mon Sep 17 00:00:00 2001
From: Nick Dokos <nick@dokosmarshall.org>
Date: Wed, 28 Sep 2011 23:49:13 -0400
Subject: [PATCH] Amplify the doc for org-refile-targets

* lisp/org.el: (org-refile-targets) Elaborated the documentation of
               the variable as suggested by Dave Abrahams.

TINYCHANGE
This commit is contained in:
Nick Dokos 2011-09-29 08:59:14 +00:00 committed by Carsten Dominik
parent c18896841e
commit 1d65423da8
1 changed files with 5 additions and 1 deletions

View File

@ -1864,7 +1864,7 @@ will temporarily be changed to `time'."
(defcustom org-refile-targets nil (defcustom org-refile-targets nil
"Targets for refiling entries with \\[org-refile]. "Targets for refiling entries with \\[org-refile].
This is list of cons cells. Each cell contains: This is a list of cons cells. Each cell contains:
- a specification of the files to be considered, either a list of files, - a specification of the files to be considered, either a list of files,
or a symbol whose function or variable value will be used to retrieve or a symbol whose function or variable value will be used to retrieve
a file name or a list of file names. If you use `org-agenda-files' for a file name or a list of file names. If you use `org-agenda-files' for
@ -1886,6 +1886,10 @@ This is list of cons cells. Each cell contains:
Note that, when `org-odd-levels-only' is set, level corresponds to Note that, when `org-odd-levels-only' is set, level corresponds to
order in hierarchy, not to the number of stars. order in hierarchy, not to the number of stars.
Each element of this list generates a set of possible targets.
The union of these sets is presented (with completion) to
the user by `org-refile'.
You can set the variable `org-refile-target-verify-function' to a function You can set the variable `org-refile-target-verify-function' to a function
to verify each headline found by the simple criteria above. to verify each headline found by the simple criteria above.